Torreas Manual

NAME

torreas - Torrent file reassembler

SYNOPSIS

torreas [--verbose] [--silent] [--copy-sh | --symlink-sh | --hardlink-sh] torrent-file directory …

DESCRIPTION

torreas scans directories in order to find files that belong to a given torrent. Files are matched based on size and checksum rather than location or name, so this tool can be used to reliably reassemble a torrent for (re-)seeding after the files have been incorporated in a local archive.

OPTIONS

--help

Display short help text.

--version

Display program version.

--verbose

Output debug logging.

--silent

Disable progress information.

--copy-sh

Ouput a shell script to reconstruct the torrent in the current directory. This is the default output mode. While you could directly pipe output from torreas to a shell, it’s often a better idea to inspect the script so you can verify which files are being copied.

If multiple source files have been found to satisfy a file in the torrent, only the first match is copied. The remaining candidates still have a line in the script, but these are commented out.

--symlink-sh

Like --copy-sh except output commands to create symlinks.

--hardlink-sh

Like --copy-sh except output commands to create hard links.

BUGS / LIMITATIONS

The current version requires that all files mentioned in the torrent are available in the given directories. Future versions may support partial reassembly in order to deal with missing files.

Padding files in torrents are not currently supported.

Because checksums in torrents can span multiple files, it may not always be feasible to reassemble a torrent in a sensible time frame. Future versions of this tool may implement better matching heuristics and/or user feedback to help speed up such cases.

SEE ALSO

mktorrent(1), transmission-create(1), transmission-show(1)

AUTHORS

Written by Yoran Heling <projects@yorhel.nl>