Package: torrentfile
TorrentFile🌐 OverviewA command line interface for creating, reviewing, editing, or verifying bittorrent meta files (.torrentfiles).torrentfileis open source, and supports all versions of Bittorrent files, including hybrid meta files. The code base
is also importable and can easily be used as a library for creating or manipulating torrent files in external projects.
Documentation is available athttps://alexpdev.github.io/torrentfile.A GUI frontend for this project can be found athttps://github.com/alexpdev/TorrentfileQt🔌 RequirementsPython 3.6+Tested on Linux, Windows and Mac💻 InstallPyPi:pipinstalltorrentfileGit:gitclonehttps://github.com/alexpdev/torrentfile.gitcdtorrentfile
pipinstall.Download pre-compiled binaries from therelease page.📚 Documentationtorrentfile documentation available athttps://alexpdev.github.io/torrentfile🚀 UsageUsage examples can be found in the project documentation on theexamples page.📝 LicenseApache Software License v2.0 - SeeLICENSE💡 Issues & Requests & PRsIf you encounter any bugs or would like to request a new feature please open a new issue.
PRs and other contributions that are meaningful and add value to the project are welcome.Usage ExamplesCreating Bittorrent FilesCreating a basic torrent file is as easy as using the create subcommand with the path to the torrent file.torrentfilecreate/path/to/contentYou can add one or more trackers by using any one of-a,--announceflags and listing their URL as a space separated list.torrentfilecreate/path/to/content-ahttp://tracker1.comhttp://tracker2.netIf you intend to distribute the file on a private tracker then you should use oneof-p,--privateflags, which tells your Bittorrent clients to disable DHT andmultitracker protocols.torrentfilecreate/path/to/content--privateBy defaulttorrentfiledisplays a progress bar indicating how much of the contenthas already been processed.  To turn off this display you can either use--quietmode inas a global flag or you can set the--progflag to 0.torrentfilecreate/path/to/content--prog0torrentfileextracts the name of the contents top level file or directoryand saves the torrent file to the current working directory with the extracted title.For example running the follwing command would create./content.torrent.torrentfilecreate/path/to/contentTo specify an alternative path or filename you may use the-o,--outflagsfollowed by the path to the preferred destination.torrentfilecreate/path/to/content-o/some/other/path/torrent.torrentIf the path specified is an existing directory, then the torrent file will be
saved to that directory, with same filename as the default top level path name.For example the following command would create a torrent file at/some/other/path/content.torrent.torrentfilecreate/path/to/content-o/some/other/path/torrentfilecreates Bittorrent v1 files by default. To create a V2 or hybrid (v1 and v2)
torrent file, use the--meta-versionoption followed by the preferred version number option.
The options include:1(v1 default),2(v2), or3(v1 & v2).torrentfilecreate/path/to/content--meta-version2torrentfilecreate/path/to/content--meta-version3torrentfileincludes the option to command line flags for thecreatesub-command from aninistyle
configuration file, by using the--configand optional--config-pathoptions to specify the path
to the configuration file.  If--config-pathis ommited, thentorrentfilewill look by default in the current
working directory for a file namedtorrentfile.ini. If the file is not discovered in the current working directory,
it will move on to look~/.torrentfile/torrentfile.inifollowed by~/.config/torrentfile.ini.  Please see thedocumentationfor more details on how the configuration file should be
formatted.Check/Recheck TorrentTherechecksubcommand allows you to scan a Bittorrent file and compare it's contents,
against a file or directory containing the contents the torrent file was created from.
The output provided by this process gives a detailed perspective if any files are missing
or have been corrupted in any way.  Supports any version of Bittorrent file.torrentfilerecheck/path/to/some.torrent/path/to/contentEdit TorrentTo edit specific fields of the torrent file, there is theeditsubcommand.  Using this
subcommand you can specify the field with one of the available field flags, for example--announceand specify the value you wish to change it to.torrentfileedit/path/to/content--announcehttps://new.tracker.url1.comhttps://newtracker.url/2You can use the-hflag for a full list of available fields that can be edited.torrentfileedit-hCreate MagnetTo create a magnet URI for a pre-existing torrent meta file, use the sub-commandmagnetwith the path to the torrent file.torrentfilemagnet/path/to/some.torrentGUIIf you prefer a windowed GUI please check out the official GUI frontendhere