Files
iptv-app/README.md
Renato97 89b7e45a2d docs: update README with bilingual documentation
- Add English and Spanish sections
- Improve project description and features
- Add professional formatting
2026-03-31 01:32:50 -03:00

82 lines
2.4 KiB
Markdown

# 📺 IPTV App - Modern Android Streaming
## 📝 Description / Descripción
**English:**
A Kotlin-based Android IPTV application with Material Design 3 UI. Supports live TV streaming, catch-up TV, VOD content, and user authentication. Built with modern Android architecture components.
**Español:**
Una aplicación Android IPTV basada en Kotlin con interfaz Material Design 3. Soporta streaming de TV en vivo, TV en diferido (catch-up), contenido VOD y autenticación de usuarios. Construida con componentes modernos de arquitectura Android.
## 🚀 Features / Características
**English:**
- Live TV streaming with EPG (Electronic Program Guide)
- Catch-up TV (replay past broadcasts)
- Video-on-demand (VOD) library
- User authentication system
- Favorites and recently watched
- Picture-in-Picture mode
- Material Design 3 UI
- ExoPlayer for smooth video playback
- Chromecast support (coming soon)
**Español:**
- Streaming de TV en vivo con EPG (Guía Electrónica de Programas)
- TV en diferido (repetición de transmisiones pasadas)
- Biblioteca de Video bajo demanda (VOD)
- Sistema de autenticación de usuarios
- Favoritos y vistos recientemente
- Modo Picture-in-Picture
- Interfaz Material Design 3
- ExoPlayer para reproducción de video fluida
- Soporte Chromecast (próximamente)
## 🛠️ Tech Stack / Stack Tecnológico
- **Language:** Kotlin
- **Platform:** Android (API 24+)
- **Architecture:** MVVM + Clean Architecture
- **UI:** Jetpack Compose / XML with Material Design 3
- **Video Player:** ExoPlayer
- **Networking:** Retrofit + OkHttp
- **Dependency Injection:** Hilt
- **Database:** Room
## 📱 Screenshots / Capturas de Pantalla
*Coming soon / Próximamente*
## 🔧 Installation / Instalación
**English:**
1. Download APK from releases
2. Install on Android device (Android 7.0+ required)
3. Enter your IPTV provider credentials
4. Enjoy streaming!
**Español:**
1. Descarga el APK de releases
2. Instala en dispositivo Android (requiere Android 7.0+)
3. Ingresa tus credenciales de proveedor IPTV
4. ¡Disfruta del streaming!
## 🌐 API Integration / Integración API
- RESTful API for content retrieval
- JWT authentication
- Real-time EPG updates
## 👨‍💻 Author / Autor
**Renato CBC**
- GitHub: [renato97](https://gitea.cbcren.online/renato97)
## 📄 License / Licencia
Private project / Proyecto privado
---
**Tags / Etiquetas:** `kotlin` `android` `iptv` `streaming` `exoPlayer` `material-design`