Direct Client Injection
If you use rTorrent, Transmission, Deluge, or qBittorrent, cross-seed
can inject the torrents it finds directly into your torrent client. This satisfies most
simple use cases. For more complex cases, autotorrent2
or qbit_manage is recommended.
If you are having issues with injection errors, and it reverting to save, please check our FAQ
There is a potential problem with duplication of imports using either an Arr On Download/Upgrade, Deluge/qBittorrent on complete execution,
or search/rss/announce trigger, which causes race conditions and bad categorizing/labeling when you use inject with cross-seed
.
Injecting to qBittorrent/Deluge and using an Arr can result in new cross-seeds being added with the Arr import
category, causing them to get stuck in your Arr's import queue. The workaround is to enable the duplicateCategories
option, which will append your category with .cross-seed
and if using qBittorrent either...
- use the same pre/post import categories in your Arr OR
- your Arr's pre/post import categories have the same save path in qBittorrent.
cross-seed
requires access to the directory where your client's .torrent files are stored.
Client | Torrent/Session Folder |
---|---|
qBittorrent | BT_Backup |
Deluge | state |
Transmission | torrents |
rTorrent | session dir from .rtorrent.rc |
rTorrent
setup
cross-seed
will inject torrents into rTorrent with a cross-seed
label.
- Edit your config file:
- Set your
action
option toinject
. - Set your
rtorrentRpcUrl
option. It should look like anhttp
url that looks likehttp://user:pass@localhost:8080/rutorrent/RPC2
(if you have ruTorrent installed). See the reference for more details.
- Set your
- Start or restart
cross-seed
. The logs at startup will tell you ifcross-seed
was able to connect to rTorrent.
In order for cross-seed
to prove to rTorrent that a torrent is completed,
it must check the modification timestamps of all the torrent's files.
Make sure that your cross-seed
container has read access to the data
directories of your torrents, mapped to the same path as rTorrent.
qBittorrent
setup
Injection will work best if you use the Original
content layout in qBittorrent options.
- Edit your config file:
- Set your
action
option toinject
. - Set your
qbittorrentUrl
option. It should look like anhttp
url that looks likehttp://user:pass@localhost:8080/
See the reference for more details.
- Set your
- Start or restart
cross-seed
. The logs at startup will tell you ifcross-seed
was able to connect to qBittorrent.
Transmission
setup
- Edit your config file:
- Set your
action
option toinject
. - Set your
transmissionRpcUrl
option. It should look like anhttp
url that looks likehttp://user:pass@localhost:9091/transmission/rpc
- Set your
- Start or restart
cross-seed
. The logs at startup will tell you ifcross-seed
was able to connect to Transmission.
Deluge
setup
- Edit your config file:
- Set your
action
option toinject
. - Set your
delugeRpcUrl
option. It should look like anhttp
url that looks likehttp://:pass@localhost:8112/json
(the colon beforepass
is intentional)
- Set your
- Start or restart
cross-seed
. The logs at startup will tell you ifcross-seed
was able to connect to Deluge.