Add Remote Torrent

A browser extension for power users who manage remote file-transfer clients. This tool streamlines the process of adding new transfers (via magnet links or file URLs) to various client WebUIs. It supports managing multiple server profiles, offering a centralized experience for transfer management directly from your browser.

The extension is designed with privacy and security in mind. All server configurations are stored locally on your device and are never transmitted to external servers. It also works seamlessly with private trackers by fetching the file content before adding it to your client's WebUI.

Reporting Issues
If you encounter a bug, please open an issue on our GitHub page. To help us resolve the issue quickly, please include the following information:

The version of the extension you are using.
The name and version of your torrent client (e.g., qBittorrent v4.4.2).
A clear description of the problem. What did you do? What did you expect to happen? What actually happened?
The exact error message you received. You can find this in the extension's popup under "Last Action".
Enable debugging to get more detailed error logs:
Go to the extension's Options page.
At the bottom, find the "Debug & Log Settings" section.
Enable all checkboxes for both "content-script" and "background-script".
Reproduce the error.
Open the browser's developer console (Right-click anywhere on the options page -> Inspect -> Console tab).
Copy and paste any relevant error messages from the console into your GitHub issue. Please review the logs and remove any sensitive information like passwords or IP addresses before posting.
We are working on a feature to make this process easier by allowing you to report issues directly from the extension.

*Changelog*
* **v0.4.19 (2025-11-19):**
* **Security:** Updated zip-a-folder and glob dependencies to address CVE-2025-64756 (command injection via -c/--cmd with shell:true in glob CLI).

v0.4.18 (2025-11-16):
Fix: Corrected Options page client version display where some clients appeared as `vv5.1.2`.
Docs:Updated README to reflect the new Custom Link Catching Patterns UI and clarified sound notification behavior.

v0.4.16
Feature: Added comprehensive basic authentication support for reverse proxy setups. All client handlers now support basic auth headers for servers behind authentication gateways (Nginx, Apache, etc.).

Feature: Automatic credential extraction from URLs - URLs with embedded credentials (e.g., [email protected])" rel="nofollow noopener" target="_blank">http://user:[email protected]) are automatically parsed and configured.
Enhancement: Per-server basic auth configuration, independent of client authentication, providing flexible deployment options.

