FireVision IPTV
April 6, 2026 · View on GitHub
-green){kind=icon}
Open-source IPTV player for Amazon Fire TV and Android TV. Stream live channels with server-synced lists, category browsing, favorites, and background health scanning.
Works standalone with any M3U source, or pairs with FireVision IPTV Server for full channel management, EPG, and OTA updates.
Preview
Features
- Live Streaming — HLS playback via Media3 ExoPlayer with position save and resume
- Server Sync — Channel lists, favorites, and health status synced from FireVision IPTV Server
- Smart Browsing — Browse by category and language, full-text search with history
- Health Scanning — Background channel health checks with online/offline indicators
- Device Pairing — PIN-based pairing with QR code — links to your self-hosted server
- In-App Updates — OTA updates with APK download and install prompt
- TV Optimized — D-pad navigation built with Jetpack Compose for TV, no touch required
Download
Get the latest APK from GitHub Releases.
Install on Fire TV:
- Enable Apps from Unknown Sources in Fire TV Settings → My Fire TV → Developer Options
- Install Downloader by AFTVnews from the Amazon Appstore
- Enter the APK URL from the latest release and install
Getting Started
Standalone (M3U only)
- Install the APK on your Fire TV or Android TV device
- Open Settings → Add Source → enter your M3U playlist URL
- Browse and stream channels
With FireVision IPTV Server
- Install the APK
- Open Settings → Server Pairing
- Scan the QR code from the admin panel, or enter the PIN manually
- Channel list, favorites, and EPG sync automatically
See the TV Pairing System docs for the full pairing flow.
Tech Stack
| Language | Kotlin |
| UI | Jetpack Compose for TV |
| Architecture | Clean Architecture + MVVM |
| DI | Hilt |
| Database | Room |
| Networking | Retrofit + OkHttp |
| Player | Media3 ExoPlayer (HLS) |
| Background | WorkManager |
| Min SDK | 28 (Android 9) |
Backend
This app is designed to pair with FireVision IPTV Server — a self-hosted Node.js/Docker server for managing channels, users, EPG, and devices from an admin panel.
Documentation
| Doc | Description |
|---|---|
| Architecture | Layers, data flow, dependency graph |
| Data Layer | Database, DAOs, repositories, API |
| Domain Layer | Use cases, models, interfaces |
| Presentation Layer | Screens, ViewModels, navigation |
| API Reference | Endpoints, schemas, contracts |
| Setup Guide | Dev environment and build instructions |
Contributing
Issues and PRs are welcome. See the Setup Guide to get the dev environment running.
License
Disclaimer
This application streams IPTV content from sources you configure. Ensure you have the right to access any streams you use and comply with applicable laws in your jurisdiction.