Built as a personal “vibe coded” spare-time project—open-sourced so others can test-drive it or take it further. Most polish currently targets Android; the desktop builds work, but expect the occasional rough edge.

A modern torrent search and Real-Debrid companion built with Flutter, featuring a powerful search UI, lean-back TV mode, advanced player, and persistent playlists.

• ✨ Features
• 🧭 Platform Snapshot
• 🚀 Quick Start
• 📦 Installation Details
• 🛠️ Build & Release Notes
• 📺 Episode Tracking Deep-Dive
• 🧱 Tech Stack
• 🗺️ Roadmap
• 🤝 Contributing
• 💬 Support
• 📄 License

• 🔍 Multi-source torrent search with engine toggles, live counts, and smart sorting
• 🔐 Real-Debrid integration for API validation, file-selection defaults, and account snapshot
• 📥 Smart-ish download manager (still evolving) with queue persistence, pause/resume, and grouped actions
• 📺 Debrify TV mode for lean-back autoplay, keyword queues, and remote-friendly controls
• 🎬 Advanced player powered by media_kit: gestures, audio/subtitle tracks, resume points, and Debrify TV overlays
• 🧠 Episode intelligence via TVMaze enrichment, per-season progress, and resume-last logic
• 🎞️ Personal playlists that recover restricted links, order multi-episode packs, and remember Real-Debrid torrents
• 🎨 Material 3 UI with dark theme, animated navigation, and Android TV aware orientation

⚠️ Heads-up: Desktop builds are convenient ports of the Android flow. Windows, macOS, and web are fully usable but not yet as polished.

• Prefer the easy route? Grab the latest release artifacts (APK / DMG / Windows setup) from the GitHub Releases page.
• Want to tinker? Clone the repo and run flutter run on your target device.

# Sideload the release APK
adb install debrify-<version>.apk

1. Download debrify-<version>-setup.exe
2. Run the installer (expect SmartScreen on first run since it’s self-signed)
3. Launch from Start Menu; downloads land in C:\Users\<you>\Downloads\Debrify

1. Download debrify-<version>.dmg
2. Drag Debrify into Applications
3. First launch may require Control+Open because the app isn’t notarized yet

git clone https://github.com/varunsalian/debrify.git
cd debrify
flutter pub get
flutter run

• flutter build apk --release – local Android release build
• flutter build macos --release – produces build/macos/Build/Products/Release/debrify.app
• flutter build windows --release – generates the runner binaries used by the Inno Setup installer
• GitHub Actions workflow (.github/workflows/build.yml) builds all three artifacts on tagged releases and attaches them automatically.

• ✅ Automatic detection of finished episodes with persistent markers
• 🎯 State restoration for current, last played, and completed content
• 📂 Playlist integration showing progress across different entry points
• 🗂️ Season-aware storage so you can jump between seasons without losing place

Under the hood, progress is stored via StorageService and enriched by EpisodeInfoService (TVMaze).

• Flutter (Material 3, Google Fonts, Animations)
• media_kit / media_kit_video for the player
• background_downloader + custom queue logic for downloads
• Real-Debrid APIs wrapped in DebridService
• Provider for lightweight state management
• window_manager (desktop) for window control

• Polish desktop UX (window chrome, settings panels)
• Expand download manager reliability on Windows/macOS
• Add in-app release notes and update prompts
• Bundle optional analytics/telemetry toggle for debugging
• Improve automated tests and CI coverage

Have ideas? Open an issue or send a PR.

1. Fork the repo
2. Create a branch (git checkout -b feature/amazing-idea)
3. Commit your changes (git commit -am 'feat: add amazing idea')
4. Push (git push origin feature/amazing-idea)
5. Open a pull request 🚀

Tip: Attach screenshots or screen captures when tweaking UI/UX—they help reviewers a ton.

• Found a bug? File an issue
• Questions? Start a discussion or ping via issues
• Want to collaborate? PRs are welcome; please include a short summary + testing notes

Debrify is released under the MIT License.

Current release: 0.1.0 (see pubspec.yaml)