Torreas 0.3 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 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 ⟨projects@yorhel.nl⟩