Repolode
Enviar
blackcandy-org

blackcandy-org/blackcandy

Servidor de streaming de música autoalojado para escuchar tu propia biblioteca desde un navegador web o una app móvil.

Alternativa open source a:SpotifyApple Music

Ver en GitHub
Estrellas
4,428
Forks
228
Issues abiertos
31
Último commit
hace 3 días

¿Qué es?

Black Candy es un servidor de streaming de música autoalojado, desarrollado con Ruby on Rails. Solo tienes que indicar una carpeta de archivos multimedia de tu equipo o servidor para que el contenido esté disponible en una interfaz web y en las apps oficiales para iOS y Android.

Está diseñado para instalaciones personales y pequeñas. SQLite es la base de datos predeterminada, así que una configuración básica solo requiere un contenedor Docker, aunque se puede configurar PostgreSQL para instalaciones de mayor tamaño. Los archivos multimedia se leen desde un directorio montado, y los datos, como la configuración y la base de datos, se guardan en una ruta de almacenamiento persistente.

El proyecto ofrece imágenes Docker, una instancia de demostración con música de muestra y un entorno de desarrollo que requiere Ruby, Node.js, libvips y FFmpeg. Las imágenes de artistas y álbumes se pueden obtener mediante la API de Discogs después de introducir un token en la página de configuración.

Funciones clave

  • 01Reproduce música desde una carpeta de archivos multimedia montada en el contenedor.
  • 02Ofrece una interfaz web y apps oficiales para iOS, Android y F-Droid.
  • 03Usa SQLite de forma predeterminada y admite PostgreSQL como alternativa.
  • 04Admite cuentas de administrador y de usuario normal, con un modo de demostración que restringe el acceso de administrador.
  • 05Obtiene imágenes de artistas y álbumes desde la API de Discogs.
  • 06Se ejecuta como un contenedor Docker con almacenamiento persistente y variables de entorno configurables.

Casos de uso

  • Alojar una biblioteca musical personal en un servidor doméstico y escucharla desde cualquier navegador.
  • Montar un servicio privado de streaming de música para la familia o un grupo pequeño.
  • Acceder a tu propia colección desde el teléfono sin depender de un servicio comercial de suscripción.
  • Probar una aplicación Rails autoalojada como referencia para desplegar con Docker.

Inicio rápido

  1. 1

    Ejecuta Black Candy con Docker desde GitHub Container Registry

    docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest
  2. 2

    Abre http://localhost en un navegador e inicia sesión con el usuario administrador inicial

Antes de usarlo

  • La base de datos predeterminada es SQLite; PostgreSQL requiere variables de entorno adicionales y configuración.
  • Debes montar los archivos multimedia en el contenedor para que el servidor pueda acceder a tu biblioteca de música.

En colecciones

Apps autoalojadas

Temas

#music#self-hosted#music-streaming#rails#ruby#docker#media-server#audio#hotwire#music-player

Preguntas frecuentes

¿Qué es blackcandy?
Servidor de streaming de música autoalojado para escuchar tu propia biblioteca desde un navegador web o una app móvil. Black Candy es un servidor de streaming de música autoalojado, desarrollado con Ruby on Rails. Solo tienes que indicar una carpeta de archivos multimedia de tu equipo o servidor para que el contenido esté disponible en una interfaz web y en las apps oficiales para iOS y Android.
¿blackcandy es gratuito? ¿Qué licencia tiene?
blackcandy es open source bajo la licencia MIT. Revisa los términos de la licencia antes de usarlo en productos comerciales.
¿blackcandy sigue mantenido?
Mantenimiento activo. El último commit de blackcandy fue el 21 oct 2026.
¿Para qué puedo usar blackcandy?
Alojar una biblioteca musical personal en un servidor doméstico y escucharla desde cualquier navegador. Montar un servicio privado de streaming de música para la familia o un grupo pequeño. Acceder a tu propia colección desde el teléfono sin depender de un servicio comercial de suscripción. Probar una aplicación Rails autoalojada como referencia para desplegar con Docker.
¿Cómo se instala blackcandy?
Ejecuta Black Candy con Docker desde GitHub Container Registry: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest Abre http://localhost en un navegador e inicia sesión con el usuario administrador inicial
¿Dónde consigo blackcandy?
El código fuente y las instrucciones de instalación están en GitHub: https://github.com/blackcandy-org/blackcandy

Resumen generado por IA a partir del README del proyecto. Las estadísticas de GitHub se actualizan a diario.

Proyectos relacionados