Introducing tget, a user-friendly command-line tool for effortless torrent downloading.
Install Go
Install go This project requires go 1.21.7 or higher.go install github.com/sweetbbak/tget@latest
With Nix (warning, these are my first ever flakes.)
nix profile install github:sweetbbak/tget
Build from source
git clone https://github.com/sweetbbak/tget.git && cd toru
go build -o tget .
you can also use the justfile
git clone https://github.com/sweetbbak/tget.git && cd tget
just
Run to find your target architecture and platform:
go tool dist list
then use the environment variables GOOS
and GOARCH
before running
the build command.
Example:
GOOS=linux GOARCH=arm64 go build -o tget
download a torrent from a magnet:
tget --torrent "magnet:..."
tget --torrent "/path/to/file.torrent"
tget --torrent "https://example.tld/files/file.torrent"
# or you can non-explicitly supply the same arguments without a flag if you wish
tget "magnet:..."
Use IPv4 (instead of IPv6) and specify an output directory:
tget --ipv4 --output=/path/to/output --torrent "magnet:..."
Use a Proxy and an IP Blocklist:
tget \
--ipv4 \
--output=/path/to/output \
--proxy=123.123.123.1 \
--blocklist https://myblocklist/ip-blocklist.txt \
--torrent "magnet:..."
You can supply a blocklist from a remote URL or locally on the filesystem. Currently, this only supports non-compressed and non-packed blocklists but that will come in the future.
Consider creating a PR, taking up a minor issue on the TODO list, leaving an issue to help improve functionality or buy me a coffee!