Metadata-Version: 2.4
Name: fuckooredoo
Version: 1.1.1
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
License-File: LICENSE
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
Dynamic: license-file

# F_ooredoo - The Ultimate Anti-Throttling Torrent Client

**Version 1.0.2** by **Mohamed Aziz Bahloul**
<img width="1024" height="1024" alt="image" src="https://github.com/user-attachments/assets/0f27bf18-abe3-4b7d-8dbf-74511f36d2f1" />


## 😤 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](https://img.shields.io/pypi/v/fuckooredoo.svg)](https://pypi.org/project/fuckooredoo/)
[![Fuck Throttling](https://img.shields.io/badge/Fuck-Throttling-red.svg)]()
[![Fuck DPI](https://img.shields.io/badge/Fuck-DPI-orange.svg)]()
[![Made With Spite](https://img.shields.io/badge/Made%20With-Spite-purple.svg)]()

---
<img width="1284" height="793" alt="image" src="https://github.com/user-attachments/assets/7dae48b3-53f5-4f7e-af4a-da748e295497" />


## 🔥 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**:
```bash
sudo apt update && sudo apt install tor
sudo systemctl start tor
# Watch Ooredoo's throttling become useless
```

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

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

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

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

### Step 2: Install This Badass Tool

#### Option A: APT Install (Ubuntu/Debian - Recommended) 🎯

**The easiest way to install - includes all dependencies automatically:**

```bash
# 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)

```bash
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):

```bash
# 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):

```bash
# 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](https://github.com/AzizBahloul/F_ooredoo/releases/latest)

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

```bash
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

---

<img width="640" height="640" alt="image" src="https://github.com/user-attachments/assets/ddeafc0b-62a9-4919-9905-15a31674dbd6" />


## 🎮 How to Use This Beast

### Basic Mode (For Beginners)

1. **Start the app:**
   ```bash
   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)

```bash
# 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"**
```bash
# 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'"**
```bash
# 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](https://github.com/AzizBahloul)  
**Project:** [F_ooredoo](https://github.com/AzizBahloul/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:

```bash
# 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! 🎊
