A modern, user-friendly torrent downloader application
Project description
Torrent Downloader
A modern, user-friendly torrent downloader application built with React and Python.
Features
- Clean, modern user interface
- Real-time download progress and speed monitoring
- Cross-platform support (Windows, macOS, Linux)
- Easy-to-use magnet link support
- Dark mode support
Prerequisites
Before installing, make sure you have the required system dependencies:
System Dependencies
Windows
- Python 3.8 or higher
- Microsoft Visual C++ Redistributable (latest version)
macOS
# Required: Install libtorrent system package
brew install libtorrent-rasterbar
Linux (Ubuntu/Debian)
# Required: Install libtorrent system package
sudo apt-get update
sudo apt-get install python3-libtorrent
Linux (Fedora)
# Required: Install libtorrent system package
sudo dnf install rb_libtorrent-python3
Alternative Installation Methods
Using Conda (All Platforms)
If you're using Conda, you can install libtorrent in your environment:
conda create -n torrent-env python=3.11
conda activate torrent-env
conda install -c conda-forge libtorrent
Installation
Method 1: Using pip (Recommended)
# 1. Install system dependencies (see Prerequisites section above)
# 2. Create and activate a virtual environment (recommended)
python3 -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
# 3. Install the package
pip install torrent-downloader-react
# 4. Run the application
torrent-downloader-react
The application will start and open in your default web browser at http://127.0.0.1:8000
Method 2: From Source
- Clone the repository:
git clone https://github.com/yourusername/torrent-downloader.git
cd torrent-downloader/torrent-downloader-react
- Build the application:
cd backend
python build.py
- Install the built package:
pip install dist/torrent-downloader-*.whl
- Run the application:
torrent-downloader
Usage
- Start the application using one of the installation methods above
- The application will open in your default web browser
- Paste a magnet link into the input field
- Click "Add Torrent" to start downloading
- Monitor progress in the torrents list
- Click "Open Downloads" to view your downloaded files
Development
Frontend (React)
cd torrent-downloader-react
npm install
npm run dev
Backend (Python)
cd torrent-downloader-react/backend
pip install -r requirements.txt
python -m torrent_downloader.server
Contributing
- Fork the repository
- Create your feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add some amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
License
This project is licensed under the MIT License - see the LICENSE file for details.
Disclaimer
This software is for downloading legal torrents only. The authors are not responsible for any misuse of this software.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file torrent-downloader-react-1.0.13.tar.gz.
File metadata
- Download URL: torrent-downloader-react-1.0.13.tar.gz
- Upload date:
- Size: 68.6 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
d55085865c8a256ecdc3c5ab001334b1bf0d201cb2b0b8f2d8cb7930710a4e07
|
|
| MD5 |
619cece8ceceb8e6b44088b5e820b5cf
|
|
| BLAKE2b-256 |
8ea9b750c834ba07245e9c144d00814bbc47b92b6f551ffec60dde28eb96a9e3
|
File details
Details for the file torrent_downloader_react-1.0.13-py3-none-any.whl.
File metadata
- Download URL: torrent_downloader_react-1.0.13-py3-none-any.whl
- Upload date:
- Size: 68.1 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.11
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
c708c5cecf8bc25047e5e542713727082b28bb5a612f9fcdfdb98c622232a5da
|
|
| MD5 |
23d5e0fb4b91882df97a4ab1fe52216a
|
|
| BLAKE2b-256 |
4bdac7fc21ff86b04b8b1c900528a012adce44ba3b70b51f05df90c4ae2acfdf
|