IPTV / M3U8 player built with Flutter. Watch live TV channels on Android and in the browser with a persistent mini-player experience.
- M3U8 Playlist Support — load and play IPTV streams from M3U8 playlists
- Xtream Codes Support — login with Xtream credentials for Live, VOD, and Series
- IPTV.org Integration — browse country-based playlists (60+ countries)
- Favorites — save channels for quick access from the home screen
- Search — find channels quickly by name
- Group Filtering — filter channels by category or group
- Background Audio — keep listening when the app is in the background (Android)
- Audio Only Mode — play audio only to save battery and data (Android)
- Picture-in-Picture — auto-PiP when leaving the fullscreen player (Android)
- Persistent Mini-Player — navigate the app while watching, tap to expand
- Web Support — watch streams in any browser with CORS proxy fallback
- Material You — dynamic color theming, light and dark mode
- Google-Free — no Google Play Services required, fully FOSS
Some streams may not work in the browser due to CORS restrictions.
Get the latest APK from the Releases page.
| APK | Notes |
|---|---|
tvninja-X.X.X.apk |
Universal — works on any device |
tvninja-X.X.X-arm64-v8a.apk |
Most modern Android phones |
tvninja-X.X.X-armeabi-v7a.apk |
Older 32-bit devices |
tvninja-X.X.X-x86_64.apk |
Emulators |
Add https://github.com/Giuig/tvninja in Obtainium to receive automatic updates. Use the APK filter tvninja-\d to select the universal build.
I make FOSS apps in my free time, a coffee would help me keep them going! ☕
# Prerequisites: Flutter SDK 3.41.5+
flutter pub get
flutter build apk --release --split-per-abi --no-tree-shake-icons --split-debug-info=build/debug-info
flutter build web --base-href=/tvninja/ --release| App | Description |
|---|---|
| auraninja | Ambient sound mixer and focus app |
| decisioninja | Decision maker with dice, pointer, and binary choices |
| ninja_material | Shared Flutter library powering all ninja apps |
This project is licensed under the GNU General Public License v3.0.