131 lines
3.4 KiB
Markdown
131 lines
3.4 KiB
Markdown
# 📺 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](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*
|