Using BitTorrent

To use BitTorrent, first locate the .torrent file for the torrent you want to download. You can copy the .torrent file to the working directory (the first format shown below) or specify it with a --url option (second format). The simplest BitTorrent command lines have the following formats:

$ btdownloadheadless.py --responsefile tfile.torrent [--saveas savefile]

or

$ btdownloadheadless.py --url http://domain/tfile.torrent [--saveas savefile]

where tfile.torrent is the name of, or http://domain/tfile.torrent is the URI for, the .torrent file, and savefile is the location to save the torrent in. In the case of torrents containing a single file, the file is saved as savefile. For torrents containing multiple files, the files are saved in a directory named savefile. If you omit the --saveas argument, the files are saved in the name specified in the .torrent file. Because each of the btdownload*.py applications takes the same arguments, the preceding formats work for all three applications.