Metadata-Version: 2.4
Name: fuckooredoo
Version: 1.0.0
Summary: Secure Torrent Downloader with Tor-based Anti-Throttling - Bypasses ISP throttling through Tor network routing and traffic encryption
Author-email: Mohamed Aziz Bahloul <aziz.bahloul@example.com>
Project-URL: Homepage, https://github.com/AzizBahloul/F_ooredoo
Project-URL: Bug Tracker, https://github.com/AzizBahloul/F_ooredoo/issues
Project-URL: Source Code, https://github.com/AzizBahloul/F_ooredoo
Keywords: torrent,downloader,tor,anti-throttling,isp-bypass,bittorrent,p2p
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: End Users/Desktop
Classifier: Topic :: Communications :: File Sharing
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: Environment :: X11 Applications
Classifier: Environment :: Win32 (MS Windows)
Classifier: Environment :: MacOS X
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: libtorrent>=2.0.9
Requires-Dist: customtkinter>=5.2.0
Requires-Dist: Pillow>=10.0.0
Requires-Dist: darkdetect>=0.8.0
Requires-Dist: typing-extensions>=4.8.0

# 🚀 F_ooredoo - Secure Torrent Downloader

**Version 1.0.0** by **Mohamed Aziz Bahloul**

A modern, encrypted torrent client specifically designed to bypass ISP throttling through Tor network routing and advanced traffic encryption.

