assets/config.yaml.example


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49

# 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