Support

Need a hand? Start here.

Found a bug or have an idea? Open an issue on GitHub, or email hello@werket.com.au. Please include your device, OS version, SoundBase version and server type and version (for example Navidrome 0.64).

Getting started

  1. Set up Navidrome or any OpenSubsonic-compatible server, and make sure you can reach it from your device.
  2. Open SoundBase and enter your server address (for example music.example.com), username and password.
  3. That's it. On Apple Watch, open SoundBase after signing in on your iPhone and it connects automatically.

Library editing

For track, album and artist editing, follow the library editing setup guide. It covers the server helper, HTTPS, artwork and 30-day recovery.

Frequently asked questions

Which servers work with SoundBase?

Navidrome is the main server it's tested with. Other servers that support the Subsonic or OpenSubsonic API should work, but some features (like synced lyrics) depend on the server supporting them.

Why can't I sign in?

Check the address includes the right port if your server uses one (for example music.example.com:4533), that the server is reachable from your device, and that your username and password work in the server's web interface. If your server is only on your home network, you need to be on that network or a VPN.

Lyrics don't show up for a song.

Lyrics come from your server. Navidrome reads lyrics embedded in your music files and from .lrc files next to them. Time-synced lyrics need a synced (LRC) source.

“You Might Also Like”, similar songs and artist bios are empty.

These come from your server's external info provider. In Navidrome, enable Last.fm integration (or another agent) so it can fetch similar artists and biographies.

How do downloads work, and how much space do they use?

By default, lossless songs are converted to AAC 256 kbps as they download (about 2 MB per minute). MP3 and AAC files that are already small are kept as they are. You can choose Original, 256, 192 or 128 kbps in Settings. Apple Watch downloads use AAC 128 kbps. AAC conversion needs Navidrome 0.64 or later.

How do I listen on Apple Watch without my iPhone?

On the Watch, open SoundBase and download a playlist or album while connected to Wi-Fi or your iPhone. Then pair Bluetooth headphones with your Watch and play from Downloaded.

How do I cast to a Chromecast or Google TV?

Make sure your iPhone and the Cast device are on the same Wi-Fi network and that you've allowed Local Network access for SoundBase (Settings › Privacy & Security › Local Network). Then tap the Cast button in Now Playing. Your server must be reachable from the Cast device, and an https:// address works best.

Can I change the app icon?

Yes. Pick a colour in Settings › Appearance and the icon changes to match, if “App Icon Matches Colour” is on.

Is SoundBase really free?

Yes. It's free, has no ads or in-app purchases, and the full source code is on GitHub under the MIT License.

Does SoundBase collect my data?

The developer does not collect your data. See the privacy policy for how optional features such as Google Cast and artwork search use third-party services.

Contributing

SoundBase is open source. Pull requests, translations and bug reports are welcome on GitHub.