Skip to main content

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

Project description

F_ooredoo - The Ultimate Anti-Throttling Torrent Client

Version 1.0.2 by Mohamed Aziz Bahloul image

๐Ÿ˜ค Why This Exists

So Ooredoo thinks they can mess with our torrents, huh? They think throttling our bandwidth and blocking our downloads is acceptable? NOT TODAY.

This isn't just a torrent client. This is a middle finger wrapped in encryption, delivered through Tor, straight to Ooredoo's DPI systems.

PyPI version Fuck Throttling Fuck DPI Made With Spite


image

๐Ÿ”ฅ What Makes This Special?

It Says "Screw You" to Ooredoo in 7 Different Ways:

  1. ๐Ÿง… Tor Routing - All your traffic goes through Tor. Ooredoo can't see anything.
  2. ๐Ÿ”’ RC4/MSE Encryption - Every single packet is encrypted. Good luck reading that.
  3. ๐ŸŽญ Traffic Obfuscation - Your torrent traffic looks like HTTPS. Their pattern recognition is useless.
  4. ๐ŸŽฒ Random Ports - Different port every time. No more port blocking.
  5. ๐Ÿ•ต๏ธ DHT Obfuscation - Even peer discovery is encrypted. Can't block what you can't see.
  6. โšก uTP Protocol - Extra layer of protection against DPI.
  7. ๐ŸŽช Traffic Randomization - Makes your torrent traffic look completely innocent.

The Result?

Ooredoo's throttling system becomes completely ineffective. Period.


๐ŸŽฏ The Features

๐Ÿ–• Anti-Throttling Arsenal

  • Tor Network Routing: Because screw Ooredoo's packet inspection
  • Forced Encryption: RC4/MSE on EVERY connection - no exceptions
  • DPI Bypass: Deep Packet Inspection? More like Deep Packet BYPASS
  • DHT Through Tor: Even finding peers is anonymous and encrypted
  • Smart Speed Optimization: 2000+ peer connections, 10MB/s upload for better ratios
  • Ultra-Aggressive Settings: We're not here to play nice

