Configuration

Lite Suite is designed to work out of the box. All settings are accessible from the Settings panel inside the app.

Appearance

Themes

9 preset themes with Abyss (ultra-dark) as the default:

• Abyss, Oscura Midnight, Oscura Twilight, Oscura Charcoal
• Light, High Contrast
• Custom themes via 17 color tokens

Visual Effects

• EmberSparks — ambient particle effects (toggle on/off)
• Glass blur — frosted glass panel backgrounds
• Accent color — picker for custom accent throughout the UI
• Motion reduction — disable animations for accessibility
• UI zoom — 70% to 160% scaling

Voice Pipeline

Configure in Settings > Voice:

• Hotkey — key combination for dictation
• STT model — Whisper model size (tiny/base/small/medium)
• TTS voice — voice selection and speed
• LLM refinement — toggle and provider selection
• Wake detection — enable hands-free activation

API Keys

Configure AI provider keys in Settings > AI:

• Claude API key
• OpenAI API key
• Google Gemini API key
• Local model endpoint (LM Studio, Ollama, etc.)

Port Configuration

All ports are configurable via environment variables:

| Variable | Default | Service | |----------|---------|---------| | LITESUITE_PORT | 3773 | Backend server | | LITESUITE_TTS_PORT | 5123 | TTS server | | LITESUITE_WHISPER_PORT | 8080 | Whisper STT | | LITESUITE_VOICE_API_PORT | 7438 | Voice API |

Data Locations

| Data | Location | |------|----------| | App settings | ~/.litesuite/ | | SQLite databases | ~/.litesuite/db/ | | LCM memory | ~/.litememory/lcm.db | | Agent identity | ~/.litesuite/agent/ | | Obsidian vault | Configured in Settings |

Keybindings

Default keybindings follow VS Code conventions. Customize in Settings > Keybindings:

| Action | Default | |--------|---------| | Add panel | Ctrl+Shift+N | | Command palette | Ctrl+Shift+P | | Toggle zen mode | Ctrl+Shift+Z | | Toggle sidebar | Ctrl+B | | Quick file open | Ctrl+P |

Troubleshooting

Settings don't persist after restart. Check that the ~/.litesuite/ directory is writable.

Port conflicts on startup. Another application is using the same port. Change the port via environment variables or stop the conflicting process.