[![PyPI version](https://img.shields.io/pypi/v/fuckooredoo.svg)](https://pypi.org/project/fuckooredoo/)
[![Python versions](https://img.shields.io/pypi/pyversions/fuckooredoo.svg)](https://pypi.org/project/fuckooredoo/)
[![License](https://img.shields.io/github/license/AzizBahloul/F_ooredoo.svg)](https://github.com/AzizBahloul/F_ooredoo/blob/main/LICENSE)

## 🔒 Features

### Anti-Throttling Technology
- **Tor Network Routing**: All traffic routed through Tor SOCKS5 proxy for maximum ISP bypass
- **RC4/MSE Protocol Encryption**: Forced encryption on all BitTorrent connections
- **Deep Packet Inspection (DPI) Bypass**: Traffic obfuscation combined with Tor routing
- **DHT Obfuscation**: Encrypted peer discovery through Tor
- **uTP Protocol Support**: Additional layer to bypass throttling
- **Randomized Ports**: Avoids common BitTorrent port blocking
- **Traffic Pattern Randomization**: Makes it harder to identify torrent traffic

### User Experience
- **Modern GUI**: Built with CustomTkinter for a sleek, dark-themed interface
- **Real-time Progress**: Live download/upload speeds and peer count
- **Tor Status**: Visual indicator showing Tor proxy is active
- **Magnet Link Support**: Just paste and download
- **.torrent File Support**: Browse and select torrent files
- **Multi-torrent Management**: Download multiple files simultaneously
- **Cross-Platform**: Works on Linux, Windows, and macOS

## 📋 Requirements

- Python 3.8 or higher
- Tor (must be installed and running)
- Internet connection

## � Quick Start

### 1. Install Tor

**Ubuntu/Debian:**
```bash
sudo apt update && sudo apt install tor
sudo systemctl start tor
```

**Fedora:**
```bash
sudo dnf install tor
sudo systemctl start tor
```

**Arch Linux:**
```bash
sudo pacman -S tor
sudo systemctl start tor
```

**macOS:**
```bash
brew install tor
brew services start tor
```

**Windows:**
- Download and install Tor Browser from [torproject.org](https://www.torproject.org/download/)
- Or use Chocolatey: `choco install tor`

### 2. Install F_ooredoo

```bash
pip install fuckooredoo
```

### 3. Run the Application

```bash
fuckooredoo
```

That's it! The application will:
- ✅ Check if Tor is installed
- ✅ Verify Tor is running
- ✅ Launch the GUI with all features ready
- ✅ Route all torrent traffic through Tor automatically


## 🎯 How to Use

1. **Start the application**:
   ```bash
   fuckooredoo
   ```

2. **Add a Magnet Link**:
   - Copy a magnet link (starts with `magnet:?xt=urn:btih:...`)
   - Paste it in the input field
   - Click "⬇ Download"

3. **Or Use a .torrent File**:
   - Click "📁 Browse .torrent"
   - Select your file
   - Click "⬇ Download"

### Managing Downloads

- **Pause**: Click the ⏸ button
- **Resume**: Click the ▶ button
- **Remove**: Click the 🗑 button
- **Change Location**: Click "Change" in the status bar

## 🔧 Advanced Usage

### Development Installation

```bash
# Clone the repository
git clone https://github.com/AzizBahloul/F_ooredoo.git
cd F_ooredoo

# Install in development mode
pip install -e .

# Run the application
fuckooredoo
```

### Configuration

The application uses optimal settings by default:
- **Encryption Mode**: Forced (RC4/MSE)
- **Tor Proxy**: Enabled by default
- **Connection Limit**: 2000 peers
- **DHT**: Enabled with obfuscation

## 🛡️ How It Works

### Bypassing ISP Throttling with Tor

1. **Tor Network Routing**: All BitTorrent traffic is routed through Tor's SOCKS5 proxy (port 9050)
2. **Protocol Encryption**: RC4/MSE encryption makes traffic unreadable to ISP Deep Packet Inspection
3. **Traffic Obfuscation**: Encrypted traffic doesn't match typical BitTorrent patterns
4. **Port Randomization**: Random ports avoid simple port-based blocking
5. **DHT Obfuscation**: Peer discovery is also encrypted

### Why Tor Method Only?

This version **exclusively uses Tor** for maximum security and anonymity:
- ✅ Complete ISP bypass
- ✅ IP address protection
- ✅ Geographic restrictions bypass
- ✅ Deep packet inspection bypass
- ✅ No need for additional VPN

## 📁 Project Structure

```
F_ooredoo/
├── fuckooredoo/
│   ├── __init__.py
│   ├── __main__.py          # CLI entry point
│   ├── torrent_client.py    # Core torrent client with Tor
│   ├── gui.py               # Modern GUI
│   └── main.py              # Legacy entry point
├── pyproject.toml           # Package configuration
├── setup.py                 # Setup script
├── requirements.txt         # Dependencies
├── README.md               # This file
└── LICENSE                 # MIT License
```


## � Troubleshooting

### Tor Not Running

If you see "Tor is not running":
```bash
# Linux
sudo systemctl start tor

# macOS
brew services start tor

# Windows
# Start Tor Browser or tor.exe
```

### "No module named 'libtorrent'" Error

```bash
pip install --upgrade fuckooredoo
```

### Downloads Are Slow

- Verify Tor is running: The app will show ✅ Tor status
- Try a more popular torrent (more peers = better speeds)
- Check your internet connection speed
- Note: Tor routing may add some overhead

### Application Won't Start

Verify Python version:
```bash
python --version  # Should be 3.8+
```

Reinstall:
```bash
pip uninstall fuckooredoo
pip install fuckooredoo
```

### Windows-Specific Issues

If you encounter issues on Windows:
1. Install Python from [python.org](https://www.python.org/)
2. Check "Add Python to PATH" during installation
3. Install Microsoft Visual C++ Redistributable
4. Run Command Prompt as Administrator

## 💡 Tips for Best Performance

1. **Keep Tor Running**: Make sure Tor service is always active
2. **Popular Torrents**: Work best with more peers supporting encryption
3. **Firewall**: Allow the application through your firewall
4. **Seeding**: Keep seeding after downloads to help the network

## ⚠️ Legal Notice

This software is designed to bypass unfair ISP throttling on **legal torrent traffic** through Tor network.

- Always respect copyright laws in your country
- Only download content you have the right to download
- This tool is for educational purposes and legitimate use cases
- The developers are not responsible for any misuse

## � Future Enhancements

Potential features for future versions:
- Additional proxy support options
- Bandwidth limiting controls
- RSS feed support for automation
- Download scheduling
- Enhanced encryption options


## 📝 License

MIT License - Copyright (c) 2024 Mohamed Aziz Bahloul

See [LICENSE](LICENSE) file for details.

## 👨‍💻 Author

**Mohamed Aziz Bahloul**
- GitHub: [@AzizBahloul](https://github.com/AzizBahloul)
- Project: [F_ooredoo](https://github.com/AzizBahloul/F_ooredoo)

## 🤝 Contributing

Contributions are welcome! Areas for improvement:
- Cross-platform enhancements
- Performance optimizations
- Additional security features
- Bug fixes and testing

## 🌟 Show Your Support

If this project helps you bypass ISP throttling, give it a ⭐️ on [GitHub](https://github.com/AzizBahloul/F_ooredoo)!

---

**Made with ❤️ by Mohamed Aziz Bahloul to fight unfair ISP throttling**

*Encryption is your right. Privacy matters.* 🔒

