config.example.json

{
  "_comment": "HotMic Configuration File - Examples and Options",

  "endpoint": "wss://f.gpty.ai/api/v1/ws",

  "_comment_hotkey": "Toggle mode: Press once to start, press again to stop",
  "hotkey": "<ctrl>+u",

  "_comment_autopaste": "Automatically paste transcript after recording (true/false)",
  "autopaste": true,

  "_comment_audio": "Audio settings - usually don't need to change these",
  "samplerate": 48000,
  "channels": 1,
  "block_samples": 24000,
  "input_device": null,
  "connect_timeout": 8.0,
  "stop_flush_wait": 0.5,

  "_comment_hold_mode": "Hold-to-talk: Hold key combo to record, release to transcribe",
  "enable_hold_mode": true,
  "hold_hotkey": "<cmd>+<alt>",

  "_comment_hold_hotkey_examples": [
    "Windows: '<cmd>+<alt>' means Windows key + Alt",
    "macOS: '<cmd>+<alt>' means Command + Option",
    "Other examples: '<ctrl>+<shift>', '<alt>+r'"
  ],

  "_comment_mouse": "Mouse button recording: Hold mouse button to record",
  "enable_mouse_button": true,
  "mouse_button": "middle",

  "_comment_mouse_button_options": "Options: 'left', 'middle', 'right'",

  "_comment_visual": "Show red recording indicator at top of screen",
  "show_visual_indicator": true,

  "_comment_vad": "Voice Activity Detection: Skip silent recordings",
  "enable_vad": true,
  "vad_energy_threshold": 500.0,
  "vad_min_speech_duration": 0.3,
  "silence_timeout": 2.0,

  "_comment_vad_explanation": [
    "enable_vad: Enable/disable voice activity detection",
    "vad_energy_threshold: Audio energy threshold (500.0 default, higher = less sensitive)",
    "vad_min_speech_duration: Minimum speech duration in seconds (0.3 default)",
    "silence_timeout: Reserved for future use"
  ],

  "_comment_mic_test": "Test microphone on startup to ensure it's working",
  "test_mic_on_startup": true
}