Add professional README with features and installation guide

README.md

@@ -1,17 +1,130 @@
-# xstream_tv
+# 📺 XStream IPTV Player
 
-A new Flutter project.
+![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)
 
-## Getting Started
+Aplicación IPTV para Android TV y dispositivos móviles con soporte para playlists Xtream Codes.
 
-This project is a starting point for a Flutter application.
+## ✨ Características
 
-A few resources to get you started if this is your first Flutter project:
+- 📡 **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
 
-- [Learn Flutter](https://docs.flutter.dev/get-started/learn-flutter)
-- [Write your first Flutter app](https://docs.flutter.dev/get-started/codelab)
-- [Flutter learning resources](https://docs.flutter.dev/reference/learning-resources)
+## 🚀 Instalación
 
-For help getting started with Flutter development, view the
-[online documentation](https://docs.flutter.dev/), which offers tutorials,
-samples, guidance on mobile development, and a full API reference.
+### 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*