fuckooredoo 1.0.1

Secure Torrent Downloader with Tor-based Anti-Throttling - Bypasses ISP throttling through Tor network routing and traffic encryption

🚀 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.

🔒 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:

sudo apt update && sudo apt install tor
sudo systemctl start tor

Fedora:

sudo dnf install tor
sudo systemctl start tor

Arch Linux:

sudo pacman -S tor
sudo systemctl start tor

macOS:

brew install tor
brew services start tor

Windows:

• Download and install Tor Browser from torproject.org
• Or use Chocolatey: choco install tor

2. Install F_ooredoo

pip install fuckooredoo

3. Run the Application

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:

   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

# 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":

# Linux
sudo systemctl start tor

# macOS
brew services start tor

# Windows
# Start Tor Browser or tor.exe

"No module named 'libtorrent'" Error

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:

python --version  # Should be 3.8+

Reinstall:

pip uninstall fuckooredoo
pip install fuckooredoo

Windows-Specific Issues

If you encounter issues on Windows:

1. Install Python from 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 file for details.

👨‍💻 Author

Mohamed Aziz Bahloul

• GitHub: @AzizBahloul
• Project: 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!

---

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

Encryption is your right. Privacy matters. 🔒