# TotalRecall Configuration Example # Copy this to ~/.totalrecall.yaml or ~/.config/totalrecall/config.yaml # Audio configuration audio: # Gemini is the default audio provider. Set this to openai to switch back. provider: gemini # Gemini TTS writes WAV natively and auto-converts to MP3 by default to save space. format: mp3 # OpenAI TTS settings (used only when audio.provider is openai) openai_key: ${OPENAI_API_KEY} # Can also use environment variable openai_model: gpt-4o-mini-tts # Options: tts-1, tts-1-hd, gpt-4o-mini-tts openai_speed: 0.9 # Range: 0.25 to 4.0 (may be ignored by gpt-4o-mini-tts) openai_instruction: "You are speaking Bulgarian language (български език). Pronounce the Bulgarian text with authentic Bulgarian phonetics, not Russian. Speak slowly and clearly for language learners." # Gemini TTS settings (used when audio.provider is gemini) gemini_tts_model: gemini-2.5-flash-preview-tts gemini_voice: "" # Leave empty to pick a random Gemini voice # Translation configuration translation: # Translation backend used by internal/translation/translator.go # Supported values: gemini (default) or openai provider: gemini # Phonetic configuration phonetic: # IPA phonetic backend used by internal/phonetic/fetcher.go # Supported values: gemini (default) or openai provider: gemini # Image configuration image: # Preferred Google API key location for Gemini translation, phonetics, and Nano Banana. # google.api_key is still supported for older configs. google_api_key: ${GOOGLE_API_KEY} # Nano Banana is the GUI default and the recommended image provider for config-driven runs. provider: nanobanana # Nano Banana settings nanobanana_model: gemini-3.1-flash-image-preview nanobanana_text_model: gemini-2.5-flash # Output configuration output: directory: ~/Downloads