A clean music player for your self-hosted server, and your local files.
Android, with an experimental iOS build.
|
|
|
|
| Artist | Lyrics | Queue | Servers |
| :---: | :---: | :---: | :---: |
|
|
|
|
|
## Download
You need a Navidrome, OpenSubsonic, Jellyfin or Ampache server, or just music files on your device.
### Android
Get the latest APK from the [Releases](https://github.com/juananzzz/resonus/releases/latest) page and install it on your Android device.
Also available on [Obtainium](https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/juananzzz/resonus) for automatic updates.
Requires Android 7.0 or newer. Not on F-Droid yet.
### iOS (experimental)
Download the `.ipa` from the [Releases](https://github.com/juananzzz/resonus/releases/latest)
page and sideload it with AltStore, Sideloadly or similar, or
[add Resonus as an AltSource](https://altdirect.app/?url=https://raw.githubusercontent.com/juananzzz/resonus/main/Source.json)
to get updates. The build is unsigned, so it is not on the App Store or TestFlight.
Not available on iOS yet: CarPlay, casting, the equalizer and gapless playback.
## Features
### Servers and local music
- **Navidrome / OpenSubsonic / Jellyfin / Ampache**: multi-profile login, multi-library support, plus several server addresses with automatic switching
- **Local mode**: play music straight from your device or a folder, no server needed
- **Queue sync across devices**
### Listening
- **Playback**: gapless, crossfade, built-in equalizer, ReplayGain normalization, playback speed, sleep timer, queue with undo, shuffle, repeat, background & lock-screen controls
- **Autoplay & mixes**: keep the music going with similar songs, or start a mix from any track
- **Synced lyrics**: karaoke view with tap-to-seek, word-by-word highlighting (TTML and enhanced LRC), full-screen mode, optional lookup on [LRCLIB](https://lrclib.net) and [lrc.red](https://lrc.red)
- **Internet radio**: browse and manage your stations
- **Podcasts**: search for a show or paste its feed, no server needed; download episodes, favorite them and queue them
- **Cast to speakers**: UPnP/DLNA renderers and Sonos, with room grouping; local music streams to them too
- **Android Auto** (experimental)
### Library and downloads
- **Offline mode**: your favorites, playlists and albums stay browsable with no connection; downloaded songs play, the rest show grayed out, and it switches automatically when the server is unreachable
- **Downloads**: albums, playlists, an artist's whole discography or single songs, in original quality or transcoded
- **Organize**: multi-select (queue, playlist or download in batch), star ratings, pinned items, play history
### Personalization
- **Themes**: dark, light, the phone's own or on a schedule, with a palette of accent colors or one of your own
- **Make it yours**: reorder and show/hide Home sections, chips and tabs, app fonts, lyrics size, mini player buttons, swipe actions and more
- **Landscape and tablet layouts**
- **In 13 languages**: English, Spanish, German, Catalan, Russian, Italian, Simplified Chinese, Ukrainian, Polish, Swedish, Brazilian Portuguese, Turkish, French
## FAQ
The questions that come up most often are answered in
[docs/FAQ.md](./docs/FAQ.md), starting with how to get Resonus to show up in
Android Auto. The app links to it too, from Settings › About.
## Translations
More languages are welcome via pull request. See
[TRANSLATING.md](./TRANSLATING.md) for how to add one, plus context for the
trickier strings.