# yaml-language-server: $schema=https://schema.zeabur.app/template.json apiVersion: zeabur.com/v1 kind: Template metadata: name: Black Candy spec: description: | Black Candy is a self-hosted music streaming server built with Rails and Hotwire. Uses SQLite for storage, supports MP3/FLAC/OGG/AAC/OPUS/WAV/WMA formats, and provides a clean web interface with album art, playlists, and favorites. coverImage: https://avatars.githubusercontent.com/u/61890599 icon: https://avatars.githubusercontent.com/u/61890599 variables: - key: PUBLIC_DOMAIN type: DOMAIN name: Domain description: The domain to access Black Candy tags: - Tool - Entertainment - Media readme: | # Black Candy A self-hosted music streaming server with a clean, modern interface. Built with Rails and Hotwire, using SQLite for storage so no external database is needed. ## Default Setup 1. **Visit your domain** after deployment 2. **Create an admin account** — on first access, you'll be prompted to set up the initial admin user 3. **Upload music** — place audio files in the `/media_data` volume; Black Candy will automatically scan and index them ## What You Can Do After Deployment 1. **Upload and stream music** — supports MP3, FLAC, OGG, AAC, OPUS, WAV, and WMA formats 2. **Browse your library** — view by artist, album, or song with album art display 3. **Create playlists** — organize your music into custom playlists 4. **Mark favorites** — save your favorite songs and albums for quick access 5. **Multi-user support** — create additional user accounts 6. **Use mobile apps** — native iOS and Android apps available ## Key Features - Clean, modern web interface with responsive design - SQLite storage — no external database needed - Supports MP3, FLAC, OGG, AAC, OPUS, WAV, and WMA - Album art display and media metadata parsing - Playlist and favorites management - Multi-user support - Native iOS and Android apps - Dark mode support ## Music Library Place your music files in the `/media_data` volume. Black Candy automatically scans this directory and imports audio files with their metadata and album art. ## License MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) services: - name: black-candy icon: https://avatars.githubusercontent.com/u/61890599 template: PREBUILT_V2 spec: source: image: ghcr.io/blackcandy-org/blackcandy:v3.1.0 ports: - id: web port: 80 type: HTTP volumes: - id: app-storage dir: /app/storage - id: media-data dir: /media_data env: SECRET_KEY_BASE: default: ${PASSWORD} healthCheck: type: HTTP port: web http: path: / domainKey: PUBLIC_DOMAIN localization: es-ES: description: | Black Candy es un servidor de streaming de musica autoalojado construido con Rails y Hotwire. Usa SQLite para almacenamiento y soporta formatos MP3/FLAC/OGG/AAC/OPUS/WAV/WMA. variables: - key: PUBLIC_DOMAIN type: STRING name: Dominio description: El dominio para acceder a Black Candy readme: | # Black Candy Servidor de streaming de musica autoalojado con interfaz limpia y moderna. Usa SQLite, sin base de datos externa. ## Configuracion inicial 1. **Visita tu dominio** — despues del despliegue 2. **Crea una cuenta de admin** — configura el usuario inicial en el primer acceso 3. **Sube musica** — coloca archivos en el volumen `/media_data` ## Que puedes hacer despues del despliegue 1. **Sube y reproduce musica** — soporta MP3, FLAC, OGG, AAC y mas 2. **Explora tu biblioteca** — navega por artista, album o cancion 3. **Crea listas de reproduccion** — listas personalizadas 4. **Marca favoritos** — guarda canciones y albumes favoritos ## Licencia MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) id-ID: description: | Black Candy adalah server streaming musik self-hosted yang dibangun dengan Rails dan Hotwire. Menggunakan SQLite untuk penyimpanan dan mendukung format MP3/FLAC/OGG/AAC/OPUS/WAV/WMA. variables: - key: PUBLIC_DOMAIN type: STRING name: Domain description: Domain untuk mengakses Black Candy readme: | # Black Candy Server streaming musik self-hosted dengan antarmuka bersih dan modern. Menggunakan SQLite, tanpa database eksternal. ## Pengaturan Awal 1. **Buka domain** — setelah deploy selesai 2. **Buat akun admin** — konfigurasi pengguna awal pada akses pertama 3. **Upload musik** — letakkan file audio di volume `/media_data` ## Apa yang bisa dilakukan setelah deploy 1. **Upload dan streaming musik** — mendukung MP3, FLAC, OGG, AAC, dan lainnya 2. **Jelajahi pustaka** — browse berdasarkan artis, album, atau lagu 3. **Buat playlist** — playlist kustom 4. **Tandai favorit** — simpan lagu dan album favorit ## Lisensi MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) ja-JP: description: | Black CandyはRailsとHotwireで構築されたセルフホスト型音楽ストリーミングサーバーです。SQLiteで保存し、MP3/FLAC/OGG/AAC/OPUS/WAV/WMA形式をサポート。 variables: - key: PUBLIC_DOMAIN type: STRING name: ドメイン description: Black Candyにアクセスするためのドメイン readme: | # Black Candy セルフホスト型音楽ストリーミングサーバー。SQLiteストレージで外部データベース不要。 ## 初期セットアップ 1. **ドメインにアクセス** — デプロイ後に開く 2. **管理者アカウントを作成** — 初回アクセス時に設定 3. **音楽をアップロード** — `/media_data` ボリュームにファイルを配置 ## デプロイ後にできること 1. **音楽をアップロード・ストリーミング** — MP3、FLAC、OGG、AAC等をサポート 2. **ライブラリを閲覧** — アーティスト、アルバム、曲で検索 3. **プレイリストを作成** — カスタムプレイリスト 4. **お気に入りを登録** — 好きな曲とアルバムを保存 5. **モバイルアプリ** — iOS/Androidネイティブアプリ対応 ## ライセンス MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) ko-KR: description: | Black Candy는 Rails와 Hotwire로 구축된 셀프호스팅 음악 스트리밍 서버입니다. SQLite 저장소를 사용하며 MP3/FLAC/OGG/AAC/OPUS/WAV/WMA 형식을 지원합니다. variables: - key: PUBLIC_DOMAIN type: STRING name: 도메인 description: Black Candy에 접속할 도메인 readme: | # Black Candy 셀프호스팅 음악 스트리밍 서버. SQLite 저장소로 외부 데이터베이스 불필요. ## 초기 설정 1. **도메인 접속** — 배포 후 방문 2. **관리자 계정 생성** — 첫 접속 시 설정 3. **음악 업로드** — `/media_data` 볼륨에 파일 배치 ## 배포 후 할 수 있는 것 1. **음악 업로드 및 스트리밍** — MP3, FLAC, OGG, AAC 등 지원 2. **라이브러리 탐색** — 아티스트, 앨범, 곡별 검색 3. **플레이리스트 생성** — 커스텀 플레이리스트 4. **즐겨찾기 등록** — 좋아하는 곡과 앨범 저장 5. **모바일 앱** — iOS/Android 네이티브 앱 지원 ## 라이선스 MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) th-TH: description: | Black Candy คือเซิร์ฟเวอร์สตรีมเพลงแบบ self-hosted สร้างด้วย Rails และ Hotwire ใช้ SQLite เก็บข้อมูล รองรับรูปแบบ MP3/FLAC/OGG/AAC/OPUS/WAV/WMA variables: - key: PUBLIC_DOMAIN type: STRING name: โดเมน description: โดเมนสำหรับเข้าถึง Black Candy readme: | # Black Candy เซิร์ฟเวอร์สตรีมเพลงแบบ self-hosted อินเทอร์เฟซสะอาดและทันสมัย ใช้ SQLite ไม่ต้องการฐานข้อมูลภายนอก ## การตั้งค่าเริ่มต้น 1. **เข้าสู่โดเมน** — หลังจากติดตั้งเสร็จ 2. **สร้างบัญชีผู้ดูแล** — ตั้งค่าผู้ใช้เริ่มต้นในการเข้าถึงครั้งแรก 3. **อัปโหลดเพลง** — วางไฟล์เสียงในโวลุ่ม `/media_data` ## สิ่งที่ทำได้หลังจากติดตั้ง 1. **อัปโหลดและสตรีมเพลง** — รองรับ MP3, FLAC, OGG, AAC และอื่นๆ 2. **เรียกดูไลบรารี** — ค้นหาตามศิลปิน อัลบั้ม หรือเพลง 3. **สร้างเพลย์ลิสต์** — เพลย์ลิสต์กำหนดเอง 4. **ทำเครื่องหมายรายการโปรด** — บันทึกเพลงและอัลบั้มที่ชอบ ## สัญญาอนุญาต MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) zh-CN: description: | Black Candy 是自托管的音乐流媒体服务器，使用 Rails 和 Hotwire 构建。使用 SQLite 存储，支持 MP3/FLAC/OGG/AAC/OPUS/WAV/WMA 格式。 variables: - key: PUBLIC_DOMAIN type: STRING name: 域名 description: 访问 Black Candy 的域名 readme: | # Black Candy 自托管的音乐流媒体服务器，界面简洁现代。使用 SQLite 存储，无需外部数据库。 ## 初始设置 1. **打开域名** — 部署完成后访问 2. **创建管理员账号** — 首次访问时设置初始管理员 3. **上传音乐** — 将音频文件放入 `/media_data` 存储卷 ## 部署后可以做什么 1. **上传和串流音乐** — 支持 MP3、FLAC、OGG、AAC 等格式 2. **浏览音乐库** — 按艺人、专辑或歌曲浏览 3. **创建播放列表** — 自定义播放列表 4. **标记收藏** — 保存喜欢的歌曲和专辑 5. **多用户** — 创建额外账号 ## 授权 MIT — [GitHub](https://github.com/blackcandy-org/blackcandy) zh-TW: description: | Black Candy 是自架的音樂串流伺服器，使用 Rails 和 Hotwire 建構。使用 SQLite 儲存，支援 MP3/FLAC/OGG/AAC/OPUS/WAV/WMA 格式，提供簡潔的網頁介面。 variables: - key: PUBLIC_DOMAIN type: STRING name: 網域 description: 存取 Black Candy 的網域 readme: | # Black Candy 自架的音樂串流伺服器，介面簡潔現代。使用 SQLite 儲存，無需外部資料庫。 ## 初始設定 1. **開啟網域** — 部署完成後造訪 2. **建立管理員帳號** — 首次存取時設定初始管理員 3. **上傳音樂** — 將音訊檔案放入 `/media_data` 磁碟區 ## 部署後可以做什麼 1. **上傳和串流音樂** — 支援 MP3、FLAC、OGG、AAC、OPUS、WAV、WMA 2. **瀏覽音樂庫** — 依藝人、專輯或歌曲瀏覽 3. **建立播放清單** — 自訂播放清單 4. **標記收藏** — 儲存喜愛的歌曲和專輯 5. **多使用者** — 建立額外帳號 6. **行動裝置 App** — 支援 iOS 和 Android 原生 App ## 授權 MIT — [GitHub](https://github.com/blackcandy-org/blackcandy)