Support

Before you write

Three things that usually get a bug fixed in one reply:

• Which server you run and its version. Navidrome, LMS, Ampache, gonic, something else. Most odd behaviour comes down to server differences.
• What you expected, what happened, and whether it happens every time or only sometimes.
• The version and build number, at the bottom of Settings. The release notes say what each version changed.

Common answers

It won't install

You need iOS 26 or newer. Open the App Store link on the iPhone itself, not on a Mac.

Login fails, but the server works in a browser

Make sure the address has the scheme (https://) and any port or path your server sits behind. If your server supports OpenSubsonic API keys, the app offers that once it has checked the address. A key is safer than a password, and you can revoke it on the server.

Tailscale: the name doesn't work

A tailnet name like nas or nas.tail1234.ts.net only resolves while the Tailscale app on the iPhone is connected, and iOS sometimes drops that resolution even when it is. If the name fails, use the server's 100.x.y.z address with its port instead; that always routes while the tunnel is up. A tunnel that has been asleep can take a few seconds to wake, and the app waits for it once before giving up.

Downloads disappear

iOS reclaims storage when the device is nearly full. SubSonify stores downloads so they survive the normal cleanup, but a device with no space left will still lose data. Free up some space and download again.

CarPlay shows nothing

CarPlay uses the account signed in on the phone. If the phone is signed out, the car shows a sign-in notice. There is no keyboard in a car, so sign in on the phone. The car picks it up right away.

The watch can't reach my server

The watch takes the login from the phone, so sign in on the phone first. After that it works on its own over Wi-Fi or LTE. One trap: a watch paired to a phone in airplane mode is not offline. It routes through a phone with no connection, and that fails in a way that looks like a server problem.

Nothing plays on mobile data

Streaming and downloads have separate cellular settings in the app, and downloads are Wi-Fi only by default. Check Settings.

Siri says the app isn't set up, or plays nothing

"Play ⟨artist⟩" by voice needs three things the app cannot switch on for you: iOS 27, Apple Intelligence turned on in Settings, and a Siri language whose region offers the new Siri (Siri set to English on a German-region phone does not, for example). Ask once with "on SubSonify" so Siri learns which app you mean; after that the name alone works. On iOS 26 there is no voice-first play; playlists, liked songs and shuffle still work as Shortcuts, and every action is available in the Shortcuts app.

Is it open source?

No. The app is closed source. The server it talks to is whatever you chose to run.

What is free, and what is Pro?

Streaming is free, with no daily limit: your whole library, search, playlists, lyrics, Siri, internet radio and CarPlay. Pro is what goes beyond streaming: downloads and offline playback, discovery (For You, Song Radio, Play something), the standalone Apple Watch app, the equalizer, mix transitions, smart playlists and Chromecast. Monthly, yearly with a free first week, or once for life; the app shows the price in your currency.