Skip to main content

rofi-tpb

Dynamic menu interface for The Pirate Bay, built with rofi in mind.

Install

pip install rofi-tpb

Consider using pipx:

pipx install rofi-tpb

Usage

Prompt to either search tpb or browse tpb's top torrents:

rofi-tpb

Prompt for search query:

rofi-tpb search

Search for ubuntu related torrents:

rofi-tpb search ubuntu

Browse tpb's top torrents across all categories:

rofi-tpb top all

Browse tpb's recent top torrents across all categories in the last 48h:

rofi-tpb top all -r

Check the help for details:

rofi-tpb --help
...
rofi-tpb search --help
...
rofi-tpb top --help
...

Dependencies

  • python >= 3.6
  • tpblite
  • dynmen
  • lxml
  • traitlets (undeclared dependency of dynmen)

Configuration

rofi-tpb stores its config in $XDG_CONFIG_HOME/rofi-tpb/config.ini.

The default configuration is the following:

[menu]
command = rofi -dmenu -i
torrent_format = {title:<65} 📁{filesize:<12} 🔽{seeds:<4} 🔼{leeches:<4} Trusted: {trusted} VIP: {vip}
vip_str = ✅
not_vip_str = ❌
trusted_str = ✅
not_trusted_str = ❌
use_tpb_proxy = True
tpb_url = https://thepiratebay0.org
categories = All, APPLICATIONS, AUDIO, GAMES, OTHER, PORN, VIDEO
categories_48h = True

[actions]
add = xdg-open '{magnetlink}'
open = xdg-open '{url}'
  • menu.command: the dynamic menu command which should read from stdin and output to stdout, if you want to use dmenu instead of rofi then adjust this command accordingly.
  • menu.torrent_format: text representation of a torrent in the dynamic menu, accepts torrent string format keys.
  • menu.use_tpb_proxy: if True will use the first tpb url as found on https://piratebayproxy.info/.
  • menu.vip_str: string to use in the menu.torrent_format when the user is VIP.
  • menu.not_vip_str: string to use in the menu.torrent_format when the user is not VIP.
  • menu.trusted_str: string to use in the menu.torrent_format when the user is trusted.
  • menu.not_trusted_str: string to use in the menu.torrent_format when the user is not trusted.
  • menu.tpb_url: tpb url, if use_tpb_proxy is True acts as a fallback url in case https://piratebayproxy.info/ is unavailable or the parsing fails.
  • menu.categories: comma separated list of tpb categories, when browsing the top torrents.
  • menu.categories_48h: add last 48h top torrent categories.
  • actions.*: commands to run on the selected torrent, accepts torrent string format keys.

Available torrent string format keys:

  • {title}: torrent title
  • {filesize}: torrent file size
  • {seeds}: number of seeders
  • {leeches}: number of leechers
  • {uploader}: torrent uploader
  • {upload_date}: upload date
  • {url}: torrent's tpb url
  • {magnetlink}: torrent magnet link
  • {vip}: uploader is VIP, replaced with menu.vip_str/menu.not_vip_str.
  • {trusted}: uploader is trusted, replaced with menu.trusted_str/menu.not_trusted_str.

If the menu.command uses rofi, rofi-tpb will use rofi's -multiple-select flag to allow for selecting multiple torrents.

Metadata

Release files for rofi-tpb 0.2.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for rofi-tpb 0.2.7
File Size Uploaded Provenance Actions
rofi-tpb-0.2.7.tar.gz 7.8 kB Without provenance Details for rofi-tpb-0.2.7.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for rofi-tpb 0.2.7
File Interpreter ABI Platform Actions
rofi_tpb-0.2.7-py3-none-any.whl Python 3 none any Details for rofi_tpb-0.2.7-py3-none-any.whl

Total release size: 16.5 kB

Release files / rofi-tpb-0.2.7.tar.gz

Download URL rofi-tpb-0.2.7.tar.gz
Size 7.8 kB
Tags Source
SHA-256 checksum
How to use checksums
606d10ec71562c97222141dbc0467aaaa9737cf5bf78136d33f07a2b0d3c35ef
BLAKE2b-256 checksum
How to use checksums
170e5476db7d35de52c4788a0c4e42136763db3f24013e276d6c293f7b09ccc5
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.9.6 Linux/5.12.15-arch1-1

Release files / rofi_tpb-0.2.7-py3-none-any.whl

Download URL rofi_tpb-0.2.7-py3-none-any.whl
Size 8.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
a24b8b0c998968c3bc7100200ad6a3e40c54e9b7db36d2964a8b254ab3d73b73
BLAKE2b-256 checksum
How to use checksums
ace205af9a94351cf860b4cd748f7e4907f2174d4f0ba90d40c7e7a94e1f7e5a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via poetry/1.1.7 CPython/3.9.6 Linux/5.12.15-arch1-1

Security for rofi-tpb 0.2.7

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page