1616
1717## 🌐 Overview
1818
19- A command line interface for creating, reviewing, editing, or verifying bittorrent meta files (` .torrent ` files).
19+ A command line interface for creating, reviewing, editing, or verifying bittorrent meta files (` .torrent ` files).
2020_ ` torrentfile ` _ is open source, and supports all versions of Bittorrent files, including hybrid meta files. The code base
2121is also importable and can easily be used as a library for creating or manipulating torrent files in external projects.
2222Documentation is available at [ https://alexpdev.github.io/torrentfile ] ( https://alexpdev.github.io/torrentfile ) .
@@ -25,8 +25,8 @@ Documentation is available at [https://alexpdev.github.io/torrentfile](https://a
2525
2626## 🔌 Requirements
2727
28- - Python 3.6+
29- - Tested on Linux, Windows and Mac
28+ - Python 3.6+
29+ - Tested on Linux, Windows and Mac
3030
3131## 💻 Install
3232
@@ -63,10 +63,7 @@ Apache Software License v2.0 - See [LICENSE]("https://github.com/alexpdev/torren
6363## 💡 Issues & Requests & PRs
6464
6565If you encounter any bugs or would like to request a new feature please open a new issue.
66-
67- > PRs and other contributions are welcome
68-
69- < https://github.com/alexpdev/torrentfile/issues >
66+ PRs and other contributions that are meaningful and add value to the project are welcome.
7067
7168* * *
7269
@@ -80,7 +77,7 @@ Creating a basic torrent file is as easy as using the create subcommand with the
8077torrentfile create /path/to/content
8178```
8279
83- You can add one or more trackers by using any one of ` -a ` , ` --announce `
80+ You can add one or more trackers by using any one of ` -a ` , ` --announce `
8481flags and listing their URL as a space separated list.
8582
8683``` bash
@@ -99,10 +96,6 @@ By default **`torrentfile`** displays a progress bar indicating how much of the
9996has already been processed. To turn off this display you can either use ` --quiet ` mode in
10097as a global flag or you can set the ` --prog ` flag to 0.
10198
102- ``` bash
103- torrentfile --quiet create /path/to/content
104- ```
105-
10699``` bash
107100torrentfile create /path/to/content --prog 0
108101```
@@ -132,10 +125,9 @@ For example the following command would create a torrent file at `/some/other/pa
132125torrentfile create /path/to/content -o /some/other/path/
133126```
134127
135- Bittorrent protocol V1 is still the most commonly used version, therefore _ ` torrentfile ` _ creates
136- Bittorrent version 1 torrent files by default. To specify creating a V2 file or hybrid (v1 and v2)
137- use the ` --meta-version ` followed by the specific version number format to use. The options include:
138- ` 1 ` (v1 default), ` 2 ` (v2), or ` 3 ` (v1 & v2).
128+ _ ` torrentfile ` _ creates Bittorrent v1 files by default. To create a V2 or hybrid (v1 and v2)
129+ torrent file, use the ` --meta-version ` option followed by the preferred version number option.
130+ The options include: ` 1 ` (v1 default), ` 2 ` (v2), or ` 3 ` (v1 & v2).
139131
140132``` bash
141133torrentfile create /path/to/content --meta-version 2
@@ -145,17 +137,17 @@ torrentfile create /path/to/content --meta-version 2
145137torrentfile create /path/to/content --meta-version 3
146138```
147139
148- > ` torrentfile ` now includes the option to command line flags for the ` create ` sub-command from an ` ini ` style
140+ ` torrentfile ` includes the option to command line flags for the ` create ` sub-command from an ` ini ` style
149141configuration file, by using the ` --config ` and optional ` --config-path ` options to specify the path
150142to the configuration file. If ` --config-path ` is ommited, then ` torrentfile ` will look by default in the current
151- working directory for a file named ` torrentfile.ini ` . If the file is not discovered in the current working directory,
152- it will move on to look ` ~/.torrentfile/torrentfile.ini ` followed by ` ~/.config/torrentfile.ini ` . Please see the
143+ working directory for a file named ` torrentfile.ini ` . If the file is not discovered in the current working directory,
144+ it will move on to look ` ~/.torrentfile/torrentfile.ini ` followed by ` ~/.config/torrentfile.ini ` . Please see the
153145[ documentation] ( https://alexpdev.github.io/torrentfile/overview/ ) for more details on how the configuration file should be
154146formatted.
155147
156148### Check/Recheck Torrent
157149
158- The ` recheck ` subcommand allows you to scan a Bittorrent file and compare it's contents,
150+ The ` recheck ` subcommand allows you to scan a Bittorrent file and compare it's contents,
159151against a file or directory containing the contents the torrent file was created from.
160152The output provided by this process gives a detailed perspective if any files are missing
161153or have been corrupted in any way. Supports any version of Bittorrent file.
@@ -183,7 +175,7 @@ torrentfile edit -h
183175### Create Magnet
184176
185177To create a magnet URI for a pre-existing torrent meta file, use the sub-command
186- ` magnet ` or ` m ` with the path to the torrent file.
178+ ` magnet ` with the path to the torrent file.
187179
188180``` bash
189181torrentfile magnet /path/to/some.torrent
0 commit comments