Remote Control

Control your Termdock terminals remotely via Discord or Telegram bots. Create sessions, send commands, read output, and receive interactive prompt notifications.

Overview

Remote Control lets you manage Termdock terminal sessions from your phone or any device with Discord or Telegram. You can create sessions, execute commands, read output, take screenshots, and receive interactive prompt notifications with clickable buttons.

Discord Bot

Slash commands with interactive buttons

Telegram Bot

Inline keyboard controls

Telegram Setup

  1. Open Telegram and start a chat with @BotFather. Send /newbot and follow the prompts to create your bot.
  2. Copy the bot token that BotFather gives you.
  3. In Termdock: Settings > Remote Control > Telegram > paste the token.
  4. Start a chat with your bot and send any message. Termdock will detect your chat ID automatically, or you can enter it manually in settings.
  5. Enter the chat ID in settings and enable the Telegram integration.

Discord Setup

  1. Go to Discord Developer Portal and create a new application.
  2. Navigate to Bot and create a bot. Copy the bot token.
  3. Under OAuth2, select these scopes:
    botapplications.commands
  4. Set bot permissions:
    Read MessagesSend MessagesSend EmbedsAttach FilesManage Messages
  5. Enable Gateway Intents: Guilds
  6. Use the generated OAuth2 URL to invite the bot to your server.
  7. In Termdock: Settings > Remote Control > Discord > paste the token, guild ID, and channel ID.

Commands Reference

CommandDescription
/wsList workspaces
/new [workspace]Create a new terminal session
/listList active sessions
/send {session} {content}Send a command to a terminal
/read {session} [lines] [raw]Read output (default 50 lines)
/watch {session}Watch for prompt notifications
/unwatch {session}Stop watching a session
/key {session} {key}Send special key (ctrl+c, enter, tab, up, down, esc)
/kill {session}Close session (Telegram only)
/snap [session]Take a terminal screenshot

Notes

Telegram Limits

  • 4096 character message limit
  • 64-byte callback data limit for inline buttons

Discord Limits

  • 2000 character message limit
  • Up to 5 interactive buttons per prompt notification

Interactive Prompts

Both platforms support interactive prompt buttons for CLI option selection. When a terminal prompt is detected (e.g., package manager choices), clickable buttons are sent to your chat for quick responses.