Self-host Resonus
v0.8.4Clean music player for self-hosted servers and local files
- Stars
- 212
What is Resonus?
Resonus is an open-source music player application for Android with experimental iOS support. It connects to self-hosted music servers including Navidrome, OpenSubsonic, Jellyfin, and Ampache, and can also play local files directly on the device. The app provides offline access with automatic switching, downloads in original or transcoded quality, synchronized lyrics with word-level highlighting using TTML or enhanced LRC formats, internet radio, and casting to UPnP/DLNA renderers and Sonos speakers with room grouping. Playback capabilities include gapless playback, crossfade, a built-in equalizer, ReplayGain normalization, variable playback speed, sleep timer, and background controls. Additional features include autoplay with similar tracks, mix generation, batch operations for queues and playlists, starred items, pinned content, play history, customizable themes (dark, light, system, scheduled), extensive UI personalization, experimental Android Auto support, landscape and tablet layouts, cross-device queue synchronization, and translations in 13 languages. Distribution is via APK/IPA files from GitHub releases, Obtainium for Android, and AltSource for iOS sideloading.
Should you self-host Resonus?
Resonus scores 48/100 on selfhost.directory (how scoring works) and ranks #24 of 59 in Music Streaming. It has 212 GitHub stars.
It shipped 9 stable releases in the past year. The latest, v0.8.4, came out on 20 October 2026. New versions land roughly every 1 days.
Setup is easy: most people get it running in one sitting. It is GPL-3.0-licensed and written mostly in Typescript.
Its closest alternative on selfhost.directory is koel (75/100, 17 318 stars). It scores higher overall, so compare the two before you pick. See Resonus vs koel side by side.
Features
- Advanced playback
- Autoplay & mixes
- Casting
- Customization
- Downloads
- Internet Radio
- Landscape and tablet layouts
- Library Organization
- Local file playback
- Multi-Server Support
- Offline Mode
- Queue sync
- Synced lyrics
Resonus README
FAQ
How do I get lyrics that light up word by word?
Use TTML files or enhanced LRC files with word-level timestamps placed next to the song file. Navidrome 0.63+ and Jellyfin support this; downloaded songs keep word timings for offline use.
How do I install Resonus on iOS?
Resonus on iOS is provided as an unsigned .ipa file that must be sideloaded using SideStore, AltStore, or by adding the Resonus repository as an AltSource.
How do I get Resonus to show up in Android Auto?
Enable developer settings in Android Auto by tapping Version ~10 times, then turn on Unknown sources in Developer settings. Resonus will then appear in the car's app list.
More in Audio Streaming
SnapcastSnapcast is an open-source, self-hosted multiroom audio system that syncs playback across clients with sub-millisecond precision.
SpodcastSpodcast is a self-hosted, open-source tool that converts Spotify podcasts into RSS feeds for any podcast player, with local caching and a web UI.
STR (SoundTouch Reborn)STR restores internet radio, Spotify Connect, preset buttons, multiroom, and local media to Bose SoundTouch speakers after the cloud shutdown.
subplayerSubplayer is a self-hosted, open-source web music player for Subsonic backends like Navidrome, with playback, playlists, search, and dark mode theming.
supysonicSelf-hosted, open-source Subsonic-compatible music streaming server with transcoding, scrobbling, jukebox mode, and internet radio support.
teddycloudteddyCloud is an open-source self-hosted replacement for the Boxine Cloud, running Toniebox audio services locally with web UI and MQTT/Home Assistant integration.
üWaveüWave Core is the open-source backend for a self-hosted collaborative listening platform where users take turns playing media from YouTube and SoundCloud.
vod2pod-rssSelf-hosted open-source tool that converts YouTube or Twitch channels into podcast RSS feeds with on-the-fly MP3 transcoding, requiring no server storage for VODs.
AircastAirCast is a self-hosted Home Assistant add-on bridging AirPlay to Chromecast for audio streaming from Apple devices.
AirConnectAdd AirPlay streaming capabilities to UPnP, Sonos and Chromecast devices. Open-source project with pre-built binaries for Windows, macOS, Linux and more.
airsonic-refixSelf-hosted, open-source web frontend for Subsonic music servers like airsonic-advanced, Navidrome and gonic: browsing, play queues, playlists, radio and podcasts.
airtimeSelf-hosted, open-source radio station software: schedule shows and playlists, add audio remotely, and stream with sub-second playout precision.
0 comments