Coda
Back

Navidrome

Connect Coda to your Navidrome server for streaming and offline playback of your personal music collection.

What is Navidrome?

Navidrome is a free, self-hosted music server compatible with the Subsonic API. It streams your personal music library to any client that supports the Subsonic protocol. You maintain full control of your music and metadata.

Setting Up

  1. Go to Settings → Navidrome in the Coda app.

  2. Enter your server URL. This is the base URL of your Navidrome instance, for example: https://music.example.com

  3. Enter your username and password. These are the same credentials you use to log into the Navidrome web interface.

  4. Tap Connect. Coda will verify the connection by pinging the server. On success, you'll be taken to the Navidrome browser.

ℹSecure Storage

Your Navidrome credentials are encrypted with AES-256-GCM and stored in the device's secure enclave (iOS Keychain / Android Keystore) using expo-secure-store. Your password never appears in plaintext in any file.

Browsing Your Library

Once connected, the Navidrome tab appears in the bottom navigation. Browse your remote library using the drill-down interface:

  • Artists → Albums by artist → Songs
  • Albums → Songs in album
  • Albums by Year → Albums grouped by release year
  • Albums by Genre → Albums grouped by genre

Searching

Use the search bar at the top of the Navidrome browser to search your remote library. Search results show matching artists, albums, and songs.

Adding to Local Library

Long-press any track in the Navidrome browser and select Add to Library to add it to your local library. The track will appear in your Library tab and can be played directly.

✦Auto-Download

When you add a Navidrome track to your library, Coda automatically caches the audio file and artwork for offline playback.

Offline Caching

Coda caches Navidrome tracks and artwork to local storage for offline playback. Cached files are stored in Coda/Downloads/audio and Coda/Downloads/artwork, which are visible in the iOS Files app. Cached tracks are identified by a checkmark icon in the library.

How It Works

  • When you play a track from Navidrome, the audio is downloaded and cached locally.
  • On subsequent plays, the cached version is used instead of streaming again.
  • Artwork is cached separately for fast display.
  • You can also manually download tracks for offline playback from the long-press menu.

Managing Cache

Go to Settings to view your current cache size and clear the cache if needed.

Connection Handling

Coda uses a 15-second timeout for all network requests to Navidrome. If the server is unreachable, you'll see an error message with the specific issue. Your credentials are preserved so you can retry when the server is back online.

Logging Out

Go to Settings → Navidrome and tap Disconnect to remove your credentials and disconnect from the server. This does not remove tracks already added to your local library.