renato97
8c7bbc5f2d
## Screens ### home_screen.dart - Removed unused imports (flutter/services) - Removed unused _focusedIndex state variable - Simplified responsive layout logic: - Removed _isMediumScreen, _gridCrossAxisCount getters - Removed _titleFontSize, _iconSize getters - Kept only _headerPadding for responsive padding - Improved navigation with mounted checks - Better MaterialPageRoute formatting - Enhanced _downloadPlaylistAsJson method ## Services ### xtream_api.dart - Added http.Client dependency injection for testability - Implemented _countryExtractionCache for performance - Added regex patterns for country code extraction: - _leadingCodeRegex for "AR - Channel" format - _bracketCodeRegex for "[AR] Channel" format - Enhanced football channel detection patterns - Improved error handling and messages - Better formatted country mapping with regions ### iptv_provider.dart - Better state management separation - Optimized stream filtering for large lists - Refactored country filtering methods - Enhanced playlist download and caching logic - Improved memory management ## Widgets ### countries_sidebar.dart - Better responsive design for TV screens - Enhanced FocusableActionDetector implementation - Improved focus indicators for Android TV - Smoother transitions between selections ### simple_countries_sidebar.dart - Cleaner, more maintainable code structure - Better keyboard/remote navigation support - Improved visual feedback and styling ## Player ### player_screen.dart - Better error handling for playback failures - Enhanced responsive layout - Improved Android TV control visibility - Better buffer management and loading indicators ## Tests ### widget_test.dart - Updated to match new widget signatures - Improved test coverage for refactored components ## Technical Improvements - Better separation of concerns across all layers - Dependency injection patterns for testability - Performance optimizations with caching - Consistent code formatting and documentation - Removed unused code and imports - Enhanced Android TV support with FocusableActionDetector ## Statistics - 8 files changed - +1300 insertions - -1139 deletions - Net: +161 lines of cleaner code ## Breaking Changes None - all internal refactorings with no API changes
📺 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
- Inicio: La app carga automáticamente los canales
- Navegación: Usa el control remoto o pantalla táctil
- Filtros: Selecciona países desde el sidebar izquierdo
- Búsqueda: Escribe en la barra superior
- 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:
- Fork el repositorio
- Crea una rama (
git checkout -b feature/nueva-caracteristica) - Commit tus cambios (
git commit -am 'Agrega nueva característica') - Push a la rama (
git push origin feature/nueva-caracteristica) - 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