iptv-ren/README.md

📺 XStream IPTV Player

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 y descarga la última versión:

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

Instalación Manual

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

# 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