VoiceCraft
Client

Settings.json

Client settings file: Settings.json.

Settings.json

Client settings file: Settings.json.

File Location

  • Windows: %AppData%/voicecraft/Settings.json
  • Linux: ~/.config/voicecraft/Settings.json
  • macOS: ~/Library/Application Support/voicecraft/Settings.json
  • Android/iOS: inside the app sandbox directory (ApplicationData).

Example

{
  "UserGuid": "7f303d4a-5105-4b4f-9de4-2448f5ddf703",
  "ServerUserGuid": "6727d672-8f9f-4916-b960-26a3e0a9cd18",
  "InputSettings": {
    "InputDevice": "Default",
    "InputVolume": 1.0,
    "MicrophoneSensitivity": 0.04,
    "AutomaticGainController": "00000000-0000-0000-0000-000000000000",
    "Denoiser": "00000000-0000-0000-0000-000000000000",
    "EchoCanceler": "00000000-0000-0000-0000-000000000000"
  },
  "OutputSettings": {
    "OutputDevice": "Default",
    "OutputVolume": 1.0,
    "AudioClipper": "962fe030-08c3-4e21-a9c1-fcfea0745b6a"
  },
  "LocaleSettings": {
    "Culture": "en-US"
  },
  "NotificationSettings": {
    "DisableNotifications": false,
    "DismissDelayMs": 2000
  },
  "ServersSettings": {
    "HideServerAddresses": false,
    "Servers": [
      {
        "Name": "Local",
        "Ip": "127.0.0.1",
        "Port": 9050
      }
    ]
  },
  "ThemeSettings": {
    "SelectedBackgroundImage": "6b023e19-c9c5-4e06-84df-22833ccccd87",
    "SelectedTheme": "cf8e39fe-21cc-4210-91e6-d206e22ca52e"
  },
  "NetworkSettings": {
    "PositioningType": 0,
    "McWssListenIp": "127.0.0.1",
    "McWssHostPort": 8080
  },
  "UserSettings": {
    "Users": {}
  }
}

Important Ranges

  • InputVolume: 0..2
  • OutputVolume: 0..2
  • MicrophoneSensitivity: 0..1
  • Servers[].Name: up to 12 chars
  • Servers[].Ip: up to 30 chars
  • Servers[].Port: 1..65535
  • McWssHostPort: 0..65535 (recommended >1024)

Positioning Mode (NetworkSettings.PositioningType)

  • 0 — Server
  • 1 — Client

This value must match VoiceCraftConfig.PositioningType on the server.

Copyright © 2026