2 unstable releases
0.2.0 | Dec 29, 2023 |
---|---|
0.1.0 | Jun 24, 2023 |
#1372 in Network programming
190KB
4.5K
SLoC
GitHub | crates.io | Issues | Changelog
demagnetize
is a Rust program for converting one or more BitTorrent magnet
links into .torrent
files
by downloading the torrent info from active peers.
At the moment, demagnetize
only supports basic features of the BitTorrent
protocol. The following notable features are supported:
- BitTorrent protocol v1
- HTTP (including compact and IPv6 extensions) and UDP trackers
- magnet URIs with info hashes encoded in either hexadecimal or base32
- Fast extension (BEP 6)
- UDP tracker protocol extensions (BEP 41)
The following features are not currently supported but are planned, in no particular order:
- Encryption
- Distributed hash tables
- BitTorrent protocol v2
x.pe
parameters in magnet links- uTP
demagnetize
is a translation of a Python program by the same author; you can
find the Python version at https://github.com/jwodder/demagnetize.
Installation
In order to install demagnetize
, you first need to have Rust and Cargo
installed. You can then build the
latest release of demagnetize
and install it in ~/.cargo/bin
by running:
cargo install demagnetize
Usage
demagnetize [<global options>] <subcommand> ...
The demagnetize
command has two subcommands, get
(for converting a single
magnet link) and batch
(for converting a file of magnet links), both detailed
below.
Global Options
-l <level>
,--log-level <level>
— Set the log level to the given value. Possible values are "OFF
", "ERROR
", "WARN
", "INFO
", "DEBUG
", and "TRACE
" (all case-insensitive). [default value:INFO
]
demagnetize get
demagnetize [<global options>] get [<options>] <magnet-link>
Convert a single magnet link specified on the command line to a .torrent
file. (Note that you will likely have to quote the link in order to prevent it
from being interpreted by the shell.) By default, the file is saved at
{name}.torrent
, where {name}
is replaced by the value of the name
field
from the torrent info, but a different path can be set via the --outfile
option.
Options
-o PATH
,--outfile PATH
— Save the.torrent
file to the given path. The path may contain a{name}
placeholder, which will be replaced by the (sanitized) name of the torrent, and/or a{hash}
placeholder, which will be replaced by the torrent's info hash in hexadecimal. Specifying-
will cause the torrent to be written to standard output. [default:{name}.torrent
]
demagnetize batch
demagnetize [<global options>] batch [<options>] <file>
Read magnet links from <file>
, one per line (ignoring empty lines and lines
that start with #
), and convert each one to a .torrent
file. By default,
each file is saved at {name}.torrent
, where {name}
is replaced by the value
of the name
field from the torrent info, but a different path can be set via
the --outfile
option.
Options
-o PATH
,--outfile PATH
— Save the.torrent
files to the given path. The path may contain a{name}
placeholder, which will be replaced by the (sanitized) name of each torrent, and/or a{hash}
placeholder, which will be replaced by each torrent's info hash in hexadecimal. [default:{name}.torrent
]
Dependencies
~11–25MB
~398K SLoC