v0.4.15 (2025-11-14):
Chore: Replaced deprecated crx package with crx3 for CRX file generation, ensuring continued compatibility with Chrome Web Store requirements.
Security: Updated all dependencies to address security vulnerabilities, including the moderate severity issue in the tar package.
v0.4.14 (2025-09-20):
Feature: Added customizable sound notifications. Users can now choose different sounds for success/failure notifications from the Options page (browser beeps, existing sounds, or custom .mp3 files in the audio/ folder).
Enhancement: Improved sound system with programmatic beep generation and automatic detection of available sound files.
v0.4.13 (2025-09-20):
Fix (Critical): Overhauled session management for qBittorrent and Deluge clients to be per-server, fixing major stability issues and race conditions in multi-server environments.
Fix (Critical): Corrected a bug in the Options page that prevented URL-to-server mapping rules from being edited.
Fix (Security): Patched a cross-site scripting (XSS) vulnerability on the dashboard page by implementing secure HTML escaping.
Fix (Performance): Improved the background server status check to use a concurrent queue, preventing performance issues when many servers are configured.
Fix: Hardened error handling for context menu creation.
Refactor: Improved the consistency and reliability of dynamic link detection.
v0.4.12 (2025-09-11):
Fix (Critical): Resolved qBittorrent authentication issues that were causing "Failed to resume torrent" errors and dashboard "N/A" values. The getBuildInfo function now performs proper authentication before making API calls to /api/v2/sync/maindata, ensuring valid session data is returned for download/upload speeds and torrent counts.
Fix: Fixed dashboard display showing "N/A" for download speeds, upload speeds, and torrent counts on qBittorrent v5.0+ installations.
Fix: Added proper Referer and Origin headers for all qBittorrent API requests to ensure compatibility with reverse proxy setups.
Enhancement: Added debug logging to help diagnose API response data and authentication issues.
v0.4.11 (2025-09-11):
Fix (Critical): Corrected a regression in the qBittorrent handler that caused a "404 Not Found" error when attempting to resume a torrent after adding it.
v0.4.10 (2025-09-11):
Fix (Critical): Implemented a more robust safeSendMessage wrapper in the content script to finally resolve the "Extension context invalidated" errors that occurred on dynamic pages.
Fix: Corrected a ReferenceError: onAlarm is not defined in the background script, ensuring periodic tasks (like server status checks and completion notifications) now run correctly.
Fix: Hardened the server statistics handling logic to prevent "N/A" values from appearing for qBittorrent and other clients.
v0.4.9 (2025-09-11):
Internal: This version was part of the iterative process to fix the critical bugs and was superseded by v0.4.10.
v0.4.8 (2025-09-11):
Fix (Critical): Overhauled the "Download Complete" notification system to fix a major bug that caused notification spam. The system now intelligently tracks only torrents added by the extension and sends a single notification upon completion.
Fix: Resolved an issue where qBittorrent servers would incorrectly display "N/A" for Torrents, DL Speed, and UL Speed in the popup and dashboard.
Feature: Added a new setting on the Options page to allow users to enable or disable the "Download Complete" notifications.
v0.4.7 (2025-09-10):
Feat(Notifications): Added support for "Download Complete" notifications for qBittorrent, Transmission, Deluge, and rTorrent clients.
v0.4.6 (2025-09-10):
Fix(Dashboard): The dashboard now correctly displays advanced server information for all supported clients.
Feat(Dashboard): Added a "Show More" button to each server card on the dashboard to help with debugging.
v0.4.5 (2025-09-10):
Enhancement: Completed a comprehensive review of all API handlers to provide advanced information on the Dashboard. The following clients now report extended details:
qBittorrent: Version & Free Space, Global Speeds, Total Torrents
Transmission: Version & Free Space, Global Speeds, Total Torrents
Deluge: Version & Free Space, Global Speeds, Total Torrents
rTorrent: Version & Free Space
Transmission: Version & Free Space
Deluge: Version & Free Space
rTorrent: Version & Free Space
Synology Download Station: Version & Free Space
QNAP Download Station: Version
uTorrent: Version
BiglyBT: Version & Free Space
Vuze (XML WebUI): Version & Free Space
Porla: Version
Hadouken: Version
Feature: Added a new "Vuze (XML WebUI)" client type to support the modern, Transmission-compatible API.
Fix: Corrected a critical bug where the "context invalidated" error would spam the console on pages with dynamic content. The content script now handles this error gracefully.
Fix: Improved the LinkMonitor to more reliably detect torrent links on dynamic web pages (e.g., Telegram, Facebook) by re-scanning sections of the page when significant changes are detected.
Fix: Added the dashboard directory to the build process, resolving an ERR_FILE_NOT_FOUND error when trying to access the new Dashboard page.
v0.4.3 (2025-09-10):
Fix: Added the missing "alarms" permission to the manifest file, which was causing the service worker to fail and preventing the periodic server status check from running.
Fix: Corrected a data-loss bug where editing and saving an existing server profile would unintentionally erase its stored status information (version, free space, online status).
v0.4.0 (2025-09-10):
Feature: Dashboard Page: Added a new Dashboard page accessible from the popup, which displays the online/offline status of all servers, advanced client information (version, free space), and a log of the last 10 actions.
Feature: Advanced Connection Testing: The "Test Connection" feature now fetches and displays the client version and free disk space for qBittorrent, Transmission, and Deluge servers.
Feature: Client-Specific Advanced Options: Added a "Content Layout" dropdown in the "Confirm Add" dialog for qBittorrent, a "Bandwidth Priority" option for Transmission, and a "Move when Completed" option for Deluge, which appear contextually based on the target client.
Feature: UI/UX Enhancements:
Added client-specific setup hints to the options page.
Added instructional text for Tags, Categories, and Directories to guide users.
Added a Regex Helper section with examples to assist in creating custom link-catching patterns.
Feature: Action History: The extension now logs the last 10 success or failure messages for display in the dashboard.
Feature: Periodic Server Status Check: A background task now runs every 15 minutes to check the online/offline status of all configured servers.
Fix: Resolved a UI bug where the "Confirm Add" dialog would sometimes show a scrollbar on different screen sizes or scaling settings.
Chore: Updated project dependencies to the latest versions.

v0.3.21
Fix: Resolved a critical "Extension context invalidated" error that occurred during extension reloads. The content script now handles this expected error gracefully, preventing console errors on every page load and improving overall stability.

v0.3.20
Fix: Corrected a regression where the "URL-to-Server Mappings" feature was being ignored. The server selection logic now correctly prioritizes URL-based rules over context menu selections, restoring the expected automatic routing behavior.

v0.3.19
Feature: Overhauled the "Custom Link Catching Patterns" setting. It now features a user-friendly UI for adding, editing, and deleting individual regex patterns, replacing the old, single-string input.
Feature: Added two default patterns to catch common .torrent file links and torrents.php download links, improving out-of-the-box functionality.
Feature: Added Porla & BiglyBT
Migration: Implemented a seamless, one-time migration for existing users. The old linkmatches tilde-separated string is automatically converted into the new array-based format, preserving all user-defined patterns.

