Metadata-Version: 2.4
Name: torrent-downloader-python
Version: 1.1.11
Summary: A Torrent Downloader with a graphical user interface built using Tkinter and libtorrent
Home-page: https://github.com/stevenbtc/torrent-downloader
Author: Steven Yan
Author-email: yulong.yan@uqconnect.edu.au
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: End Users/Desktop
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Operating System :: OS Independent
Classifier: Topic :: Internet :: File Transfer Protocol (FTP)
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: libtorrent>=2.0.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# Torrent Downloader Desktop App

A lightweight, cross-platform torrent downloader with a native GUI built using Python and Tkinter.

![Torrent Downloader GUI](https://github.com/stevenbtc/torrent-downloader/raw/main/torrent-downloader-python/screenshots/app_screenshot.png)

## Features

- Simple, intuitive graphical interface
- Direct magnet link downloads
- Real-time download progress tracking
- Customizable download location
- Automatic torrent metadata fetching
- Cross-platform compatibility (Windows, macOS, Linux)
- Low system resource consumption

## System Requirements

- Python 3.8 or higher
- Platform-specific libtorrent dependencies:
  - **Windows**: Microsoft Visual C++ Redistributable
  - **macOS**: `brew install libtorrent-rasterbar`
  - **Ubuntu/Debian**: `sudo apt-get install python3-libtorrent`
  - **Fedora**: `sudo dnf install rb_libtorrent-python3`

## Installation

### From PyPI (Recommended)

```bash
pip install torrent-downloader-python
```

### From Source

```bash
git clone https://github.com/stevenbtc/torrent-downloader.git
cd torrent-downloader/torrent-downloader-python
pip install -e .
```

## Usage

### Launch the GUI

```bash
# Start the application
torrent-downloader-python
```

### Using the Application

1. Launch the application
2. Paste a magnet link into the input field
3. Click "Add Torrent" to begin downloading
4. Monitor progress in the main window
5. Access completed downloads through the "Open Download Folder" option

## Alternative Installation with Conda

For users who prefer Conda environments:

```bash
# Create and activate conda environment
conda create -n torrent-env python=3.11
conda activate torrent-env

# Install libtorrent dependency
conda install -c conda-forge libtorrent

# Install the package
pip install torrent-downloader-python
```

## Development

```bash
# Clone repository
git clone https://github.com/stevenbtc/torrent-downloader.git
cd torrent-downloader/torrent-downloader-python

# Install in development mode
pip install -e .

# Run the application
python torrent_downloader_gui.py

# Run tests
python -m pytest tests/
```

## License

MIT License - See LICENSE file for details.

## Legal Notice

This software is intended for downloading legal torrents only. Users are responsible for compliance with applicable laws. 
