Inspirado en el flujo de trabajo de Radarr y Sonarr, Playerr está diseñado para ser la solución definitiva para los entusiastas de los videojuegos que gestionan sus bibliotecas en local. Playerr conecta tus archivos digitales con el mundo del metadato gamer, cerrando la brecha entre tus activos locales y la vasta información disponible en la red.
- Escaneo inteligente de biblioteca: Motor de reconocimiento recursivo e inteligente que identifica plataformas de videojuegos en tu almacenamiento, mapeando archivos locales a sus títulos correspondientes.
- Integración de metadatos robusta: Conexión nativa con IGDB y Steam para obtener imágenes de alta calidad, descripciones, valoraciones y fechas de lanzamiento.
- Flujo PVR automatizado: Soporte para Prowlarr y Jackett para gestión automática de indexadores y búsquedas avanzadas.
- Soporte Protocolo NZB: Integración nativa para descargas Usenet mediante archivos NZB, gestionando automáticamente la asociación de protocolos. Compatible con SABnzbd y NZBGet.
- Conectividad con Clientes de Descarga: Integración nativa mediante API para gestionar transferencias en los estándares de la industria (qBittorrent, Transmission, SABnzbd).
- Interfaz web moderna: GUI visualmente atractiva, oscura y responsiva, diseñada tanto para escritorio como para entornos Docker.
- Gestión automática de rutas y archivos: Renombrado automático de carpetas basado en títulos de IGDB sanitizados, preservando la estructura del lanzamiento original mientras se mantiene la biblioteca limpia y organizada.
- Herramienta de Despliegue Automatizado: Procesa eficientemente paquetes de instalación locales e identifica los ejecutables primarios para optimizar la organización de la biblioteca.
- Vista unificada: Muestra toda tu colección en un solo lugar, incluyendo soporte nativo para sincronización y visualización de tu Biblioteca de Steam.
| Vista de Juego | Detalles del Juego |
|---|---|
 |
 |
| Configuración (Indexers) | Cuadrícula de Biblioteca |
|---|---|
 |
 |
Gestor de Búsqueda
Playerr está diseñado para un alcance máximo, ofreciendo binarios multiplataforma y soluciones en contenedor:
- Docker: Soporte universal para amd64 y arm64 (Raspberry Pi, CasaOS, Synology, etc.).
- Windows: Rendimiento nativo 64-bit. Descargar .exe (Instalador) o Descargar .zip (Portable)
- macOS: Optimizado para Apple Silicon (Descargar .dmg) y sistemas Intel (Descargar .dmg).
- Linux: Distribuciones genéricas 64-bit. Descargar .tar.gz
Playerr gestiona tu biblioteca, pero para ejecutar títulos nativos de Windows en macOS o Linux, recomendamos las siguientes capas de compatibilidad:
- macOS: Whisky (Gratis/Open Source) o CrossOver (Pago/Soporte Oficial).
- Linux / Steam Deck: Soporte nativo vía Proton (Steam), Lutris o Bottles.
Nota: Requiere claves API de IGDB válidas (gratuitas) para la obtención de metadatos.
La forma más sencilla de ejecutar Playerr es con Docker. Incluye todo lo necesario en un solo contenedor. Accede a la interfaz en http://tu-ip:2727.
Crea un archivo docker-compose.yml y ejecuta docker-compose up -d:
services:
playerr:
image: maikboarder/playerr:latest
container_name: playerr
ports:
- "2727:2727"
volumes:
- ./config:/app/config
- /ruta/a/tus/juegos:/media
restart: unless-stopped- Ve a App Store -> Instalación personalizada.
- Haz clic en Importar (arriba a la derecha) y pega este código (incluye el icono):
services: playerr: image: maikboarder/playerr:latest container_name: playerr ports: - "2727:2727" volumes: - /DATA/AppData/playerr/config:/app/config - /DATA/Media/Games:/media restart: unless-stopped x-casaos: architectures: - amd64 - arm64 main: playerr icon: https://raw.githubusercontent.com/Maikboarder/Playerr/master/frontend/src/assets/app_logo.png title: es_es: Playerr
- Haz clic en Instalar.
- Abre Container Manager (o Docker).
- Ve a Proyecto -> Crear.
- Pega el código Docker Compose y configura tus carpetas locales.
- Haz clic en Listo.
Si quieres modificar el código o construir la imagen localmente en lugar de descargarla desde Docker Hub:
-
Clona el repositorio:
git clone https://github.com/maikboarder/playerr.git cd playerr -
Usa el comando de compilación:
docker build -t playerr:local . -
O usa un
docker-compose.override.ymlpara forzar compilación local:services: playerr: build: . image: playerr:local # ... resto de la config
- Funcionalidad PVR Core: Motor de búsqueda y categorización automática.
- Soporte de Protocolo NZB: Integración nativa con SABnzbd y NZBGet.
- Despliegue Multiplataforma: Binarios oficiales para Windows, macOS (Apple e Intel) y Linux.
- Instalador de Windows: Instalador profesional NSIS para una experiencia de configuración fluida.
- Persistencia de Datos: Integración con SQLite para asegurar la longevidad de tu biblioteca y metadatos.
- Optimización de Infraestructura y Almacenamiento:
- Hardlinks (Atomic Move): Gestión instantánea de archivos sin fragmentación de datos.
- Integración con Unraid: Soporte mediante plantilla XML comunitaria (
_unraid/playerr.xml). - Gestión Inteligente de API: Control de límites y procesamiento por lotes para proveedores de metadatos.
- Integración "One-Click Launch": Soporte de ejecución directa para Steam e implementación inicial para Juegos Locales Instalados.
- Refinamiento de UI/UX: Iconografía premium (FontAwesome) y diseño consistente basado en el tema Nord.
- Configuración Avanzada:
- IP/Puerto Personalizado: Configuración de red flexible.
- Soporte System Tray: Minimizar a la bandeja del sistema (Windows).
- Bazzite y Gaming en Linux: Hooks de compatibilidad especializados para Lutris, Proton y Steam Deck.
- Protocolo DBI: Transferencia avanzada de archivos por USB para la gestión de dispositivos de hardware portátiles.
- Tiendas Oficiales: Integración en los catálogos oficiales de aplicaciones de Unraid, CasaOS y Synology.
- Motor de Extensibilidad: Soporte para scripts de la comunidad y plugins de metadatos.
Estoy construyendo Playerr con la comunidad en mente. Tu feedback es el motor que impulsa nuestro desarrollo.
- Contribuye: ¿Encontraste un bug? ¿Tienes una idea brillante? ¡Abre un issue o un PR!
- Soporte: Si Playerr aporta valor a tu setup, considera apoyar el proyecto. Tus contribuciones permiten un desarrollo más enfocado, mejor estabilidad y una implementación más rápida del roadmap.
Distribuido bajo la Licencia MIT. Consulta LICENSE para más información.
Playerr es un proyecto de código abierto para la gestión educativa y personal de bibliotecas. No está afiliado con ninguna plataforma de juegos o proveedor de metadatos de terceros. Los desarrolladores no aprueban la piratería; los usuarios son responsables de cumplir con las leyes locales de derechos de autor. Consulta DISCLAIMER.md para el aviso legal completo.
Desarrollado por Maikboarder