Skip to content

rff-glitch/RFF-Torrent

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

RFF-Torrent Application - Readme

Description:

RFF-Torrent is a lightweight GUI torrent client built with Python, libtorrent, and Tkinter. It provides a simple interface for downloading torrent files with resume capability.

Features:

  • Clean, dark-themed GUI interface
  • Torrent download with progress tracking
  • Automatic resume of downloads after restart
  • Download statistics (peers, seeds, download/upload speed)
  • Pause/Resume functionality
  • Support for multiple simultaneous downloads
  • DHT, LSD, UPnP, and NAT-PMP enabled for better connectivity

Requirements:

  1. Python 3.7 or higher
  2. Required Python packages:
    • libtorrent (pip install libtorrent)
    • tkinter (usually comes with Python)

Installation:

  1. Install Python from python.org if not already installed
  2. Install libtorrent:
    • Windows: pip install libtorrent
    • Linux: pip install libtorrent or use package manager
    • MacOS: pip install libtorrent (may require additional dependencies)
  3. Save the application file as "rff_torrent.py"

How to Use:

  1. Run the application: python rff_torrent.py

  2. Interface elements:

    • Text box: Enter torrent file path or use "Browse" button
    • Start: Begin download (will prompt for save directory)
    • Pause: Temporarily pause current download
    • Resume: Continue paused download
    • Progress bar: Shows download completion percentage
    • Stats panel: Shows peers, seeds, and transfer speeds
  3. Steps to download: a) Click "Browse" to select a .torrent file b) Click "Start" c) Select a directory to save the downloaded files d) Monitor progress in the interface

Important Notes:

  1. The application creates two directories:

    • "torrents/": Stores torrent files for auto-resume
    • Uses "session.state" to save session data
  2. Auto-resume feature:

    • On restart, the app automatically resumes torrents from the "torrents/" directory
    • Downloaded files are saved to the last selected directory
  3. Network settings (modifiable in code):

    • Port range: 6881-6891
    • Max connections: 800
    • Max active downloads: 20
    • Unlimited download/upload rate (set to 0)

Troubleshooting:

  1. If libtorrent fails to install:

    • On Windows: Try precompiled wheels or install from unofficial binaries
    • On Linux: Install libtorrent-rasterbar development packages first
  2. If GUI doesn't appear:

    • Ensure tkinter is installed: python -m tkinter (should open a test window)
  3. Port issues:

    • Ensure ports 6881-6891 are not blocked by firewall
    • Change ports in code if needed: ses.listen_on(6881, 6891)
  4. Slow downloads:

    • Check internet connection
    • Ensure torrent has active seeders
    • Adjust connection limits in code if needed

Code Safety:

  • Only downloads torrents from user-selected files
  • No built-in search or magnet link support
  • Always prompts for save directory
  • No automatic execution of downloaded files

Limitations:

  • No magnet link support
  • Basic GUI without advanced features
  • No torrent creation capability
  • Limited to 20 simultaneous downloads

Legal Disclaimer:

This application is for legal torrent downloading only. Users are responsible for ensuring they have the right to download and share any content. The developer assumes no responsibility for copyright infringement or illegal use.

Files Created:

  1. session.state - Session data for resume
  2. torrents/ directory - Stores torrent files
  3. User-selected download directory

Development:

Developer: rff-glitch Built with: Python, libtorrent, Tkinter License: Check source code for licensing information

Support:

For issues or questions, refer to the code comments or contact the developer.

Version: 1.0

About

A minimal, efficient torrent client ✨ with a dark-themed GUI built using Python, libtorrent, and Tkinter. Features auto-resume, real-time stats, and session persistence for seamless downloads.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Contributors

Languages