blackcandy-org/blackcandy

O que é?

Recursos principais

• 01Faz streaming de músicas de uma pasta de mídia montada no container.
• 02Oferece uma interface web e apps oficiais para iOS, Android e F-Droid.
• 03Usa SQLite por padrão e também oferece suporte ao PostgreSQL.
• 04Oferece contas de administrador e de usuário comum, além de um modo de demonstração que restringe o acesso de administrador.
• 05Busca imagens de artistas e álbuns pela API do Discogs.
• 06É executado em um container Docker com armazenamento persistente e variáveis de ambiente configuráveis.

Casos de uso

• Hospedar uma biblioteca musical pessoal em um servidor doméstico e ouvi-la em qualquer navegador.
• Executar um serviço privado de streaming de música para a família ou um grupo pequeno.
• Acessar sua própria coleção pelo celular sem depender de um serviço comercial por assinatura.
• Experimentar um app Rails self-hosted como referência para implantação com Docker.

Início rápido

1. 1

   Execute o Black Candy com Docker a partir do GitHub Container Registry

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

   Abra http://localhost em um navegador e entre com o usuário administrador inicial

Antes de usar

• !O banco de dados padrão é o SQLite; o PostgreSQL requer variáveis de ambiente adicionais e configuração.
• !É necessário montar os arquivos de mídia no contêiner para que o servidor possa acessar sua biblioteca de música.

Em coleções

Tópicos

Perguntas frequentes

O que é blackcandy?

Um servidor de streaming de música self-hosted que permite ouvir sua própria biblioteca musical pelo navegador ou por um app para celular. O Black Candy é um servidor de streaming de música self-hosted desenvolvido com Ruby on Rails. Basta apontá-lo para uma pasta de mídia na sua máquina ou no servidor para disponibilizar essa biblioteca em uma interface web e nos apps oficiais para iOS e Android.

blackcandy é gratuito? Qual é a licença?

blackcandy é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.

blackcandy ainda é mantido?

Manutenção ativa. O último commit de blackcandy foi em 21 de out. de 2026.

Para que posso usar blackcandy?

Hospedar uma biblioteca musical pessoal em um servidor doméstico e ouvi-la em qualquer navegador. Executar um serviço privado de streaming de música para a família ou um grupo pequeno. Acessar sua própria coleção pelo celular sem depender de um serviço comercial por assinatura. Experimentar um app Rails self-hosted como referência para implantação com Docker.

Como instalar blackcandy?

Execute o Black Candy com Docker a partir do GitHub Container Registry: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest Abra http://localhost em um navegador e entre com o usuário administrador inicial

Onde consigo blackcandy?

O código-fonte e as instruções de instalação estão no GitHub: https://github.com/blackcandy-org/blackcandy