TorrentP

Wrapped python library for downloading from torrent

Download from torrent with .torrent file or magnet link. With just 3 lines of python code.

Installation

$ pip install torrentp

Also can be found on pypi

How can I use it?

• Install the package by pip package manager.
• After installing, you can use it and call the library.
• You have to pass magnet link or torrent file, and a path for saving the file. use . (dot) for saving in current directory.

Download with magnet link:

import asyncio
from torrentp import TorrentDownloader
torrent_file = TorrentDownloader("magnet:...", '.')
# Start the download process
asyncio.run(torrent_file.start_download()) # start_download() is a asynchronous method 

# Pausing the download
torrent_file.pause_download()

# Resuming the download
torrent_file.resume_download()

# Stopping the download
torrent_file.stop_download()

Or download with .torrent file:

import asyncio
from torrentp import TorrentDownloader
torrent_file = TorrentDownloader("test.torrent", '.')
# Start the download process
asyncio.run(torrent_file.start_download()) # start_download() is a asynchronous method 

# Pausing the download
torrent_file.pause_download()

# Resuming the download
torrent_file.resume_download()

# Stopping the download
torrent_file.stop_download()

How can I use a custom port?

torrent_file = TorrentDownloader("magnet/torrent.file", '.', port=0000)

How can I reduce memory usage for large torrents?

torrent_file = TorrentDownloader("magnet/torrent.file", '.', low_memory=True)

This applies libtorrent's low-memory session profile. It can reduce RAM usage, but may also reduce download performance.

How can I limit the upload or download speed?

Download Using 0 (default number) means unlimited speed:

await torrent_file.start_download(download_speed=0, upload_speed=0)

Or download with specifc number (kB/s):

await torrent_file.start_download(download_speed=2, upload_speed=1)

Using Command Line Interface (CLI)

Download with a magnet link:

$ torrentp --link 'magnet:...'

or download with .torrent file:

$ torrentp --link 'test.torrent'

You can also use --help parameter to display all the parameters that you can use

Example with all commands:

$ torrentp --link 'magnet:...' --download_speed 100 --upload_speed 50 --save_path '.' --stop_after_download

Manual integration test

You can run a manual download test against the Ubuntu 24.04.4 desktop ISO torrent:

python3 scripts/test_download_ubuntu.py

Edit the constants at the top of the script to change the torrent URL, save path, port, or LOW_MEMORY setting.

To do list

• Limit upload and download speed
• User can change the port
• CLI
• Pause / Resume / Stop

Star History

Issues

Feel free to submit issues and enhancement requests or contact me via vida.page/nima.

Contributing

Please refer to each project's style and contribution guidelines for submitting patches and additions. In general, we follow the "fork-and-pull" Git workflow.

1. Fork the repo on GitHub
2. Clone the project to your own machine
3. Update the Version inside init.py
4. Commit changes to your own branch
5. Push your work back up to your fork
6. Submit a Pull request so that we can review your changes