Black Candy
A self-hosted music server with its own free iPhone and Android apps.
No server needed to start: Cloudgate can provide one. What happens when you click Deploy
What is Black Candy?
Black Candy is a self-hosted music streaming server: upload the music you own and play it in your browser or its free iPhone and Android apps.
Black Candy is a free, open-source, self-hosted music streaming server that plays the music you own in a web player and in its own free iPhone and Android apps, like a personal Spotify or Apple Music for your own files. You add your MP3, FLAC and other songs, and Black Candy sorts them into albums, artists, genres and years, with playlists, favourites and a list of what you played recently.
Each person gets an account with their own playlists and favourites. A family, for example, could put its ripped CD collection on Black Candy once, then let everyone listen from the official app on their own phone or in a browser at home, without a subscription.
Black Candy keeps things simple: one web player and official apps from the same project, rather than a choice of outside apps. It doesn't work with Subsonic apps, and it has no smart playlists, sharing links or scrobbling. It has no music catalogue: you bring your own music.
Cloudgate installs Black Candy on a server Cloudgate provides or one you connect and gives it a secure web address. Sign in with the admin email you entered at setup and the password Cloudgate shows. A second address opens File Browser, where you upload your music; then press Sync in Black Candy's Settings.
What you can do with Black Candy
- Stream your collection Play your MP3, FLAC, AAC, Ogg and other music files in any web browser, browsing by album, artist, song and playlist.
- Free official phone apps Black Candy's own apps for iPhone and Android are free and open source, and connect to your server with your email and password.
- Find music fast Search across artists, albums, songs and playlists, and filter albums and songs by genre or year.
- Playlists and favourites Build playlists, reorder the play queue, and heart songs to keep them in your favourites.
- An account for everyone The admin adds an account for each person, with their own playlists, favourites, recently played albums and light or dark theme.
- Lighter streams on mobile data Black Candy converts files a browser can't play, and can shrink lossless files to MP3 as it streams to save data.
- Artist and album pictures Add a free Discogs token in Settings, and Black Candy fetches images for your artists and albums.
Replaces Spotify and Apple Music
Black Candy does the same job as Spotify and Apple Music. Here is what changes when you switch.
- No monthly subscription and no ads
- Official phone apps for iPhone and Android at no cost
- You hear your own files in the quality you chose, and nothing disappears when a licence ends
- The whole household can have its own accounts at no extra cost
- You bring the music; there is no catalogue, no recommendations and no editorial playlists
- Music is uploaded at a separate File Browser address, and new songs appear after the admin presses Sync
- It doesn't work with third-party Subsonic apps, and has no smart playlists, share links or Last.fm scrobbling
- Playlists can't be imported from Spotify or Apple Music, so you rebuild them by hand
What happens when you click Deploy?
You do not need a server or any technical knowledge. Four steps, and Black Candy is running at its own web address.
- Step 1 Click Deploy and create your account
Deploy takes you to Cloudgate. Create an account, or log in if you have one. Black Candy itself is free.
- Step 2 Choose a server
No server? Get one from Cloudgate: pick a size and a country, and Cloudgate gets it ready. Already have one? Connect it instead.
- Step 3 Cloudgate sets up Black Candy
It prepares the server, makes the passwords the app needs and starts it. There is nothing to install and nothing to write down.
- Step 4 Open your app and sign in
Your app gets a free web address to start, without https. Add your own domain, like app.yourshop.com, and Cloudgate secures it with https for you.
New to Cloudgate? See what Cloudgate is
Run Cloudgate yourself? Deploy from your own console
In your Cloudgate console, open Templates and choose Black Candy.
Questions
Is Black Candy free?
Yes. Black Candy is free, open-source software under the MIT licence, with no paid edition and no paid features, and its iPhone and Android apps are free too. You pay only for your server and its storage.
Is Black Candy a good alternative to Spotify?
Yes, if you already own your music as files. Black Candy streams your own songs to a web player and to its free iPhone and Android apps with no subscription or ads, but it has no music catalogue or recommendations, so it plays only what you upload.
How do I sign in to Black Candy the first time?
Sign in with the admin email you entered when setting up Black Candy in Cloudgate and the password Cloudgate generated, which you find on the app's variables page. The usual default login of a fresh Black Candy install is replaced with yours, and the admin then adds everyone else.
How do I add my music to Black Candy?
Upload it at the second web address Cloudgate gives this app, which is File Browser, signing in as admin with the password Cloudgate shows. Drag in folders such as Artist/Album, then open Settings in Black Candy and press Sync, or turn on the Media Listener so new files are added by themselves.
Is there a Black Candy app for iPhone or Android?
Yes. Black Candy has free, official, open-source apps on the App Store for iPhone and on Google Play and F-Droid for Android. You sign in with your server's address, email and password, and the web player also works in a phone's browser.
Does Black Candy work with Subsonic apps?
No. Black Candy doesn't support the Subsonic standard, so apps such as Symfonium or DSub can't connect to it; you listen through its web player or its own phone apps. If you want Subsonic apps, Navidrome is the better fit.
Can I import my playlists from Spotify or Apple Music?
No, Black Candy has no playlist import. Upload the music files you own, then rebuild your playlists in Black Candy.
Do I need technical skills to run Black Candy?
No. Click Deploy, create your Cloudgate account and choose a server, and Cloudgate sets up Black Candy and gives it a web address. You use it in your browser like any other online tool.
Do I need my own server for Black Candy?
No. When you deploy Black Candy, hosted Cloudgate can provide a server. If you already rent one, you can connect it instead.
Related apps
A self-hosted music server with a rich web player for your own songs.
A light, self-hosted music server with its own phone apps.
A self-hosted music server that works with almost any music app.
Stream the music you own to your browser and phone, no subscription.