๐ŸŽจ User Experience (Because We're Not Total Savages)

  • Modern Dark UI: CustomTkinter because we have standards (unlike Ooredoo)
  • Real-time Stats: Watch as your torrents fly past Ooredoo's throttling attempts
  • Tor Status Indicator: Green checkmark = Ooredoo is crying
  • Magnet Link Support: Copy, paste, watch Ooredoo fail
  • Multi-torrent Management: Download all the things while Ooredoo watches helplessly
  • Cross-Platform: Windows, Linux, macOS - fuck Ooredoo everywhere

๐Ÿ’€ Requirements

  • Python 3.8+ - To run the code
  • Tor - To flip off Ooredoo properly
  • Internet - Even throttled Ooredoo internet works (barely)
  • Attitude - You should be at least 60% angry at ISP throttling

Uploading image.pngโ€ฆ

๐Ÿš€ Installation (Let's Go)

Step 1: Install Tor (Your New Best Friend)

Ubuntu/Debian:

sudo apt update && sudo apt install tor
sudo systemctl start tor
# Watch Ooredoo's throttling become useless

Fedora:

sudo dnf install tor
sudo systemctl start tor

Arch:

sudo pacman -S tor
sudo systemctl start tor

macOS:

brew install tor
brew services start tor

Windows:

Step 2: Install This Badass Tool

Option A: APT Install (Ubuntu/Debian - Recommended) ๐ŸŽฏ

The easiest way to install - includes all dependencies automatically:

# Add the PPA repository
sudo add-apt-repository ppa:azizbahloul/fuckooredoo
sudo apt-get update

# Install (includes Tor and all dependencies)
sudo apt-get install fuckooredoo

# Done! Launch it:
fuckooredoo

Why use APT?

  • โœ… Automatic dependency installation (including Tor)
  • โœ… Tor service auto-configured and started
  • โœ… System-wide installation
  • โœ… Easy updates with apt upgrade
  • โœ… Man page included: man fuckooredoo
  • โœ… Desktop integration

Option B: PyPI Install (All Platforms)

pip install fuckooredoo

Note: If using PyPI, you must manually install and start Tor (see Step 1).

Option C: Direct .deb (no PPA needed)

If the Launchpad PPA is unavailable or you prefer a direct install, you can install the provided Debian package (.deb) or build one locally from this repository.

  • Install a downloaded .deb (for example, from the project's GitHub Releases):
# from the folder where you downloaded the file
sudo dpkg -i fuckooredoo_1.0.4-2_all.deb
sudo apt-get install -f    # fix and install any missing dependencies
  • Build and install locally (use this if you changed code or want the latest from source):
# from the project root (/home/you/F_ooredoo)
./build_deb.sh
sudo dpkg -i ../fuckooredoo_*.deb
sudo apt-get install -f

This creates a system package with desktop integration, a man page, and automatic service handling.

Tip: if you don't want a system package, pip install . (from the repo root) will install the Python package into your environment, but you'll need to manage Tor and desktop integration yourself.

Download .deb (clickable link)

You can download the latest .deb from the project's GitHub Releases page. Click the link below to open the Releases page and grab the most recent .deb asset for your system:

Download the latest .deb from Releases

If you prefer a direct asset link and know the exact release/tag and filename, the URL format is:

https://github.com/AzizBahloul/F_ooredoo/releases/download/<tag>/<filename>.deb

Example:

https://github.com/AzizBahloul/F_ooredoo/releases/download/v1.0.4/fuckooredoo_1.0.4-2_all.deb

Step 3: Launch and Watch Magic Happen

fuckooredoo

What happens next:

  • โœ… Checks if Tor is ready to go
  • โœ… Verifies Ooredoo can't see your traffic
  • โœ… Launches the most effective anti-throttling tool ever created
  • โœ… Routes EVERYTHING through Tor with military-grade encryption

image

๐ŸŽฎ How to Use This Beast

Basic Mode (For Beginners)

  1. Start the app:

    fuckooredoo
    
  2. Add a magnet link:

    • Copy any magnet link (the ones Ooredoo hates)
    • Paste it in the input field
    • Click "โฌ‡ Download"
    • Watch Ooredoo's throttling fail miserably
  3. Or use a .torrent file:

    • Click "๐Ÿ“ Browse .torrent"
    • Select your file
    • Watch the magic

Headless Mode (For Servers and Extra Badassery)

# Basic headless mode
fuckooredoo --headless

# With magnet link
fuckooredoo --headless --magnet "magnet:?xt=urn:btih:..."

Managing Downloads

  • โธ Pause: When you need a break from watching Ooredoo fail
  • โ–ถ Resume: To resume watching Ooredoo fail
  • ๐Ÿ—‘ Remove: Clean up completed downloads
  • ๐Ÿ“‚ Change Path: Store your files wherever you want

๐Ÿ›ก๏ธ How We Beat Ooredoo's Throttling

The Technical Details

  1. Step 1: Tor Routing

    • Every single bit goes through Tor (port 9050)
    • Ooredoo sees: ????????
    • Actual traffic: YOUR TORRENTS AT FULL SPEED
  2. Step 2: RC4/MSE Encryption

    • All BitTorrent traffic is encrypted with RC4
    • Ooredoo's DPI: confused screaming
    • Your downloads: MAXIMUM SPEED
  3. Step 3: Traffic Obfuscation

    • Makes torrent traffic look like normal HTTPS
    • Ooredoo: "Is this... Netflix?"
    • You: "Sure, let's go with that ๐Ÿ˜"
  4. Step 4: Random Everything

    • Random ports every session
    • Random timing patterns
    • Random packet sizes
    • Ooredoo's pattern detection: COMPLETELY DEFEATED

Why This Works

Because Ooredoo's throttling is:

  • โŒ Lazy and predictable
  • โŒ Based on obvious patterns
  • โŒ Vulnerable to basic encryption
  • โŒ No match for Tor + Encryption combo
  • โŒ Basically useless against this tool

๐ŸŽช The Stats (Prepare to Be Impressed)

Before F_ooredoo:

  • Download speed: 50 KB/s (thanks Ooredoo... NOT)
  • Upload speed: lol what upload?
  • Peers: 5 (Ooredoo blocked the rest)
  • Your mood: ๐Ÿ˜ 

After F_ooredoo:

  • Download speed: AS FAST AS YOUR ACTUAL CONNECTION
  • Upload speed: HELPING THE COMMUNITY
  • Peers: 200+ concurrent connections
  • Your mood: ๐Ÿ˜Ž๐Ÿ–•

๐Ÿ’ก Pro Tips (From One Rebel to Another)

Optimization

  1. Keep Tor Running 24/7

    • Tor is your shield against Ooredoo's bullshit
    • The app shows a green checkmark when Tor is active
    • If Tor stops, restart it ASAP
  2. Choose Popular Torrents

    • More peers = faster downloads
    • Even with encryption, popular = better
  3. Seed After Downloading

    • Don't be a leech
    • Sharing is caring
    • Plus it pisses off Ooredoo even more
  4. Firewall Configuration

    • Allow the app through your firewall
    • Or just disable Windows Firewall (we're rebels, remember?)

Troubleshooting

"Tor is not running"

# Fix that shit
sudo systemctl start tor  # Linux
brew services start tor    # macOS
# Windows: Just run Tor Browser

"Still slow"

  • Check if Tor is ACTUALLY running (green checkmark)
  • Try a more popular torrent
  • Restart Tor: sudo systemctl restart tor
  • Blame Ooredoo's poor infrastructure

"No module named 'tkinter'"

# Linux
sudo apt install python3-tk

# macOS  
brew install python-tk

# Windows
Reinstall Python from python.org and CHECK THE TCL/TK BOX

โš ๏ธ Legal Disclaimer

IMPORTANT:

This tool is designed to bypass UNJUST and ANTI-CONSUMER ISP throttling on LEGAL torrent traffic.

What This Tool Is For:

  • โœ… Downloading Linux ISOs faster
  • โœ… Torrenting open-source software
  • โœ… Getting around unfair ISP throttling
  • โœ… Exercising your right to privacy
  • โœ… Fighting back against ISP overreach (legally)

What This Tool Is NOT For:

  • โŒ Piracy (don't be that person)
  • โŒ Illegal downloads (seriously, don't)
  • โŒ Copyright infringement (we're rebels, not criminals)

Real Talk:

  • Use this responsibly
  • Only download legal content
  • Respect copyright laws in your country
  • We're fighting against ISP overreach, not breaking laws
  • The developers are not responsible if you misuse this

Remember: We're here to fight UNFAIR THROTTLING, not promote piracy. Ooredoo's throttling is wrong, but that doesn't justify piracy.


๐ŸŽ“ How Ooredoo's Throttling Works (And Why It Fails)

Their "Strategy"

  1. Deep Packet Inspection (DPI)

    • Looks at your traffic patterns
    • Identifies BitTorrent-like behavior
    • Our Solution: We encrypt everything, they see nothing
  2. Port Blocking

    • Blocks common BitTorrent ports (6881-6889)
    • Our Solution: We use random ports every time
  3. Protocol Detection

    • Tries to identify BitTorrent protocol
    • Our Solution: Everything looks like HTTPS through Tor
  4. Speed Limiting

    • Slows down "suspicious" traffic
    • Our Solution: Our traffic isn't suspicious, it's encrypted

Why This Tool Destroys Their System

Ooredoo's DPI: "Is this BitTorrent?"
Our Encrypted Traffic: "ยฏ\_(ใƒ„)_/ยฏ"
Ooredoo: "I... I don't know what to do"
Your Downloads: *GOING AT FULL SPEED*

๐Ÿ”ฎ Future Plans (Even Better Anti-Throttling)

  • Multiple proxy support (Tor + I2P + others)
  • Bandwidth scheduling (download at night, seed during day)
  • RSS feed automation (set it and forget it)
  • Even more aggressive anti-throttling
  • Mobile app (beat throttling on your phone too)
  • Built-in VPN support (triple encryption)
  • Statistics page showing bandwidth saved

๐Ÿค Contributing

Want to help make ISP throttling even less effective? Contributions welcome!

Areas where you can help:

  • More anti-throttling techniques
  • Better obfuscation methods
  • Performance optimization
  • Cross-platform improvements
  • Documentation improvements
  • Testing on different ISPs

๐Ÿ† Hall of Fame

People Who Fight ISP Throttling:

  • Mohamed Aziz Bahloul (creator ๐ŸŽ‰)
  • You (once you use this tool)
  • Everyone who's tired of ISP overreach

๐Ÿ“ฑ Connect

Author: Mohamed Aziz Bahloul
GitHub: @AzizBahloul
Project: F_ooredoo
Email: azizbahloul3@gmail.com

Found a bug? Report it
Have a feature idea? Suggest it
Want to say thanks? โญ the repo
Want to really say thanks? Contribute code


๐Ÿ“œ License

MIT License - Because Freedom

Copyright (c) 2025 Mohamed Aziz Bahloul

Translation: Do whatever you want with this code, just don't sue me.


๐ŸŽ‰ Final Words

To Ooredoo: This is what happens when you mess with developers.

To Users: Download responsibly, seed generously, and never let ISPs control you.

To Everyone Else: Share this tool. Let's make ISP throttling a thing of the past.


Made with ๐Ÿ˜  Determination, ๐Ÿ’ป Code, and ๐Ÿ–• Rebellious Spirit

Remember: We're not just downloading torrents. We're fighting for digital freedom, one encrypted packet at a time.

Now go forth and download at full speed, you beautiful rebel. ๐Ÿš€


๐ŸŽธ Easter Eggs

If you read this far, you're a real one. Here's a secret:

# The nuclear option (maximum fuck you to Ooredoo)
export TORRENT_PEERS=9999
export UPLOAD_SPEED=unlimited
fuckooredoo --headless --aggressive-mode

(Note: aggressive-mode doesn't actually exist, but wouldn't that be cool?)


P.S. If you work for Ooredoo and you're reading this: Fix your throttling. Stop limiting legal traffic. Do better.

P.P.S. If you're a user: Enjoy your full-speed downloads! You deserve it! ๐ŸŽŠ

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

fuckooredoo-1.1.1.tar.gz (39.3 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

fuckooredoo-1.1.1-py3-none-any.whl (35.0 kB view details)

Uploaded Python 3

File details

Details for the file fuckooredoo-1.1.1.tar.gz.

File metadata

  • Download URL: fuckooredoo-1.1.1.tar.gz
  • Upload date:
  • Size: 39.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for fuckooredoo-1.1.1.tar.gz
Algorithm Hash digest
SHA256 9011cb4734c7ddb24f16b92803d4565c5d6e346ebfc196dae232e9c4db254b68
MD5 1cfbecc8a6e1bf62f7d76cdbd7d5bc7d
BLAKE2b-256 c8a5cc15108899b1d79ccc38f6fc461caf71ae45279ef45c99e9881d2c0be2d8

See more details on using hashes here.

File details

Details for the file fuckooredoo-1.1.1-py3-none-any.whl.

File metadata

  • Download URL: fuckooredoo-1.1.1-py3-none-any.whl
  • Upload date:
  • Size: 35.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.3

File hashes

Hashes for fuckooredoo-1.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 154c3ac75709b324c21e4d8a364a21c1423c299251a38c8b935ac9bdddb16c36
MD5 0c2f43a150e9322c004c09abbb285e9a
BLAKE2b-256 d8f6446fa86899d8366987656366bd3c3cedfc87805ee6622515793a6c630e73

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page