Orchard Mobile Settings

Orchard Mobile Settings

Every option in Orchard Mobile, with its accepted values and default. Settings are stored in a DataStore named orchard_settings and applied immediately.

Orchard Mobile keeps its own settings entirely separate from Orchard desktop. Pairing the two through Orchard Connect does not sync preferences in either direction.

Playback

Setting	Values	Default
Audio quality	Data Saver / Normal / High / Max	High
Crossfade	on / off	off
Crossfade length	1 to 12 seconds	6 s
Smart Crossfade	on / off	off
Autoplay	on / off	on
Volume normalization	on / off	off

Audio quality

The four levels map to real decisions about which stream gets picked, rather than to a vague quality label:

Level	Behavior
Data Saver	The lowest-bitrate audio format available.
Normal	The best format at or below 140 kbps, falling back to the lowest available if nothing qualifies.
High	The best available format, preferring the better codec first and then the higher bitrate.
Max	Resolves through NewPipe for the highest-bitrate stream available, falling back to High if extraction fails.

Formats are ranked by codec preference before bitrate, so a better codec at a lower bitrate can outrank a worse one at a higher bitrate.

Crossfade

Crossfade is off by default on mobile, unlike desktop where it is on. Turning it on gives a fixed fade of the configured length. Smart Crossfade is a separate toggle on top of that.

Smart Crossfade lets stored analysis place the overlap: on the beat, past the incoming track's lead-in, and ending where the music actually does, rather than ramping blindly over the last few seconds. Tracks it has no evidence about fall back to the plain fade, so enabling it is never worse than leaving it off. See Smart Crossfade for the full engine.

Storage

Setting	Values	Default
Cache size	256 MB to 8192 MB	1024 MB

The slider offers round stops rather than arbitrary megabytes: 256, 512, 1024, 2048, 4096, and 8192 MB.

Whole tracks are kept rather than fragments, so this setting is the difference between a few albums and a library, and between instant re-listens and refetching everything.

The stream cache is distinct from Offline Downloads, which are permanent until you remove them and are not subject to cache eviction.

Appearance

Setting	Values	Default
Animated artwork	on / off	on
System colors	on / off	off
Animated background	on / off	off

System colors takes the accent from Android's wallpaper palette (Material You) instead of Orchard's own green.

Animated background lets the artwork-tinted background drift instead of holding still between tracks.

Integrations

Setting	Values	Default
Discord Rich Presence	on / off	on
Discord animated artwork	on / off	on
Spotify Canvas	on / off	on
Spotify sp_dc cookie	text	empty

Discord Rich Presence on mobile connects to Discord's gateway directly from the phone, rather than through a locally running Discord client the way the desktop does.

Spotify Canvas support shows Spotify's short looping clips for a track when available. It requires an sp_dc cookie value, which is why that field exists. Leaving it empty leaves Canvas inactive regardless of the toggle.

Interface

Setting	Values	Default
Show bitrate	on / off	off

Show bitrate displays the current stream's bitrate under the player scrubber, which is the quickest way to confirm what your audio quality setting is actually delivering.

Search history

Orchard Mobile keeps your last 10 searches locally to offer as suggestions. Recording a query you have already searched moves it to the top rather than duplicating it.

Search history can be cleared from the app. It never leaves the device.

Account

Sign in from Profile → Account. Signing in is optional; search and playback work as a guest, while your library, likes, playlists, and age-restricted tracks require an account. See Explicit and Age-Restricted Tracks.

Connected devices

Profile → Connected devices manages desktop pairings and is also where you pick which device plays. See Orchard Connect.

Onboarding

The welcome flow runs once and records that it completed. It can be revisited from settings.

Where settings are stored

All of the above lives in a DataStore named orchard_settings inside the app's private storage, so it is removed when you uninstall the app and is not readable by other apps.

Sensitive values are handled separately. Pairing tokens are encrypted with an AndroidKeyStore-backed key and excluded from Android backups. See Privacy and Data.

Source map

Path	Role
mobile/.../settings/SettingsRepository.kt	DataStore persistence and search history
mobile/.../model/UiModels.kt	OrchardSettings, defaults, and cache size steps
mobile/.../ui/screens/SettingsScreen.kt	Settings UI
mobile/.../playback/YouTubeStreamResolver.kt	Audio quality to format selection