Skip to content
A command line interface for The Pirate Bay
HTML Python
Branch: master
Clone or download
Latest commit 5368dac Nov 6, 2018
Type Name Latest commit message Commit time
Failed to load latest commit information.
pirate bump version Sep 19, 2018
tests add some configs and local csv db search May 28, 2018
.coveragerc configure cover better Sep 17, 2015
.gitignore ignore .pypirc Jun 16, 2018
LICENSE move license, better shields Sep 12, 2015 add some configs and local csv db search May 28, 2018
circle.yml configure cover better Sep 17, 2015
requirements-test.txt add coveralls Sep 12, 2015
requirements.txt Fixed a typo in the modified dependency list, inside Jun 14, 2018


Circle CI Coverage Status Code Climate Codacy Badge Gemnasium License Version Downloads

pirate-get is a convenient command line tool (inspired by APT) to speed up your trip to the Pirate Bay and get your completely legal torrents more quickly.


Make sure you have python 3.4 and pip installed. On Ubuntu 14.04 you may also need to install the libxslt1-dev and libxml2-dev packages.

Run pip3 install pirate-get


To search use pirate-get [search term].

See pirate-get -h for more options.

Watch this for an example usage.

Configuration file

You can use a file to override pirate-get's default settings. Default is $XDG_CONFIG_HOME/pirate-get. If it does not exist then $HOME/.config/pirate-get.

Default config file

Here the available options and their behaviors are when unset:

; directory where to save files
directory = $PWD

; save each selected magnet link in a .magnet file
magnets = false

; save each selected torrent in a .torrent file
torrents = false

; use a local copy of the csv formatted pirate bay database
enabled = false

; path of the database
path = ~/downloads/pirate-get/db

; specify a custom command for opening the magnet
; ex. myprogram --open %s
; %s represent the magnet uri
openCommand =

; open magnets with transmission-remote client
transmission = false
; set to username:password if needed
transmission-auth =
; set to the port number if needed
transmission-port =

; use colored output
colors = true

; the pirate bay mirror(s) to use:
; one or more space separated URLs
mirror =

Note: Any command line option will override its respective setting in the config file.

Local Database

If you want to use a local copy of the Pirate Bay database download a copy here (or wherever the latest version is currently):


pirate-get is licensed under the GNU Affero General Public License version 3 or later. See the accompanying file LICENSE or

You can’t perform that action at this time.