The app for Kalinka, a self-hosted music system. It runs on Android, Windows, macOS, Linux and in the browser. Ask for a mood, get a queue.
Google Play · Downloads · Kalinka server · kalinkaplayer.com
This app is the remote. The music lives on a Kalinka server, which runs on a Raspberry Pi or a Linux computer on your network. The app plays nothing without one, so install the server first. The app then finds it by itself, or takes its address by hand.
Search takes descriptions as well as names. Ask for "something melancholic for tonight" and it finds tracks that fit, all on your own hardware. No cloud, no subscription, no account.
Install Kalinka from Google Play, which keeps it up to date.
Without Google Play, Obtainium installs the app from GitHub Releases and keeps it up to date. Install Obtainium, then tap this badge on your phone:
Or download kalinka-android-universal.apk on the phone and open it. Android asks once to allow installs from your browser. To update, download and open the newer APK the same way.
The APKs on GitHub Releases are signed with the Kalinka release key. Its certificate SHA-256, which Obtainium can pin:
79e0051195d444fd531637202870223455fb436b80b75d55ce2c133aa33e11fb
Download and run kalinka-windows-x64-setup.exe. The installer is not code-signed, so Windows may warn about it: choose More info → Run anyway.
Download kalinka-linux-x64.tar.gz, extract it and run the kalinka binary. ./install.sh adds a launcher icon, and ./install.sh --uninstall removes it.
Download kalinka-macos-beta.dmg, open it and drag Kalinka to Applications. It runs on Intel and Apple Silicon. The build is a beta and is not notarized, so the first launch needs your approval: right-click the app and choose Open, or allow it in System Settings → Privacy & Security.
Nothing to install: open http://<server-address>:8000. The server serves the web player itself, and the browser can play the music too.
- Install the server. The quickest way is a ready-made image for a Raspberry Pi or a PC, which starts straight into a working player.
- Install the app, or open the browser player.
- Follow the setup the app shows the first time it connects.
A streamer that is not on your network yet can be set up from the app, over Bluetooth or the streamer's own temporary Wi-Fi. Connect your streamer to the network has the steps, including how to do it from a laptop without the app.
The installation guide covers the rest: the images, virtual machines, the one-command install, adding music and outputs in other rooms, and troubleshooting.
The source code is under Apache-2.0: see LICENSE and NOTICE.
The visual assets are not. Icons, logos, images and related artwork are covered by the Kalinka Asset License and require the author's permission to use or redistribute. You may distribute the code under Apache-2.0, but replace the branding with your own unless you have that permission.
Bundled IBM Plex fonts are under the SIL Open Font License 1.1: see assets/fonts/OFL-IBMPlex.txt.
Permission contact: MadEnvel <support@kalinkaplayer.com>

