Cross-platform app for the self-hosted Kalinka music system — Android, Linux desktop and the browser. Ask for a mood, get a queue.
📱 Download · 🖥️ Music server · 💿 Flash an image · 🌐 kalinkaplayer.com
This repository is the app — the remote control. The music is served by the separate Kalinka Music Server: a lightweight backend with a C++/ALSA audio engine, the library indexer and metadata-enrichment pipeline, and the CLAP semantic-search engine.
You need both. The app finds a server on your network over mDNS, or takes an address by hand. If you would rather not install anything at all, the server also serves a browser player — open http://<server-ip>:8000 and it plays there.
Semantic search turns a phrase like "something melancholic for tonight" into matching tracks, running on your own hardware. No cloud, no subscription, no account.
Obtainium installs straight from GitHub Releases and keeps the app updated — tap the badge on your phone and it pre-fills this repo. Everything is also on the releases page if you would rather take the file yourself.
| Platform | What to take |
|---|---|
| 🤖 Android | Three APKs per release. Pick arm64-v8a unless the phone is ancient — armeabi-v7a for old 32-bit devices. The unsuffixed universal APK runs on anything but is larger. |
| 🐧 Linux desktop (x64) | Extract the linux-x64 tarball and run ./install.sh to register the launcher icon (--uninstall reverses it), or just run the kalinka binary. |
| 🌐 Browser | Nothing to install — the server serves the web player itself. |
All release APKs are signed with the Kalinka release key. Certificate SHA-256, which Obtainium can pin:
79e0051195d444fd531637202870223455fb436b80b75d55ce2c133aa33e11fb
The app is half the system — you also need the server running. The quickest route is to flash a ready-made image onto a Raspberry Pi or any x86-64 box; it boots straight into a working player.
| Initial setup | Installing the server, pointing it at your music, connecting the app |
| First-run setup | What the setup wizard asks for, step by step, in the app and in the browser |
| App manual | Illustrated tour — the wizard, the server chip and settings, music folders, AI search and queueing |
Source code is 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>