Docs · Automation

Telegram remote

Add and control downloads from a Telegram bot, and get notified when they finish.

SQDM can take commands from a Telegram bot you create. It only ever connects out to Telegram (long polling); it never opens a port on your computer.

Set it up

  1. In Telegram, create a bot with @BotFather and copy its token.
  2. Preferences → Telegram (under Advanced): paste the token and turn the bot on. The token is stored encrypted.
  3. Send /pair to your bot from your own chat. The request appears in SQDM — approve it. Chats you haven’t approved are ignored.

Commands

Command Does
/add <url> [folder or category] Adds a download. A plain link works too.
/list Current downloads.
/status Speed and what’s running.
/pause <id or all> Pauses.
/resume <id or all> Resumes.
/cancel <id> Cancels.
/speed Current total speed.
/zip <url> Summary of a remote ZIP’s contents.
/help The list above.

Only http, https and magnet links are accepted, and commands are rate-limited.

Notifications

Approved chats can get a message when a download completes (name, size, time, average speed), fails (with the reason), or when a data cap warning fires. Each type can be turned off.