Skip to main content

A simple command line tool for the pirate bay.

Project description

pyratebay

PyPI Version Downloads

Platform uv ruff License

GitHub stars

Python tools for The Pirate Bay. A simple command line interface and Python API.

Installation

From PyPI

pip install pyratebay

For Developers

git clone https://github.com/evilcult/pyratebay
cd pyratebay
pip install . 
# or for development    
pip install -e .

CLI Usage

After installation, the pyratebay command will be available.

Search Torrents

Search for torrents by keyword.

pyratebay search "ubuntu"

View Torrent Info

Get detailed attributes for a specific torrent ID.

pyratebay info 12345

Browse Hot Torrents

List top 100 recent torrents.

# Default (Movies)
pyratebay hot

# Filter by category (e.g. games, music, applications, etc.)
pyratebay hot -t games

# Limit to last 48h
pyratebay hot -l true

Python Library Usage

You can also use pyratebay as a library in your Python projects.

import pyratebay

# 1. Search
# Returns a list of Media objects
results = pyratebay.search("ubuntu")
for media in results:
    print(f"{media.title} - {media.info_hash}")

# 2. Get Info
# Returns a single Media object with details
media_details = pyratebay.info("12345")
print(media_details.desc)

# 3. Get Hot/Top 100
hot_list = pyratebay.hot(media_type="games", limit=True) # limit=True for recent 48h

Disclaimer

This tool is for educational purposes only. The author is not responsible for any misuse of this tool. Please ensure you comply with your local laws and regulations regarding torrenting and copyright.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

pyratebay-0.2.1.tar.gz (15.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

pyratebay-0.2.1-py3-none-any.whl (14.6 kB view details)

Uploaded Python 3

File details

Details for the file pyratebay-0.2.1.tar.gz.

File metadata

  • Download URL: pyratebay-0.2.1.tar.gz
  • Upload date:
  • Size: 15.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pyratebay-0.2.1.tar.gz
Algorithm Hash digest
SHA256 23c34d9982c2e12ae3a952014047afac57f4d2757c73c0acd8abe4efec033f5f
MD5 d4b008c9ca87760c97a791acce55add9
BLAKE2b-256 e13f193f93506254dc7aee7752b09ce7129d7cd7abb4c5659643b89181a1e458

See more details on using hashes here.

File details

Details for the file pyratebay-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: pyratebay-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 14.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.9.18 {"installer":{"name":"uv","version":"0.9.18","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}

File hashes

Hashes for pyratebay-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 f65231a9fdc89ca21bbe158547463e19ab99e5a99d89258a174d7d7b40c5417e
MD5 26918ce4f8cff64002e847a6c8fd615b
BLAKE2b-256 b52a03cbd02309e267b8bf2c767de0c7dca474822689df3088b03805c1910fee

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page