Skip to content

Home

Jump to bottom
pyed edited this page Aug 19, 2026 · 10 revisions

Welcome to the transmission-telegram Wiki

transmission-telegram is a modern, lightweight, and full-featured Telegram bot designed to manage and monitor your Transmission BitTorrent client remotely from any device running Telegram.

🚀 Quick Start Guide

1. Create your Telegram Bot

  1. Open Telegram and start a chat with @BotFather.
  2. Send /newbot and follow the prompts to choose a display name and a unique username ending in bot (e.g. my_transmission_bot).
  3. BotFather will provide you with an HTTP API Token (e.g. 123456789:ABCdefGhIJKlmNoPQRsTUVwxyZ).

2. Find your Telegram Username or Numeric User ID

  • Your bot will only respond to authorized accounts configured in the -master list.
  • You can provide your @username (e.g. @YourName) or your permanent numeric Telegram User ID (e.g. 123456789, which can be retrieved from @userinfobot).

3. Run the Bot

transmission-telegram \
  -token="YOUR_TELEGRAM_BOT_TOKEN" \
  -master="@YourTelegramUsername" \
  -url="http://localhost:9091/transmission/rpc" \
  -username="transmission_rpc_user" \
  -password="transmission_rpc_password"

Once started, open a chat with your bot in Telegram and send /help or /list!

🌟 What's New in v2.0

  • 🎛 Interactive Buttons: /info renders direct [ ⏸ Pause ], [ ▶ Resume ], and [ 🗑 Delete ] inline keyboard buttons with instant toast alerts.
  • 📊 Visual Progress Bars: Clean Unicode progress bars ([█████░░░░░] 50.0%) on status and listing views.
  • 🔔 RPC Polling Notifications: Automatic completion alerts out-of-the-box without requiring local log file access — works seamlessly with Docker, Kubernetes, unRAID, and remote seedboxes.
  • 🐢 Turtle Mode Control: Toggle or set alternative speed limits on the fly with /turtle.
  • 💾 Free Disk Space: Instant disk space inspection on download drives with /free.
  • 📡 Tracker Re-announcing: Force tracker re-announces with /reannounce.
  • 🔒 Numeric User IDs: Full support for numeric Telegram user IDs in -master so users without public usernames can authenticate securely.
  • ⚡ Go 1.21+ Architecture: Built on top of the modern pyed/transmission v1.0.0 SDK and go-telegram/bot engine.

📚 Wiki Contents

Clone this wiki locally