chore: add config docs, all setting, and normalize volume defaults to 1

Author: goodroot

README.md

@@ -211,6 +211,7 @@ After installation, use the `hyprwhspr` CLI to manage your installation:
     - `--no-systemd` - Skip systemd service setup
     - `--hypr-bindings` - Enable Hyprland compositor bindings
 - `hyprwhspr config` - Manage configuration (init/show/edit)
+  - `hyprwhspr config show --all` - Show all settings including defaults
 - `hyprwhspr waybar` - Manage Waybar integration (install/remove/status)
 - `hyprwhspr mic-osd` - Manage microphone visualization overlay (enable/disable/status)
 - `hyprwhspr systemd` - Manage systemd services (install/enable/disable/status/restart)

docs/CONFIGURATION.md

@@ -4,6 +4,25 @@ Perform basic setup and configuration via `hyprwhspr setup`.
 
 Or use the CLI, or edit `~/.config/hyprwhspr/config.json` directly.
 
+The config file uses **sparse storage** and will only contain values you've explicitly changed from the defaults. This keeps your config clean and means upstream default changes apply automatically on update.
+
+There is also a `$schema` reference for IDE autocompletion and validation:
+
+```jsonc
+{
+    "$schema": "https://raw.githubusercontent.com/goodroot/hyprwhspr/main/share/config.schema.json",
+    "transcription_backend": "rest-api",
+    "language": "en"
+}
+```
+
+To view your overrides or the full resolved config:
+
+```bash
+hyprwhspr config show        # Show your overrides only
+hyprwhspr config show --all  # Show all settings including defaults
+```
+
 ## Minimal configuration
 
 Only 2 essential options:

lib/cli.py

@@ -85,7 +85,8 @@ def main():
     config_parser = subparsers.add_parser('config', help='Configuration management')
     config_subparsers = config_parser.add_subparsers(dest='config_action', help='Config actions')
     config_subparsers.add_parser('init', help='Create default config')
-    config_subparsers.add_parser('show', help='Display current config')
+    config_show_parser = config_subparsers.add_parser('show', help='Display current config')
+    config_show_parser.add_argument('--all', action='store_true', dest='show_all', help='Show all settings including defaults')
     config_subparsers.add_parser('edit', help='Open config in editor')
 
     # waybar command
@@ -222,7 +223,7 @@ def main():
             if not args.config_action:
                 config_parser.print_help()
                 sys.exit(1)
-            config_command(args.config_action)
+            config_command(args.config_action, show_all=getattr(args, 'show_all', False))
         elif args.command == 'waybar':
             if not args.waybar_action:
                 waybar_parser.print_help()

lib/src/cli_commands.py

@@ -2172,12 +2172,12 @@ def omarchy_command(args=None):
 
 # ==================== Config Commands ====================
 
-def config_command(action: str):
+def config_command(action: str, show_all: bool = False):
     """Handle config subcommands"""
     if action == 'init':
         setup_config()
     elif action == 'show':
-        show_config()
+        show_config(show_all=show_all)
     elif action == 'edit':
         edit_config()
     elif action == 'secondary-shortcut':
@@ -2240,17 +2240,18 @@ def setup_config(backend: Optional[str] = None, model: Optional[str] = None, rem
             log_error(f"Failed to update config: {e}")
 
 
-def show_config():
+def show_config(show_all: bool = False):
     """Display current config"""
-    config_file = USER_CONFIG_DIR / 'config.json'
-    
-    if not config_file.exists():
-        log_error("Config file not found. Run 'hyprwhspr config init' first.")
-        return
-    
     try:
-        with open(config_file, 'r', encoding='utf-8') as f:
-            config = json.load(f)
+        if show_all:
+            config = ConfigManager().get_all_settings()
+        else:
+            config_file = USER_CONFIG_DIR / 'config.json'
+            if not config_file.exists():
+                log_error("Config file not found. Run 'hyprwhspr config init' first.")
+                return
+            with open(config_file, 'r', encoding='utf-8') as f:
+                config = json.load(f)
         print(json.dumps(config, indent=2))
     except (json.JSONDecodeError, IOError) as e:
         log_error(f"Failed to read config: {e}")

lib/src/config_manager.py

@@ -80,10 +80,10 @@ def __init__(self):
             'onnx_asr_use_vad': True,                    # Use VAD for long recordings (>30s)
             # Audio feedback settings
             'audio_feedback': False,             # Play sounds on recording start/stop/error
-            'audio_volume': 0.5,                 # Master audio feedback volume (0.0-1.0)
+            'audio_volume': 1.0,                 # Master audio feedback volume (0.0-1.0)
             'start_sound_volume': 1.0,           # Volume multiplier for start sound
             'stop_sound_volume': 1.0,            # Volume multiplier for stop sound
-            'error_sound_volume': 0.5,           # Volume multiplier for error sound
+            'error_sound_volume': 1.0,           # Volume multiplier for error sound
             'start_sound_path': None,            # Custom path for start sound (None = built-in ping-up.ogg)
             'stop_sound_path': None,             # Custom path for stop sound (None = built-in ping-down.ogg)
             'error_sound_path': None,            # Custom path for error sound (None = built-in ping-error.ogg)

share/config.schema.json

@@ -253,7 +253,7 @@
       "type": "number",
       "minimum": 0,
       "maximum": 1,
-      "default": 0.5,
+      "default": 1.0,
       "description": "Master audio feedback volume (0.0-1.0)"
     },
     "start_sound_volume": {
@@ -274,7 +274,7 @@
       "type": "number",
       "minimum": 0,
       "maximum": 1,
-      "default": 0.5,
+      "default": 1.0,
       "description": "Volume multiplier for error sound"
     },
     "start_sound_path": {