Settings reference

Settings reference

Settings are organized into 8 sections in touch-frequency order, each with a brass section icon.

1. Voice & Playback (RecordVoiceOver)

• Voice library — engine-grouped picker for installing/swapping voices. ★ favorites surface to the top.
• Default speed — 0.5×–4× slider (#194).
• Default pitch — ±20% slider.

2. Reading (MenuBook)

• Theme — System / Light / Dark.
• Shake to extend sleep timer (#150) — when ON, shaking during the 10s fade tail re-arms the timer for 15 minutes. Disable for bumpy commutes.

3. Performance & Buffering (Speed)

• Warm-up Wait — ON shows a brass spinner during engine cold-start; OFF starts playback immediately and accepts brief silence (#98 Mode A).
• Punctuation Cadence — slider for inter-sentence pause (#90 / #109).
• Buffer (chunks) — render-ahead depth. Default 64. Experimental zone unlocks up to 3000 (#138).

4. AI (AutoAwesome)

• Active provider — Claude / Teams / OpenAI / Vertex / Bedrock / Foundry / Ollama. See AI chat.
• Per-provider model chips — pick which model to use within each provider.
• Chat grounding — toggles for what context the chat sees (chapter title, current sentence, full chapter, full book so far).
• Forget all AI settings — wipes keys + history.

5. Library & Sync (LibraryBooks)

• Royal Road (#221) — show/hide in Browse picker.
• GitHub (#221) — show/hide in Browse picker.
• Memory Palace (#221) — show/hide in Browse picker.
• Wi-Fi only — don't poll for new chapters on cellular.
• Update check interval — every 1–24h.

6. Account (AccountCircle)

• Royal Road — sign in / out via WebView. Unlocks Premium chapters and Follows sync.
• GitHub (#91) — OAuth Device Flow sign-in. Lifts the rate limit + unlocks My Repos / Starred / Gists tabs.
  • Enable private repos (#203) — opt-in, requires repo scope. Re-runs Device Flow on next sign-in.

7. Memory Palace (AutoStories)

• Host — palace URL (e.g. http://palace.local:9080).
• API key — bearer token.
• Test connection — probes the palace and surfaces health.
• Clear — wipes the credentials.

8. About (Info)

• Version + git hash + build time (realm-sigil).
• Repo link — opens GitHub.
• License — GPL-3.0.

DataStore keys

All preferences persist in storyvox_settings.preferences_pb. Voices preferences (favorites, last-used) live in a separate voices_settings.preferences_pb. The DataStore wipes only on uninstall + reinstall (or pm clear); upgrades preserve everything.