projects@yorhel.nl
home - git - @ayo

Cute decorative scissors, cutting through your code.

Torreas 0.3 Manual

Version: latest / 0.2 / 0.1

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 warnings and progress information.

--partial

Keep going even if some files mentioned in the torrent are missing. This option usually causes files that are present to still be reported as missing, because the missing files make it impossible to validate all checksums.

--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.

EXIT STATUS

The torreas utility exits 0 on success, and >0 if an error occurs.

BUGS / LIMITATIONS

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 Yorhel