🎬 Cineflix Stremio Addon

Versión: 16.0.0
Idioma: Español (Latinoamérica/España)

Cineflix es un addon avanzado para Stremio que mejora la experiencia de descubrimiento de contenido. Su característica principal es la generación dinámica de pósters, incrustando las calificaciones de IMDb y Rotten Tomatoes directamente en la imagen, además de ofrecer catálogos curados y subtítulos multi-idioma.

✨ Características

• Pósters Inteligentes: Muestra ratings de IMDb y Rotten Tomatoes, duración y el logo de Cineflix generados al vuelo sobre las carátulas usando sharp.
• Catálogos Extensos:
  • Tendencias diarias y semanales.
  • Colecciones por décadas (Clásicos, 80s, 90s, 2000s).
  • Géneros específicos (Anime, K-Drama, Documentales, etc.).
  • Cine regional (España, Latinoamérica, Francia, Italia, Corea, etc.).
• Metadatos Completos: Sinopsis en español, trailers de YouTube y logos oficiales.
• Subtítulos Híbridos: Combina la API v1 de OpenSubtitles.com con la API Legacy para asegurar la máxima disponibilidad de subtítulos en múltiples idiomas.
• Cache Inteligente: Sistema de caché en memoria para reducir llamadas a las APIs y mejorar la velocidad de respuesta.

🛠️ Requisitos Previos

Para ejecutar este addon, necesitarás las siguientes API Keys:

1. TMDB API Key: (Obligatoria) Para metadatos e imágenes. Conseguir aquí.
2. OMDb API Key: (Opcional pero recomendada) Para obtener ratings de Rotten Tomatoes e IMDb precisos. Conseguir aquí.
3. OpenSubtitles API Key: (Opcional) Para la descarga de subtítulos desde la nueva API. Conseguir aquí.

🚀 Instalación Local

1. Clonar el repositorio:

   git clone https://github.com/TU_USUARIO/cineflix-addon.git
   cd cineflix-addon

2. Instalar dependencias:

   npm install

3. Configurar variables de entorno: Crea un archivo .env en la raíz (o configura las variables en tu sistema):

   TMDB_KEY=tu_api_key_de_tmdb
   OMDB_KEY=tu_api_key_de_omdb
   OPENSUB_KEY=tu_api_key_de_opensubtitles

4. Iniciar el servidor: Dado que el código exporta la app de Express, necesitas un archivo de entrada o usar vercel dev si tienes el CLI de Vercel. Para uso local simple, crea un archivo server.js:

   const app = require('./index'); // Asumiendo que tu archivo principal es index.js
   const port = process.env.PORT || 3000;
   app.listen(port, () => {
       console.log(`Addon corriendo en http://localhost:${port}/manifest.json`);
   });

   Y corre:

   node server.js

☁️ Despliegue en Vercel

Este addon está optimizado para funcionar en entornos Serverless como Vercel.

1. Instala Vercel CLI: npm i -g vercel
2. Ejecuta vercel en la terminal.
3. Configura las variables de entorno en el dashboard de Vercel (Settings -> Environment Variables).

📝 Variables de Entorno

Variable	Descripción	Requerido
TMDB_KEY	API Key de The Movie Database	✅ Sí
OMDB_KEY	API Key de OMDb (Ratings)	⚠️ Opcional
OPENSUB_KEY	API Key de OpenSubtitles.com	⚠️ Opcional

📦 Dependencias Principales

• express: Servidor web.
• axios: Peticiones HTTP.
• sharp: Procesamiento de imágenes (Pósters con badges).
• cors: Manejo de CORS para Stremio.

📄 Licencia

Este proyecto está bajo la licencia MIT.