# 📺 XStream IPTV Player

![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)
![Platform](https://img.shields.io/badge/platform-Android-green.svg)
![Flutter](https://img.shields.io/badge/Flutter-3.11+-blue.svg)

Aplicación IPTV para Android TV y dispositivos móviles con soporte para playlists Xtream Codes.

## ✨ Características

- 📡 **TV en Vivo** - Canales de televisión en tiempo real
- 🎬 **Películas** - Catálogo VOD completo
- 📺 **Series** - Contenido serializado con episodios
- 🌍 **Filtro por Países** - Organización inteligente por región:
  - 🇦🇷 Argentina (primero)
  - 🇵🇪 Perú (segundo)
  - ⚽ Fútbol Argentino (categoría especial)
  - 🌎 Sudamérica
  - 🌍 Europa
  - 🌏 Asia/África
- 🔍 **Búsqueda** - Busca canales por nombre
- 📱 **Diseño Android TV** - Optimizado para controles remotos
- 🌙 **Tema Oscuro** - Interfaz moderna y elegante

## 🚀 Instalación

### Descargar APK

Ve a la sección [Releases](https://gitea.cbcren.online/renato97/iptv-ren/releases) y descarga la última versión:

- `app-release.apk` - Versión optimizada (recomendada)
- `app-debug.apk` - Versión de desarrollo

### Instalación Manual

```bash
adb install app-release.apk
```

O instala directamente desde el dispositivo Android.

## 📋 Requisitos

- Android 5.0 (API 21) o superior
- Conexión a Internet
- Credenciales Xtream Codes válidas

## 🔧 Configuración

La aplicación viene con credenciales pre-configuradas:

- **Servidor:** `http://kenmhzxn.fqvpnw.com`
- **Usuario:** `55UDKCFH`
- **Contraseña:** `6ZNP8Y81`

O puedes usar tus propias credenciales Xtream Codes.

## 🎮 Uso

1. **Inicio:** La app carga automáticamente los canales
2. **Navegación:** Usa el control remoto o pantalla táctil
3. **Filtros:** Selecciona países desde el sidebar izquierdo
4. **Búsqueda:** Escribe en la barra superior
5. **Fútbol:** Accede a "Fútbol Argentino" para ver deportes

## 🏗️ Construcción desde Código

### Requisitos de Desarrollo

- Flutter SDK 3.11+
- Android SDK
- JDK 17+

### Construir

```bash
# Obtener dependencias
flutter pub get

# Construir APK de release
flutter build apk --release

# Construir APK de debug
flutter build apk --debug
```

## 📂 Estructura del Proyecto

```
lib/
├── main.dart                 # Punto de entrada
├── models/
│   └── xtream_models.dart    # Modelos de datos
├── screens/
│   ├── home_screen.dart      # Pantalla principal
│   ├── player_screen.dart    # Reproductor de video
│   └── login_screen.dart     # Pantalla de login
├── services/
│   ├── xtream_api.dart       # API Xtream
│   └── iptv_provider.dart    # Gestión de estado
└── widgets/
    ├── countries_sidebar.dart    # Sidebar de países
    └── simple_countries_sidebar.dart
```

## 🤝 Contribuciones

Las contribuciones son bienvenidas. Por favor:

1. Fork el repositorio
2. Crea una rama (`git checkout -b feature/nueva-caracteristica`)
3. Commit tus cambios (`git commit -am 'Agrega nueva característica'`)
4. Push a la rama (`git push origin feature/nueva-caracteristica`)
5. Abre un Pull Request

## 📝 Licencia

Este proyecto es de código abierto. Uso personal permitido.

## 🙏 Agradecimientos

- Flutter Team por el increíble framework
- Xtream Codes por la API
- Comunidad IPTV por el soporte

---

**Desarrollado con ❤️ por Renato**

*Última actualización: Febrero 2026*