blackcandy-org/blackcandy

これは何？

主な機能

• 01コンテナにマウントしたメディアフォルダから音楽をストリーミングします。
• 02Webインターフェースに加え、公式iOS・Android・F-Droidアプリを提供します。
• 03デフォルトでSQLiteを使用し、代替としてPostgreSQLをサポートします。
• 04管理者アカウントと一般ユーザーアカウントに対応し、デモモードでは管理者アクセスを制限します。
• 05Discogs APIからアーティストやアルバムの画像を取得します。
• 06永続ストレージと設定可能な環境変数を備えたDockerコンテナとして動作します。

ユースケース

• 自宅のサーバーで個人の音楽ライブラリをホストし、任意のブラウザから聴く。
• 家族や小規模なグループ向けに、プライベートな音楽ストリーミングサービスを運用する。
• 商用サブスクリプションサービスに頼らず、スマートフォンから自分のコレクションにアクセスする。
• Dockerを使ったデプロイの参考として、セルフホスト型のRailsアプリケーションを試す。

クイックスタート

1. 1

   GitHub Container Registry の Docker イメージを使って Black Candy を起動します

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

   ブラウザーで http://localhost を開き、初期管理者ユーザーでログインします

使う前に知っておきたいこと

• !デフォルトのデータベースは SQLite です。PostgreSQL を使うには、追加の環境変数とセットアップが必要です。
• !サーバーから音楽ライブラリにアクセスできるよう、メディアファイルをコンテナにマウントする必要があります。

収録されている特集

トピック

よくある質問

blackcandy とは？

自分の音楽ライブラリをWebブラウザやモバイルアプリから再生できる、セルフホスト型の音楽ストリーミングサーバーです。 Black Candyは、Ruby on Railsで構築されたセルフホスト型の音楽ストリーミングサーバーです。自分のマシンやサーバー上にあるメディアフォルダを指定すると、そのライブラリをWebインターフェースと公式iOS・Androidアプリに配信します。

blackcandy は無料で使えますか？ライセンスは？

blackcandy は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

blackcandy は今もメンテナンスされていますか？

活発にメンテナンス中。blackcandy の最終コミットは 2026年10月21日 です。

blackcandy は何に使えますか？

自宅のサーバーで個人の音楽ライブラリをホストし、任意のブラウザから聴く。 家族や小規模なグループ向けに、プライベートな音楽ストリーミングサービスを運用する。 商用サブスクリプションサービスに頼らず、スマートフォンから自分のコレクションにアクセスする。 Dockerを使ったデプロイの参考として、セルフホスト型のRailsアプリケーションを試す。

blackcandy のインストール方法は？

GitHub Container Registry の Docker イメージを使って Black Candy を起動します: docker run -p 80:80 ghcr.io/blackcandy-org/blackcandy:latest ブラウザーで http://localhost を開き、初期管理者ユーザーでログインします

blackcandy はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/blackcandy-org/blackcandy