# 🧲 Magnet2Direct - The Movie Lover's Best Friend

> *"Because life's too short to wait for seeders, and too long to watch ads on streaming sites!"* 🍿

## 🚀 **Live Demo**

**🌐 Try it now:** [https://seedr.eu.org](https://seedr.eu.org)

*No installation needed - just paste your magnet link and enjoy!* ✨

## 🎥 **How It Works (Video Demo)**

Watch the magic happen in less than 30 seconds! 🪄

https://github.com/user-attachments/assets/5d16b145-1ddd-41ef-a0dd-04fca95fc232

*See how simple it is? From magnet link to download in just a few clicks!* 🎬

## 🎬 Why This Exists (A Love Letter to Movies)

Once upon a time, there was a developer who **ABSOLUTELY LOVED** watching movies. We're talking the kind of love where you have a watchlist longer than the Marvel timeline, and you've seen every single "The Fast and The Furious" movie (yes, even the weird Tokyo Drift one). 

But there was a problem... 😩

**The Seedr.cc Struggle Was REAL:**
- **Login. Every. Single. Time.** 🔐 (Because apparently browsers forget passwords faster than I forget movie plots)
- **Click magnet link** ➡️ **Wait for upload** ⏳ **Go to Seedr** 🌐 **Login AGAIN** 🤦‍♂️
- **Navigate through folders** like you're solving a puzzle 📁➡️📁➡️📁
- **Find the actual movie file** among 47 subtitle files and random NFO documents 🔍
- **Right-click download** the ONE file you actually want 📥
- **Delete everything** to free up space for the next movie 🗑️
- **Repeat this nightmare** for EVERY. SINGLE. MOVIE. 🔄

**The Breaking Point:**
One day, after the 847th time of logging into Seedr, clicking through folders, downloading one file, and cleaning up the mess, I had an epiphany: *"There HAS to be a better way!"* 💡

So, armed with nothing but caffeine, determination, and an unhealthy obsession with cinema, **Magnet2Direct** was born! 🚀

**The Dream:** 
*Paste magnet link* ➡️ *Get direct download link* ➡️ *Download movie* ➡️ *Watch and enjoy* 🍿

**No more login marathons, no more folder archaeology, no more manual cleanup!**

## 🎯 What This Beautiful Beast Does

Magnet2Direct is like having a personal movie genie, but instead of three wishes, you get unlimited direct downloads! ✨

### ✅ **The Magic Process:**
1. **Paste any magnet link** (even the sketchy ones from that forum you pretend you don't visit)
2. **Let Seedr do the heavy lifting** (while you make popcorn 🍿)
3. **Get a direct download link** for the biggest video file (because nobody wants the 480p version)
4. **Copy URL or download directly** 
   - **Copy URL**: Use with your favorite download manager (IDM, uTorrent Web, etc.)
   - **Download**: Downloads directly to your browser's default download folder

> **Note:** The app doesn't store files on the server - it just gives you direct links to download from Seedr!

### 🌟 **Epic Features:**
- **🔐 One-Time Setup** - Set your Seedr credentials once and forget about it
- **🚀 Full Automation** - No more manual Seedr navigation or file hunting
- **🧹 Auto-Cleanup** - Automatically deletes files after getting the link (no storage hogging!)
- **🎯 Smart File Detection** - Finds the biggest video file automatically (bye bye subtitle.srt files!)
- **📱 Mobile & Desktop Ready** - Works on everything except your toaster
- **🎨 Beautiful UI** - So pretty, it makes other apps jealous
- **⚡ Real-time Progress** - Watch the magic happen live
- **💾 Browser Storage Only** - Your secrets stay with you
- **🎪 Zero Server Storage** - We're not storing your guilty pleasure movie choices
- **🔄 One-Click Process** - Paste ➡️ Wait ➡️ Download ➡️ Enjoy!

## 🛠️ What's Under the Hood

This masterpiece is crafted with love and the following technologies:

### **🐍 Backend Magic:**
- **Python 3.8+** - Because life's too short for Python 2
- **Flask** - Lightweight and fast, like a ninja
- **[seedrcc](https://github.com/hemantapkh/seedrcc)** - The hero library by [@hemantapkh](https://github.com/hemantapkh) that reverse-engineered Seedr's API 🕵️‍♂️
- **requests** - For when you need to fetch things politely

### **🎨 Frontend Wizardry:**
- **HTML5** - The foundation of dreams
- **CSS3** - Making things pretty since forever
- **JavaScript (ES6+)** - The brain of the operation
- **LocalStorage** - Your browser's secret diary
- **Flexbox & Grid** - For layouts that don't hate mobile users

### **🔧 Development Tools:**
- **VS Code** - The editor that doesn't judge your code
- **Git** - Time travel for developers
- **Chrome DevTools** - Where bugs go to die

## 🚀 Getting Started (It's Easier Than Finding a Good Movie on Netflix)

### **Prerequisites:**
```bash
# You need Python (obviously)
python --version  # Should be 3.8 or higher

# And pip (for installing cool stuff)
pip --version
```

### **Installation (3 Steps to Movie Heaven):**

1. **Clone this beauty:**
```bash
git clone https://github.com/yourusername/magnet2direct.git
cd magnet2direct
```

2. **Install the magic ingredients:**
```bash
pip install flask seedrcc requests
```

3. **Run and enjoy:**
```bash
python simple_magnet2direct.py
```

**🎉 BOOM!** Open `http://localhost:5000` and start converting those magnet links!

## 🌐 **Live Deployment**

The app is deployed on **Vercel** with a custom domain for instant access:
- **🌟 Live App:** [https://seedr.eu.org](https://seedr.eu.org)
- **🚀 Global CDN** - Fast loading worldwide
- **🔒 Automatic HTTPS** - Secure by default
- **⚡ Serverless** - Scales automatically
- **📱 Mobile Optimized** - Works perfectly on all devices

### **🚀 Deploy Your Own:**
```bash
# Fork the repo, then:
npm install -g vercel
vercel login
vercel --prod
# Add your custom domain in Vercel dashboard
```

> **💡 Domain Choice:** The `seedr.eu.org` domain perfectly represents what this tool does - it's all about making Seedr easier to use! Plus, it's short, memorable, and professional. 🎯

## 🎮 How to Use (For Dummies and Smart People Alike)

### **First Time Setup:**
1. Click the **⚙️ Settings** button (it's green and round, you can't miss it)
2. Enter your Seedr email and password (don't worry, we're not storing it)
3. Click **"Save & Test"** (we'll check if it works)
4. Close the modal and feel accomplished ✨

### **Converting Magnet Links:**
1. Find a magnet link (we don't judge your movie choices)
2. Paste it in the big text box
3. Click **"🧲 Get Direct Link"**
4. Watch the progress bar do its thing
5. Copy the URL or download directly
6. Enjoy your movie night! 🍿

## 📁 File Structure (For the Curious)

```
magnet2direct/
├── simple_magnet2direct.py    # The main app (our baby)
├── favicon.ico                # That tiny icon in your browser tab
├── favicon-16x16.png         # For the detail-oriented browsers
├── favicon-32x32.png         # Medium-sized icon perfection
├── apple-touch-icon.png      # Because iOS users deserve nice things
├── site.webmanifest          # PWA magic (we're fancy like that)
├── README.md                 # This beautiful document you're reading
└── requirements.txt          # Dependencies for easy installation
```

## 🎭 Features That Make Us Special

### **🔒 Privacy First:**
- Your Seedr credentials? Stored in YOUR browser only
- No server databases, no data mining, no drama
- What happens in your browser, stays in your browser

### **📱 Responsive Design:**
- Looks amazing on phones, tablets, laptops, and probably smart fridges
- Touch-friendly buttons (fat fingers welcomed)
- No horizontal scrolling nightmares

### **⚡ Smart Features:**
- Auto-detects your account limits (no more "storage full" surprises)
- Finds the biggest video file automatically (because size matters)
- Progress tracking that actually works
- Error handling that doesn't crash and burn

### **🎨 Beautiful UI:**
- Gradients that make your eyes happy
- Animations smoother than a James Bond intro
- Colors that don't assault your retinas
- Typography that doesn't require a magnifying glass

## 🤔 FAQ (Frequently Awesome Questions)

**Q: Is this legal?**
A: We just convert magnet links to direct downloads. What you download is between you and your conscience (and local laws).

**Q: Will this work with [insert random torrent site]?**
A: If it gives you a magnet link, we'll convert it. We're not picky!

**Q: Why Seedr?**
A: Because they're awesome at cloud torrenting, and we're awesome at making UIs. Perfect match!

**Q: Can I use this for downloading Linux ISOs?**
A: Absolutely! We fully support your totally legitimate Linux ISO downloading needs. 😉

**Q: Is there a mobile app?**
A: The web app IS the mobile app! Modern problems require modern solutions.

## 🐛 Known Issues (AKA "It's Not a Bug, It's a Feature")

- Sometimes the progress bar moves too fast (we're working on slowing it down for dramatic effect)
- The app is so addictive, you might forget to actually watch the movies you download
- May cause excessive happiness and productivity
- Side effects include: satisfied users, clean Seedr accounts, and organized download folders

## 🤝 Contributing (Join the Movie Revolution)

### 🆚 **Before vs After Magnet2Direct:**

**😵 The Old Way (Seedr.cc Manual Hell):**
```
1. Copy magnet link
2. Go to seedr.cc
3. Login (again...)
4. Paste magnet link
5. Wait for upload
6. Navigate to files
7. Find the movie in folder maze
8. Right-click download
9. Delete files to free space
10. Repeat for next movie
```
**Total Time:** ~5-10 minutes per movie 😴

**🚀 The Magnet2Direct Way:**
```
1. Paste magnet link
2. Click "Get Direct Link"
3. Copy URL or Download
4. Enjoy your movie!
```
**Total Time:** ~30 seconds ⚡

---

Want to make this even more awesome? We welcome contributions!

1. Fork the repository
2. Create a feature branch (`git checkout -b feature/amazing-new-thing`)
3. Make your changes (and maybe add some movie references)
4. Test everything twice (because bugs are the worst plot twist)
5. Submit a pull request with a detailed description

**Areas we'd love help with:**
- More streaming service integrations
- Better error messages (preferably with movie quotes)
- Performance optimizations
- UI/UX improvements
- Documentation (with more humor, obviously)

## 📜 License

This project is licensed under the **WTFPL (Do What The F*ck You Want To Public License)** - because life's too short for complicated legal jargon! 

**TL;DR:** Do whatever you want with this code. Seriously. We don't care. Use it, abuse it, improve it, break it, sell it, give it away, tattoo it on your forehead - we're cool with whatever! 

The only rule is: **There are no rules!** 🎉

See the LICENSE file for the "official" (but still hilarious) legal text.

## 🙏 Acknowledgments

- **Seedr** - For making cloud torrenting not suck
- **[hemantapkh](https://github.com/hemantapkh)** - The absolute legend who created **[seedrcc](https://github.com/hemantapkh/seedrcc)** 🏆
  
  > *"While Seedr.cc offers a premium API, it is not available to free users. This library was built by studying the network requests from the official Kodi and Chrome extensions."* - hemantapkh
  
  Without this incredible reverse-engineering work, Magnet2Direct wouldn't exist! This guy literally studied network requests like a detective to make the impossible possible. Mad respect! 🕵️‍♂️💻

- **The Flask Team** - For making web development fun again
- **Coffee** - The real MVP of this project
- **Every movie ever made** - For inspiring this creation
- **You** - For reading this far (seriously, you're awesome)

## 📞 Support

Having issues? Found a bug? Just want to chat about movies?

- Create an issue on GitHub
- Send a pull request
- Write a strongly worded email (just kidding, be nice)

---

<div align="center">

**Made with ❤️, ☕, and an unhealthy amount of movie references**

*"May your downloads be fast and your movies be awesome!"* 🎬

**⭐ Star this repo if it made your movie nights better!**

</div>

---

> *P.S. - If this app helped you discover a new favorite movie, we consider our mission accomplished. Now go watch something awesome! 🍿*