Inspired by the workflow of Radarr and Sonarr, Playerr is designed to be the definitive solution for video game enthusiasts who self-host their libraries. It bridges the gap between your local digital assets and the vast world of gaming metadata.
- Intelligent Library Scanning: Recursive and smart recognition engine that identifies video game platforms across your storage, mapping local files to their respective titles.
- Rich Metadata Integration: Native hooks into IGDB and Steam APIs to fetch high-quality artwork, descriptions, ratings, and release dates.
- Seamless PVR Workflow: Support for Prowlarr and Jackett for automated indexer management and advanced searching.
- NZB Protocol Support: Native integration for Usenet downloads via NZB files, automatically handling protocol associations. Compatible with SABnzbd and NZBGet.
- Download Client Connectivity: Native API integration for managing transfers via industry-standard clients (qBittorrent, Transmission, SABnzbd).
- Modern Web GUI: A vibrant, dark-themed responsive interface designed for both desktop and containerized environments.
- Smart Path & File Management: Automatic folder renaming based on sanitized IGDB titles, preserving original release structure while keeping the library clean and organized.
- Automated Deployment Tool: Efficiently processes local installation packages and identifies primary executables to streamline library organization.
- Unified Library View: Display your entire gaming collection in one place, including native support for syncing and viewing your Steam Library.
| Game View | Game Details |
|---|---|
 |
 |
| Settings (Indexers) | Library Grid |
|---|---|
 |
 |
Search Manager
Playerr is architected for maximum reach, offering multi-platform binaries and containerized solutions:
- Docker: Universal support for amd64 and arm64 (Raspberry Pi, CasaOS, Synology, etc.).
- Windows: Native 64-bit performance. Download .exe (Installer) or Download .zip (Portable)
- macOS: Optimized for Apple Silicon (Download .dmg) and Intel (Download .dmg).
- Linux: Generic 64-bit binary distributions. Download .tar.gz
The easiest way to run Playerr is using Docker. It includes everything you need in a single container. Access the UI at http://your-ip:2727.
Create a docker-compose.yml file and run docker-compose up -d:
services:
playerr:
image: maikboarder/playerr:latest
container_name: playerr
ports:
- "2727:2727"
volumes:
- ./config:/app/config
- /your/games/path:/media
restart: unless-stopped- Go to App Store -> Custom Install.
- Click on Import (top right) and paste this specific code (includes the icon):
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: en_us: Playerr
- Click Install.
- Open Container Manager (or Docker).
- Go to Project -> Create.
- Paste the Docker Compose code and configure your local folders.
- Click Done.
If you want to modify the code or build the image locally instead of pulling it from Docker Hub:
-
Clone the repository:
git clone https://github.com/maikboarder/playerr.git cd playerr -
Use the build command:
docker build -t playerr:local . -
Or use a
docker-compose.override.ymlto force a local build:services: playerr: build: . image: playerr:local # ... rest of your config
- Core PVR Functionality: Automated search and categorization engine.
- NZB Protocol Support: Native integration for SABnzbd and NZBGet.
- Multi-Platform Deployment: Official builds for Windows, macOS (Apple & Intel), and Linux.
- Windows Installer: Professional NSIS installer for a seamless setup experience.
- Persistent Storage: SQLite integration to ensure library data and metadata longevity.
- Infrastructure & Storage Optimization:
- Atomic Move (Hardlinks): Instant file management without data fragmentation.
- Unraid Integration: Community XML template support (
_unraid/playerr.xml). - Smart API Handling: Advanced rate-limiting and batching for metadata providers.
- One-Click Launch Integration: Direct execution support for installed local assets with automated path detection.
- UI/UX Refinement: Premium iconography (FontAwesome) and consistent Nord-themed design.
- Bazzite & Linux Gaming: Specialized compatibility hooks for Lutris, Proton, and Steam Deck.
- DBI Protocol Support: Advanced USB file transfer and management for handheld hardware devices.
- Official App Stores: Integration into official Unraid, CasaOS, and Synology app manifests.
- Extensibility Engine: Support for community-driven scripts and metadata plugins.
I'm building Playerr with the community in mind. Your feedback is the engine that drives our development.
- Contribute: Found a bug? Have a killer feature idea? Open an issue or a PR!
- Support: If Playerr brings value to your setup, consider supporting the project. Your contributions enable more focused development, better stability, and faster implementation of the roadmap.
Distributed under the MIT License. See LICENSE for more information.
Playerr is an open-source project for educational and personal library management. It is not affiliated with any third-party game platforms or metadata providers. The developers do not condone piracy; users are responsible for complying with their local laws regarding copyright and content usage. See DISCLAIMER.md for the full legal notice.
Developed by Maikboarder
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.
- Escaneo inteligente de biblioteca: Reconocimiento recursivo y automático de plataformas de videojuegos en tu almacenamiento, mapeando archivos locales a sus títulos correspondientes.
- Integración de metadatos: Conexión nativa con IGDB y Steam para obtener imágenes, descripciones, valoraciones y fechas de lanzamiento.
- Flujo PVR automatizado: Soporte para Prowlarr y Jackett para gestión avanzada de indexadores y búsquedas.
- 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 oscura, responsiva y pensada para escritorio y contenedores.
- Gestión automática de rutas y archivos: Renombrado inteligente de carpetas basado en títulos de IGDB, preservando la estructura 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 sincronización y visualización de tu biblioteca de Steam.
Playerr está diseñado para máxima compatibilidad, 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
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 y configura tus carpetas locales.
- Haz clic en Listo.
Si quieres modificar el código o construir la imagen localmente:
-
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:
- 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 juegos instalados con detección automática de rutas.
- Refinamiento de UI/UX: Iconografía premium (FontAwesome) y diseño consistente basado en el tema Nord.
- 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