# 📺 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`