v0.3.18
Feature: Added a new option to show download directories in the context menu. This allows for adding torrents to specific directories.
Fix: Corrected a bug where the context menu would fail to update if a server had no download directories defined.
Fix: Added error handling to the content script to prevent "context invalidated" errors on dynamic pages.

v0.3.17
Fix: Implemented a comprehensive fix for uTorrent connectivity. The handler now correctly uses a user-configurable "Relative Path" for all API requests (including token fetching and connection testing), resolving errors for non-standard WebUI paths. The connection test now uses a more reliable getsettings check.
UX: The options page now auto-detects and separates the relative path if it's included in the main server URL for uTorrent clients, and the "Open WebUI" button in both the options page and the popup correctly constructs the URL using this path.

v0.3.16
Fix: Implemented a comprehensive fix for uTorrent connectivity. The handler now correctly uses a user-configurable "Relative Path" for all API requests (including token fetching and connection testing), resolving errors for non-standard WebUI paths. The connection test now uses a more reliable getsettings check.

UX: The options page now auto-detects and separates the relative path if it's included in the main server URL for uTorrent clients, and the "Open WebUI" button correctly constructs the URL using this pat

v0.3.15
Fix: Implemented a robust fix for uTorrent connectivity by allowing users to specify a custom "Relative Path" in the server settings. This resolves CSRF token errors for non-standard WebUI paths (e.g., / or /webui/).

v0.3.14
Fix: Implemented a more robust CSRF token fetching mechanism for the uTorrent handler. It now tries multiple common paths (/gui/token.html and /token.html) to improve compatibility with different WebUI setups and versions.

v0.3.13
Fix: Corrected the uTorrent handler to fetch the CSRF token from /gui/ instead of /gui/token.html, resolving connection errors for modern WebUI versions.

v0.3.12
Fixed: Qbitorrent Handler, an issue where Automatic Torrent Management (ATM) was not being triggered when adding a torrent with a category. The `autoTMM` parameter is now correctly sent to the API.

v0.3.11
Feature: Added an accessibility option to enable/disable text-based (visual) notifications for success or failure, providing an alternative to sound-based feedback.

v0.3.10
Security: Fixed multiple cross-site scripting (XSS) vulnerabilities in the options page where user-provided data was not properly sanitized before being rendered. This hardens the extension against malicious data injection in the URL mapping and tracker rules lists.

v0.3.9
Fixed: Resolved an issue where torrent links on a page were not being detected or intercepted due to a `ReferenceError` in the content script. On-page link catching should now work correctly again.

v0.3.8
Feature: Added the ability to specify a list of download directories per server and select one from a dropdown in the "Add Torrent" dialog.

Version 0.3.7
Fixed :**ruTorrent:** Improved torrent file handling by always attempting to download the `.torrent` file content, even with incorrect `Content-Type` headers. This resolves upload issues with clients like ruTorrent that cannot access torrent URLs directly.

Version 0.3.6
Feature: Added a "Report Issue" button in the popup to streamline bug reporting.
Fixed: ruTorrent: Corrected URL construction logic to prevent 404 errors.
uTorrent (Old): Modified the API handler to support very old, token-less clients.
Docs: Added a "Reporting Issues" section to the README with instructions for debugging.
Updated troubleshooting guide for ruTorrent and old uTorrent versions.

Version 0.3.5
- ruTorrent: Corrected an issue where the server URL was not being constructed properly, causing connection failures.
-uTorrent: Added a new "uTorrent (Old)" client type to support older versions of the uTorrent WebUI (e.g., v2.0.4) that do not support modern API features like setting labels or download directories.

Version 0.3.4:
- Added a clickable link to the server's WebUI in the popup.
- Updated project dependencies to their latest versions.
- Improved documentation with a Troubleshooting/FAQ section.

Version 0.3.3:
- Added support for Hadouken, Tixati, Torrentflux, Vuze (HTML WebUI), Flood, Tribler, and BiglyBT.
- Fixed an issue with the ruTorrent handler to improve reliability.

Version 0.3.2:
- Added client-specific feature enhancements for qBittorrent, Transmission, Deluge, rTorrent, ruTorrent, and uTorrent/BitTorrent.

Version 0.3.1:
- Fixed several bugs related to qBittorrent, Deluge, and rTorrent.
- Added support for ruTorrent.
- Added the ability to add a torrent by clicking the extension icon.
- Added a button to open the server's WebUI from the options page.

Version 0.3.0:
- Initial release with support for qBittorrent, Transmission, and Deluge.

Version 0.2.9:
- Added dynamic link monitoring, server-specific context menus, and debug settings.
- Fixed issues with click handling, sound notifications, and JSON syntax.