Settings & Troubleshooting

Settings Overview

OpenVoiceLink settings are organized into tabs for easy navigation:

General Tab

• Audio Input: Microphone selection and sensitivity
• Audio Output: Speaker selection and volume
• Voice Activation: Push-to-Talk or Continuous Listening
• AI Provider: Choose between OpenRouter, Local Model, or other services
• Interface: Theme, font size, transparency settings

OpenRouter Tab

• API Configuration: API key and connection settings
• Model Selection: Choose from available models
• Cost Management: Monitor and manage API usage

Local Model Tab

• Ollama Configuration: Server URL and connection settings
• Model Management: Select and configure local models

TTS Tab

• TTS Provider Selection: Supertonic, Web Speech API, or eSpeak NG
• Voice Configuration: Voice selection, speed, and pitch

Hotkeys Tab

• System Hotkeys: Toggle listening, open settings, toggle fullscreen
• Custom Hotkeys: Create your own shortcuts

Configuration Files

OpenVoiceLink stores settings in a JSON file:

• Windows: %APPDATA%\OpenVoiceLink\settings.json
• Manual Configuration: Edit with text editor when app is closed
• Backup/Restore: Copy settings.json to backup location

Troubleshooting Guide

Quick Troubleshooting Checklist

• Restart OpenVoiceLink: Close and reopen the application
• Check Internet Connection: Ensure stable connection
• Update the App: Make sure you're using the latest version
• Run as Administrator: Right-click and "Run as administrator"

Common Issues and Solutions

Voice Input Issues

• Microphone Not Detected: Check Windows privacy settings for microphone access
• Poor Voice Recognition: Speak clearly and reduce background noise
• App Keeps Cutting Me Off: Increase silence timeout in settings

Voice Output Issues

• No Audio from AI Responses: Check speaker selection and test output
• AI Voice Sounds Robotic: Switch to Supertonic TTS for better quality

AI Service Issues

• "API Key Invalid" Error: Verify API key is correct (no extra spaces)
• Slow AI Responses: Try a smaller model or local models

Application Issues

• Windows blocked the app: Right-click the .exe, choose "Properties", check "Unblock", then click "Apply"
• Settings Not Saving: Check file permissions on settings.json
• Memory Usage is High: Reduce cache size in settings

FAQ

Why does Windows say the app is dangerous?

The app is not code-signed, so Windows SmartScreen may block it. Right-click the .exe, choose "Properties", check "Unblock", then click "Apply".

Best Practices

Performance Optimization

• Cache Size: Reduce cache size if memory is limited
• Model Selection: Use smaller models for better performance
• Network Optimization: Ensure stable internet connection

Recommended Settings

• For Beginners: System theme, Push-to-Talk with Spacebar, Supertonic TTS
• For Power Users: Dark theme, Continuous listening, Claude 3.5 model
• For Low-End Systems: Light theme, Push-to-Talk, eSpeak NG, smaller local model