What can I do with an OpenSubsonic source?

OpenSubsonic is a community-developed standard that allows you connect and listen to music from several types of personal music servers, including:

• Navidrome
• Gonic
• Lightweight Music Server

Additionally, Radiccio may also be compatible with other OpenSubsonic servers not listed here.

With Radiccio, you can access and listen to all of your music libraries on the server. Each library is a separate item in the Radiccio source list. You can pick and choose which libraries you want to use, and you can add libraries from multiple different servers.

Radiccio Plus! is required in order to add and use OpenSubsonic sources in Radiccio.

To learn which features are available with an OpenSubsonic source, see our feature availability guide.

Can I connect to a server using the older Subsonic API?

It’s possible, but not a sure thing. We use the term “OpenSubsonic” to indicate that we support the community-developed version of the standard, rather than the original Subsonic software. On a technical level, the protocols are similar, but not exactly the same.

If the developer has indicated that the server implements OpenSubsonic, but it is not working with Radiccio, please let us know.

For authentication, Radiccio requires the server to support either the “hash+salt” method, or the API Key method. The older cleartext method is not supported, in accordance with the OpenSubsonic specification.

What is an API Key? Where do I find it?

API Keys are the current recommended way to sign in to an OpenSubsonic server.

If you are using Lightweight Music Server, find your API Key in User menu > Settings > Subsonic API > OpenSubsonic API Key. If the text field is empty, click “Generate”. Then click the “eye” button to see it, and you can copy and paste it into Radiccio.

For other types of OpenSubsonic servers, please consult the product documentation for where to find the API Key.

Not all servers support API Key authentication. If your server does not support it, the option will be disabled. In this case, you can sign in with your username and password instead.

Why is the username and password option disabled?

If the server supports API Key authentication, you will need to use that instead. See the above answer.

I can’t connect to my OpenSubsonic server because Radiccio says it requires “a secure connection” (HTTPS)

Apple’s platform security guidelines strongly encourage the use of HTTPS. As an app developer, we can get in trouble if we don’t follow these guidelines. The system that Apple built to enforce this is called App Transport Security (ATS).

Here are some possible solutions:

1. If your server is only being used within your LAN, try connecting to it by IP address, rather than hostname. We have carved out ATS exemptions so that HTTP is allowed within the common LAN IP address ranges (10.0.0.0/8, 192.168.0.0/16, 172.16.0.0/12, fc00::/7, fe80::/10, and localhost) but this generally does not work for hostnames, so try using an IP address instead.

2. If your server is protected behind a VPN like Tailscale, we also have ATS exemptions for some common VPN IP ranges and hostnames (such as 100.64.0.0/10, fd7a:115c:a1e0::/48 and *.ts.net) so you should be able to connect to those with HTTP. If you use another VPN provider that is not covered by this, please contact us so we can look into it further.

3. If your server is exposed to the public internet, you should really consider protecting it with HTTPS. Among other issues, OpenSubsonic uses either cleartext or the obsolete MD5 algorithm, meaning that without HTTPS, an attacker (for example at a hotel or coffee shop) could easily gain access to your server.

   • Rather than configuring the server with HTTPS directly, you can place it behind a reverse proxy.
   • A mesh VPN like Tailscale would be a safer choice.

Outside of the situations outlined above, unfortunately, we are not able to disable the HTTPS requirement entirely.

Does Radiccio transcode content from my server?

No, Radiccio does not transcode.

Unsupported formats will not appear in Radiccio, and cannot be played. Please reference our article about supported formats.

My recently played items, play counts, last played date, etc. don’t update after listening to content from my server in Radiccio

Check the source settings and make sure “Report activity to server” is enabled. For privacy reasons, this is disabled by default.

Why doesn’t the Folders tab appear for Navidrome servers?

Navidrome does not support browsing by folder, as per their documentation:

There are currently no plans to support browse-by-folder.

Other OpenSubsonic servers, such as Gonic and Lightweight Music Server, do support this, and Radiccio features a Folders tab for those sources.