Skip to content

BastienClement/tget

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

48 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

tget

Command-line torrent downloader and HTTP streaming server

npm install -g tget

Based on the fantastic torrent-stream and peerflix, by mafintosh

Usage

tget <path|url|magnet> [options]

Example

tget "magnet:?xt=urn:btih:757fc565c56462b28b4f..." -s 9000

Options

Option Long name Description Default
-c NUM connections Maximum connections 100
-d NUM dht Number of DHT peers to find 10000
-e ephemeral Ephemeral mode
-i idle Stay idle and don't quit when done
-l PORT listen Listen for incoming connections
-p PEER peer Explicit peer (in the form addr:ip)
-q quiet Quiet mode
-s [PORT] stream Enable live streaming on given port 8888
-t notracker Disable trackers
-u NUM uploads Maximum upload slots 10
-w wait Wait for stream before downloading

Video streaming

When downloading a video torrent, tget can stream it to your favorite media player as soon as its pieces are received.

Passing the -s option (with an optional port number) enables the streaming feature.

Then, simply open http://127.0.0.1:<port>/<file_id> in your media player.

The default streaming port is 8888.

If you don't specify the target file, tget will search for media files inside the torrent. If more than one media file is available, tget will provide a m3u playlist listing all media files found. Else, the default file will be the biggest file from the torrent.

While stream data has higher priority than non-stream data (such as .nfo or preview files), tget still download the entire torrent data when bandwidth allows it. When the -w option is given, tget will wait an incoming stream connection before dowloading any data from the torrent.

When the -w option is given, -e and -i are implicitely enabled. This turns tget into a streaming-only downloader and no data will be kept upon exit.

Local streaming

The stream engine from tget can also be used for streaming local files.

When the -S option is given, tget will not attempt to download a torrent but will instead use the given path as the stream data source. This can be a single file as well as a directory.

tget ./local.mp4 -S

If the -S option is given, no other option will be used. -i is implicitely enabled.

License

MIT

About

Command-line torrent downloader and HTTP streaming server

Resources

License

Stars

Watchers

Forks

Packages

No packages published