Created: 2014-05-18 18:42
Updated: 2017-11-22 01:01
License: mit



tbb-transmission is a minimalist CLI that download the most seeded torrent on the piratebay for a given search.


npm install -g tbb-transmission

You need the transmission client installed and running on your machine.

For this to work, you need to enable remote access on transmission. See Preferences>Remote Control. Keep everything as default but please only allow access from localhost, just in case.


Show the most seeded torrent:

tbb-transmission the torrent name

Download the most seeded torrent:

tbb-transmission the torrent name --download (or -d)

Download a whole serie:

tbb-transmission the torrent name --serie -d

if the -d is omitted, this will simply show the names of each matching torrents. It might be a very good idea, if you add the -d option, to limit in Transmission the number of parallel downloads. See Preferences>Transfer.

You can also specify a starting point. For more information, type:

tbb-transmission --usage

Configuration guideline

Every parameter can be configured directly, like the way you access transmission or even the site you use to find torrent(in case the pirate bay do not suits your needs):

tbb-transmission --config

the configuration will be saved in you home directory under .tbb-transmission.json, and can be edit manually.


I do not encourage nor caution any kind of use you will have of this library. Please read the MIT LICENSE for more informations.

Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more