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. Includes Piper (45), Kokoro (53), and — once configured — Azure HD (20).
• Default speed — 0.5×–4× slider (#194). Per-voice defaults persist (#195).
• Default pitch — ±20% slider. Per-voice defaults persist (#195).
• Azure — BYOK setup for Azure Cognitive Services HD voices (#182–#186).
  • Key (paste from Azure portal)
  • Region (e.g. eastus, westeurope)
  • Test connection — round-trips the synthesis API to validate
  • Offline fallback voice — local voice to use if Azure errors mid-chapter

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). On Kokoro, also drives the model's silence_scale for within-sentence breaths (#196).
• Buffer (chunks) — render-ahead depth. Default 64. Experimental zone unlocks up to 3000 (#138). Slider takes effect mid-listen.
• Engines (Tier 3) — 1–8 parallel VoxSherpa instances. Each adds ~50 MB RAM (Kokoro). Bump first when synthesis falls behind.
• Threads / engine (Tier 3) — thread-pool size per engine instance. Bump after Engines if you still need throughput.

The producer thread is pinned to URGENT_AUDIO priority so it doesn't get descheduled mid-chapter.

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).
• Sessions (#218) — review past chats, delete sessions, jump back into one.
• Read aloud per assistant turn (#214) — toggle the inline read-aloud button on chat replies.
• 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.
• RSS feeds (#236) — show/hide in Browse picker.
• EPUB folder (#235) — show/hide in Browse picker. Choose folder picks the source folder via SAF.
• Outline (#245) — show/hide in Browse picker. URL + API token + Test connection.
• Wi-Fi only — don't poll for new chapters on cellular. First-launch defaults RSS-only on, perf toggles off (#246 follow-up).
• 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.