Coda

Settings

Configure Coda's appearance, audio behavior, server connections, and cache from the Settings tab.

Theme

Switch between four built-in themes: Dark, Light, Midnight, and Ocean. Changes apply immediately across the entire app.

See the Themes page for detailed descriptions of each theme.

Navidrome

Manage your Navidrome server configurations. Add, edit, or delete servers, and switch between them. Each server's library, playlists, and downloads are fully isolated.

Server List

The Navidrome section shows all your saved server configurations. The active server has a green checkmark. Tap a server to switch to it — Coda will load that server's library and playlists.

Adding a Server

  • Tap the + button to open the server form
  • Enter a name for your own reference (e.g., "Home")
  • Enter your server URL (e.g., https://music.example.com)
  • Enter your username and password
  • Tap Test & Save to verify the connection and save the configuration

Editing or Deleting a Server

Tap Edit on a server to change its name, URL, or credentials. Tap Delete to remove the server configuration and its offline cache from your device. Tracks already in your local library are not affected.

ℹCredentials Storage

Each server's credentials are encrypted with AES-256-GCM before writing to a per-server settings file, with the encryption key stored in the device's secure enclave (expo-secure-store). Your passwords never appear in plaintext.

Last.fm

Connect your Last.fm account to automatically scrobble tracks and update your now-playing status. Once connected, a red dot appears on the Settings row and a Scrobbling indicator shows on the Player screen.

  • Enter your API key, shared secret, and authorize via token
  • Scrobbles submit after listening for at least min(240s, half the track duration)
  • Now-playing updates fire immediately on track start

See the Last.fm page for setup instructions and API credential details.

Equalizer

Tap Equalizer in the Audio Settings modal to access the 5-band native equalizer. Toggle it on or off, drag band sliders to adjust gain (-12 dB to +12 dB), or tap a preset chip for instant configuration.

  • 6 presets — Flat, Bass Boost, Treble, Vocal, Rock, Pop
  • 5 bands — 60 Hz, 230 Hz, 910 Hz, 3.6 kHz, 14 kHz
  • ON/OFF toggle — Bypass EQ without losing your settings

See the Audio Effects page for detailed descriptions of each preset and band.

Crossfade

Enable crossfade to smoothly transition between tracks. Set the crossfade duration from 1 to 12 seconds. When enabled, two audio players overlap during transitions for seamless playback.

Seamless Playback

Enable gapless playback to eliminate silence between tracks. When enabled, Coda pre-creates an audio player for the next track. Crossfade is automatically set to 2 seconds for optimal transition.

Cache

View and manage your offline cache. Cached files include downloaded audio tracks and artwork from Navidrome.

Viewing Cache Size

The current cache size is displayed in the Settings screen under the Cache section.

Clearing Cache

Tap Clear Cache to remove all cached audio and artwork. This frees up storage space but removes offline access to previously cached tracks.

⚠Permanent Action

Clearing the cache permanently removes all downloaded files. You will need to re-download tracks for offline playback.

Clear All Data

Tap Clear All Data to reset the entire app — playlists, library, settings, and cached files. This action cannot be undone.

General Playback Settings

Background Audio

Coda plays audio in the background by default. On Android, a foreground notification is displayed to maintain playback. On iOS, background audio is handled automatically.

Lock Screen Controls

Playback controls and track metadata are displayed on the lock screen and Control Center. This is enabled by default and requires the audio session to be active.

About

The About section displays the current app version and credits. Coda is free software with no ads, no subscriptions, and no tracking.

Android Permissions

On Android, Coda requests the following permissions:

  • Notification — Required for background playback foreground service
  • Media access — Required to import and play audio files
  • Wake lock — Prevents the device from sleeping during playback