Remote Torrent Adder

Send torrents and magnet links from your browser straight to your BitTorrent client — local or remote — with a single click.

Install · Features · Supported clients · Build from source · Contributing

---

🤔 What is this?

Chrome doesn't let extensions hand a downloaded .torrent file over to a desktop application. Remote Torrent Adder (RTA) works around this by talking directly to the WebUI of your BitTorrent client: click a torrent or magnet link, and RTA uploads it to your client's web API instead of saving a file to disk. Because everything happens over HTTP(S), it works just as well with a client running on your own machine as with one on a seedbox, NAS, or home server on the other side of the world.

✨ Features

• 🖱️ One-click adding — torrent and magnet links are caught as you click them and sent straight to your client
• 🔗 Smart link catching — a mutation observer picks up dynamically added links as they appear, and custom regexes let you tune exactly which links get caught
• 🖥️ Multiple servers — configure as many clients/servers as you like and pick the target per link via the right-click context menu
• 🏷️ Labels & download directories — set defaults per server, choose per torrent in a popup, or let auto-rules assign a label/directory based on the torrent's tracker URL
• ⏸️ Add paused — optionally add torrents in a stopped state
• 🔐 Authentication & HTTPS — username/password auth and secure connections supported for all clients
• 🔔 Rich notifications — success/failure notifications with configurable duration and custom notification sounds
• 📦 Import/export — back up and restore your complete configuration as a file
• ⚡ Manifest V3 — built for Chrome's current extension platform, with a modern React-based settings UI

🧩 Supported clients

Client	Notes
qBittorrent	v5+
ruTorrent
Transmission
Deluge
flood	jesec's flood
BiglyBT	via Web Remote (formerly Vuze/Azureus)
Porla
Tixati
Elementum	Kodi add-on
rqbit
tTorrent	Android
QNAP Download Station

Missing your client? Open an issue — or better yet, add it yourself; client integrations are small, self-contained classes.

🚀 Installation

1. Install the extension from the Chrome Web Store
2. Open the extension's options and add your server(s): client type, host, port, credentials
3. Click a torrent link — done!

Tip

If clicking a link downloads the .torrent file to disk instead of adding it to your client, check the Link Catching tab in the settings and adjust the catching patterns for the site you're using.

🛠️ Building from source

You'll need a recent version of Node.js and npm.

git clone https://github.com/bogenpirat/remote-torrent-adder.git
cd remote-torrent-adder
npm install

npm run build        # development build → dist/
npm run build:prod   # minified production build → dist-prod/

Tests run automatically before every build; you can also run them directly:

npm test             # run the test suite once
npm run test:watch   # watch mode
npm run test:coverage

To load your build into Chrome:

1. Open chrome://extensions/
2. Enable Developer mode (top right)
3. Click Load unpacked and select the dist/ (or dist-prod/) folder

For iterating on the extension, npm run dev builds once and then rebuilds on every source change — just hit the reload button on the extension card in chrome://extensions/ to pick up changes.

🏗️ Tech stack

• TypeScript throughout, strict mode on
• React + Tailwind CSS for the options page and per-torrent popup
• Vite (popup, options, notifications) and Rollup (service worker, content script)
• Vitest for the test suite
• Tag-driven release pipeline that auto-deploys to the Chrome Web Store

🤝 Contributing

Bug reports, feature requests, and pull requests are welcome!

• Adding a client: each client is a single class in src/webuis/ extending TorrentWebUI and registered in src/models/clients.ts — existing implementations make great templates
• Found a bug? Open an issue with your client, its version, and what happened

📜 Changes from RTA v1.x

With Chrome enforcing Manifest V3, the extension was rewritten from scratch (RTA v2.x), which changed a few things.

Dropped clients

• qBittorrent 4.x and older
• non-jesec flood
• TorrentFlux
• Vuze Swing UI & HTML UI (use BiglyBT's Web Remote instead)
• pyrT
• Synology & Buffalo — no hardware to test against; if you can help re-implement them, get in touch
• nodeJS-rTorrent, rTorrent XML-RPC
• µTorrent
• Hadouken (its maintainer recommends Porla)

Changed features

• Link scan delay is gone — no longer necessary since a mutation observer now discovers dynamic page changes as they happen
• Context menu is always generated instead of being togglable
• New tab catching is gone — it hadn't worked reliably in a long time
• Address bar indicator has been obsolete since ~2016; the extension icon is always available anyway