grizzly-music-archive
Aplicación web auto-alojada para catalogar colecciones de vinilo, CD y casete. Utiliza PHP 8.1 y MySQL 8 con Docker. Incluye player HTML5 y recuperación automática de metadatos vía MusicBrainz. Requiere protección externa por falta de autenticación nativa.
Ficha actualizada 27 sept 2026, 21:11 · upstream 27 sept 2026, 20:53 · release v0.3.0
Qué es grizzly-music-archive
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Grizzly Music Archive es una herramienta para gestionar colecciones físicas de música. Permite CRUD completo de álbumes, artistas y etiquetas. Soporta recuperación automática de portadas y listas de canciones desde MusicBrainz, Last.fm o Discogs. Incluye un reproductor HTML5 persistente para archivos MP3/FLAC subidos localmente.
La arquitectura es ligera: PHP 8.1, MySQL 8, Bootstrap 5 y JavaScript puro sin frameworks pesados. El despliegue se realiza mediante Docker Compose con una imagen de Apache + PHP y un contenedor de MySQL. Se configura el escaneo automático de carpetas locales para indexar archivos sin copiarlos (index-in-place). La aplicación soporta modo oscuro, listas de reproducción con reordenamiento por arrastrar y soltar, y estadísticas en el panel de control.
**Advertencia de seguridad:** El software no incluye autenticación interna. Cualquier usuario que acceda a la URL tiene permisos de lectura/escritura total. Es obligatorio proteger la instancia mediante un proxy inverso (Nginx), listas de IP, VPN o autenticación básica en el nivel de red antes de exponerla públicamente.
- Gestión y visualización de colecciones personales de vinilo, CD y casete
- Reproducción local de archivos MP3/FLAC subidos directamente desde la biblioteca
- Recuperación automática de metadatos y portadas mediante MusicBrainz
- Creación y gestión de listas de reproducción con reordenamiento visual
- Integración opcional con YouTube para previsualización de videos de pistas
- Estadísticas de colección y recomendaciones basadas en el catálogo existente
- Arquitectura ligera: PHP 8.1, MySQL 8, Bootstrap 5 y JavaScript puro (Vanilla JS)
- Indexado in-place: archivos de audio se mantienen en la carpeta fuente sin copiarlos
- Recuperación automática de metadatos desde MusicBrainz sin necesidad de claves API
- Soporte nativo para modo oscuro y diseño responsive con Bootstrap 5
- Integración con YouTube Data API v3 para búsqueda y previsualización de videos
- Escaneo automático de carpetas locales para importar álbumes en segundo plano
- No incluye autenticación integrada; requiere protección externa a nivel de proxy o red
- Dependencia de APIs externas (MusicBrainz, Last.fm, Discogs) para metadatos automáticos
- YouTube puede fallar al incrustar videos si se accede directamente por IP privada sin hostname local
- Requiere PHP 8.1+ y MySQL 8.0+ o MariaDB 10.6+ para funcionar correctamente
- La recuperación de metadatos depende de la disponibilidad de las bases de datos externas
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Despliegue con Docker Compose. Copiar .env.example a .env y configurar BASE_URL, APP_PORT y ALLOWED_HOSTS. Ejecutar docker compose up -d --build. Proteger la instancia sin autenticación nativa mediante proxy inverso o firewall. Para escaneo automático, configurar la ruta absoluta en la interfaz de configuración (Settings). Logs del worker: docker compose logs -f worker.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.