Skip to main content

Utility commands

The cross-seed app has several subcommand utilities. Some of these can help you debug your system, or help you find more information to file a bug report.

cross-seed gen-config

Generate an empty config file in its proper location.

Options

short formlong formnote
-d--dockerSpecifying this flag will configure outputDir and torrentDir to /output and /torrents, respectively.

Usage

cross-seed gen-config
cross-seed gen-config -d

cross-seed clear-cache

danger

Do not use unless instructed to, this rarely necessary. Please seek support if you believe it's needed.

Clear the cache without causing torrents to be re-snatched and reset the timestamps for excludeOlder and excludeRecentSearch.

Usage

cross-seed clear-cache

cross-seed restore

Use snatched torrents from the torrent_cache to attempt to restore cross seeds. You will need to run cross-seed inject afterwards with dataDirs configured.

This can be helpful if you have lost your torrent client session information but still have the downloaded data.

Usage

cross-seed restore

cross-seed test-notification

Send a notification to the specified URL.

Usage

cross-seed test-notification <url>

cross-seed diff

See if and why two torrents pass the matching algorithm.

Usage

cross-seed diff <owned torrent> <candidate torrent>

cross-seed tree

Check a torrent's file tree from cross-seed's perspective.

Usage

cross-seed tree file.torrent

cross-seed api-key

Show the api key.

Usage

cross-seed api-key

cross-seed reset-api-key

Reset the api key.

Usage

cross-seed reset-api-key

cross-seed clear-indexer-failures

Clears all indexer failures from the database

caution

This should be used sparingly, and never repeatedly (back-to-back) in a short period, to clear failures that are otherwise latent/expired or erroneous in Prowlarr/Jackett due to indexers being down.

Usage

cross-seed clear-indexer-failures

cross-seed inject

Injects previously saved, or manually added, torrents from outputDir.

By default this command will use outputDir, however, you can also specify an inject dir by providing the argument.

Read More...

Usage

cross-seed inject
cross-seed inject --inject-dir /path/to/dir

cross-seed rss

Runs a manual RSS scan (like rssCadence) and performs your specified action on the trackers in your torznab option.

Read about automating this with "daemon" mode...

Usage

cross-seed rss

Runs a manual search (like searchCadence) and performs your specified action on the trackers in your torznab option.

You can optionally override the time based exclusions in your config for this search only.

Read about automating this with "daemon" mode...

Usage

cross-seed search
cross-seed search --no-exclude-recent-search --no-exclude-older