TorrentFile
CLI Usage Examples
Creating Torrents
Using the sub-command create
or c
TorrentFile can create a new torrent
from the contents of a file or directory path. The following examples illustrate
some of the options available for creating torrents (AKA meta files).
- Create a torrent from any file or directory. example (
/path/to/content
) - by default the save path will be the content path with a ".torrent" extension. (
/path/to/content.torrent
) - by default torrents are created using bittorrent meta-version 1
>torrentfile create /path/to/content
- The
-t
or--tracker
flag adds one or more urls to tracker list. - This flag will cause an error if the content path immediately follows it.
do this
>torrentfile create /path/to/content --tracker http://tracker1.com
or this
>torrentfile create -t http://tracker2 http://tracker3 --private /path/to/content
not this
>torrentfile create --tracker http://tracker /path/to/content #ERROR
>torrentfile create -t http://tracker1 http://tracker2 /path/to/content #ERROR
- the
--private
flag indicates use by a private tracker - the
--source
flag can be used to help with cross-seeding
>torrentfile create --private --source /path/to/content --tracker https://tracker/url
- to turn off the progress bar shown use
--noprogress
- this can improve the performance by a very small amount
>torrentfile -t http://tracker.com --noprogress
- to specify the save location use the
-o
or--out
flags
>torrentfile create -o /specific/path/name.torrent ./content
- to create files using bittorrent v2 use
--meta-version 2
- likewise
--meta-version 3
creates a hybrid torrent file.
>torrentfile create --meta-version 2 /path/to/content
>torrentfile create --meta-version 3 /path/to/content
- to output a magnet URI for the created torrent file use
--magnet
>torrentfile create --t https://tracker1/annc https://tracker2/annc --magnet /path/to/content
Check/Recheck Torrent
Using the sub-command recheck
or check
or r
you can check the percentage of a torrent
is saved to disk by comparing the the contents to a torrent metafile.
- recheck torrent file
/path/to/some.torrent
with/path/to/content
- enter the metafile path first then the content path (the order matters)
>torrentfile recheck /path/to/some.torrent /path/to/content
Edit Torrent
Using the sub-command edit
or e
enables editting a pre-existing torrent file.
The edit sub-command works the same as the create
sub-command and accepts many
of the same arguments.
Create Magnet
To create a magnet URI for a pre-existing torrent meta file, use the sub-command
magnet
or m
with the path to the torrent file.
>torrentfile magnet /path/to/some.torrent
Interactive Mode
Alternatively to supplying a bunch of command line arguments, interactive mode
allows users to specify program options one at a time from a series of prompts.
- to activate interactive mode use
-i
or--interactive
flag
>torrentfile -i
GUI
If you prefer a graphical windowed interface please check out the official GUI frontend here