1337x

The ultimate Python API wrapper for 1337x.

Table of Contents

• Installation
• Getting Started
  • Examples
  • Asynchronous Usage
• Documentation
• Contributing
• License

Installation

Install via PyPi:

pip install 1337x

Or install from the source:

pip install git+https://github.com/hemantapkh/1337x

Examples

⚠️ Note: Due to a recent change on the 1337x website, using the .search() method without a category may return empty results. Specifying a category is temporarily recommended to ensure functionality.

Searching Torrents

import py1337x

torrents = py1337x.Py1337x()

# Basic search
results = torrents.search(
    'ubuntu',
    page=1,
    category=py1337x.category.APPS
)
for result in results.items:
  print(f"Title={result.name} Seeders={result.seeders}")

# Search with sorting by seeders
results = torrents.search('vlc', sort_by=py1337x.sort.SEEDERS, category=py1337x.category.APPS)
print(results)

# Get today's trending torrents
results = torrents.trending()
print(results)

Getting Torrent Information

To get magnetlink and other information of the torrent.

# Getting info the the first result of the above search
torrent_id = results.items[0].torrent_id
info = torrents.info(torrent_id=torrent_id)
print(info)

# Convert the result to dictionary
info_dict = info.to_dict()
print(info_dict)

Asynchronous Usage

For asynchronous usage, all functionalities are the same; use AsyncPy1337x instead of Py1337x:

import asyncio
from py1337x import AsyncPy1337x

async def main():
    torrents = AsyncPy1337x()
    results = await torrents.search('vlc media player')
    print(results)

asyncio.run(main())

Documentation

The detailled documentation of the project is available here.

Contributing

Any contributions you make are greatly appreciated.

Thanks to every contributors who have contributed in this project.

License

Distributed under the MIT License. See LICENSE for more information.

Author/Maintainer: Hemanta Pokharel