FluxTorrent 🧲

A sleek, modern, fully functional BitTorrent client for Windows built with Python, PyQt6, and the powerful libtorrent engine.

Features 🚀

• Real-time Download Engine: Backed by the robust C++ libtorrent library.
• qBittorrent-Inspired UX: Beautiful dark-mode interface with sidebar filters (Downloading, Seeding, Completed).
• Advanced Monitoring: Live graph of download/upload speeds per torrent and overall.
• Detailed Information: Peers, trackers, file contents, and deep pieces tracking for each torrent.
• Magnet Link Support: Effortlessly add torrents by pasting Magnet URIs.
• Settings Configuration: Granular control over active connections, UL/DL limits, proxy configurations, and DHT/UPnP routing.

Prerequisites 📦

• Windows 10 / 11 (64-bit recommended)
• Python 3.10+ (Tested on Python 3.13)
• OpenSSL 1.1.1 (The engine requires this specific DLL runtime which the launcher script automatically attempts to load)

Installation Guide 🛠️

1. Clone the Repository

   git clone https://github.com/Thigan12/Flux-Torrent-.git
   cd Flux-Torrent-

2. Create a Virtual Environment It's highly recommended to use a virtual environment to manage dependencies:

   python -m venv venv
   .\venv\Scripts\activate

3. Install Dependencies Install the required Python packages from the requirements.txt file:

   pip install -r requirements.txt

   Note: Because libtorrent on Windows requires specific OpenSSL 1.1.1 libraries, make sure libcrypto-1_1-x64.dll and libssl-1_1-x64.dll are accessible in your environment, or gui_main.py will attempt to gracefully catch the issue.

Running the App ▶️

To launch the desktop client, execute the gui_main.py entry point:

.\venv\Scripts\python gui_main.py

Depending on your configuration, Windows Defender or your firewall may prompt you to allow Python through the firewall. You must allow this so the libtorrent engine can establish peer-to-peer connections and connect to the DHT nodes.

How to Download a Torrent 📥

1. Click the bright + Add Torrent or 🧲 Add Magnet button in the top toolbar.
2. Select your .torrent file or paste your Magnet link URL.
3. Validate your Save Path to ensure the downloaded video/file ends up in your expected downloads directory.
4. Click OK.
5. Once the download completes, you can Double-Click the torrent in the list, and Windows Explorer will automatically pop open, highlighting your newly downloaded file!

License

MIT License.