Android App
The Muorg Android client (Kotlin + Jetpack Compose, Media3/ExoPlayer) works in two modes: streaming from a muorg-server, or playing music stored on the device itself.
Install
The app is distributed as an APK from GitHub Releases — it is not on Google Play. It has its own release tag, separate from the desktop and server releases.
- Open the Releases page and find the release tagged
android-v<version>. - Download
muorg-<version>.apk. - Allow Install unknown apps for your browser or file manager when prompted.
- Open the file to install.
Requires Android 8.0 (API 26) or newer.
Choosing a music source
The welcome screen offers two paths, and you can switch later in Settings → Music source:
| Mode | What it does |
|---|---|
| Muorg Server | Streams from a muorg-server. Enter the server URL (e.g. http://192.168.1.50:7700) and the api_key from muorg-server.toml. |
| Local Library | Pick folders on the device; the app scans them into an on-device catalogue. No server, no network. |
Changing the music source wipes the currently cached library and rescans from the new source. Server-side playlists, ratings and play counts are unaffected — they live on the server.
If a server connection fails, check that the server is up (/api/health), that the phone can actually reach the URL (same Wi-Fi/LAN or a publicly reachable address), and that the API key matches.
Browsing and playback
- Library — album grid, album list or flat track list, with live search and recent-search chips.
- Album view — tap an album to browse and play its tracks.
- Player — artwork, seek, shuffle, repeat and queue.
- Playlists — create and manage regular playlists. Smart playlists defined on the server are shown and playable, but their rules are edited on desktop or in the web app.
- Metadata — edit a single track's title, artist, album, album artist, genre and year from its actions sheet. The metadata scan tool under Settings → Library tools finds tracks that still need tags.
Sleep timer
From the player screen, tap the sleep-timer icon and pick a duration. Playback stops when it elapses — including cast playback. Tapping the icon again while a timer is running lets you cancel it, and the remaining time is shown in the mini player.
Chromecast
Cast from the app to any Chromecast device on your network using the Cast button. Server-backed tracks are cast straight from the server's stream URL; tracks stored on the device are served to the Cast receiver by a small HTTP server that runs inside the app while casting.
Home-screen widget
A Now Playing widget shows the current track and playback controls:
- Long-press your home screen and open the widget picker.
- Add the Muorg widget.
The widget updates when the app updates playback state. If it looks stuck, remove and re-add it, or reopen the app.
Settings
Version and update check, playback behaviour (continuous playback, what tapping the mini player does), default library sort and layout, theme (dark / light / follow system, true black, Material You), the music-source switch with per-mode options (server URL, statistics, refresh and log out; or add-folder and rescan), and the metadata scan tool.
See Version Compatibility for which client versions work with which server versions.