Common Issues

Common Issues and Solutions

This page covers the most frequently encountered issues with VoiceInk and provides step-by-step solutions.

License and Activation Issues

Lost or Missing License Key

If you've lost your license key or need to retrieve it:

1. Visit the Polar Portal: Go to https://polar.sh/beingpax/portal/request
2. Enter Your Email: Use the same email address you used when purchasing VoiceInk
3. Access Your Purchases: You'll receive a verification code to access your license information
4. Copy Your License Key: Once logged in, you can view and copy your license key

License Activation Problems

If you're unable to activate your current license:

• Check Device Limitations: Ensure you're not using the license on a previous device
• Verify Plan Limits: Your license is limited based on the plan you purchased
• Deactivate Previous Device: If you've used the license on another device, deactivate it first

For detailed license management information, see the License Management article.

Transcription Issues

Transcription Failing

If VoiceInk is unable to transcribe your speech:

• Check Microphone Permissions: Ensure VoiceInk has access to your microphone
• Verify Audio Input: Check that your microphone is working and selected in System Preferences
• Restart the Application: Sometimes a simple restart resolves audio detection issues

For more details, see Transcription Failing.

Transcription Taking Too Long

If transcription is slower than expected:

• Check Model Selection: Ensure you're using an appropriate model for your device
• Verify System Resources: Close other resource-intensive applications
• Consider Cloud Models: For Intel Macs, cloud models may provide better performance

Learn more in Transcription Taking Too Long.

Poor Transcription Quality

For accuracy issues:

• Use Power Mode: Enable Power Mode for context-aware transcription
• Check Model Settings: Ensure you're using the right model for your use case
• Review Personal Dictionary: Add custom words and phrases to improve recognition

Model and Language Issues

Model Changing Automatically

If your transcription model keeps switching:

• Check Power Mode Settings: Power Mode may be changing models based on context
• Review App-Specific Configurations: Check if you have different models set for different applications
• Disable Auto-Switching: You can turn off automatic model switching in preferences

See Model or Language Changing Automatically for more information.

Custom Model Problems

If you're having issues with custom Whisper models:

• Verify Model Format: Ensure your model is in the correct format
• Check File Location: Place models in the designated VoiceInk models folder
• Restart Application: Restart VoiceInk after adding new models

Enhancement and Power Mode Issues

Power Mode Not Working

If Power Mode isn't functioning as expected:

• Check Permissions: Ensure VoiceInk has accessibility permissions
• Verify App Detection: Make sure the target applications are properly detected
• Review Configuration: Check your Power Mode settings and rules

Enhancement Prompts Not Working

If AI enhancements aren't functioning:

• Verify Model Selection: Ensure you have a compatible model selected
• Check Internet Connection: Some features may require internet access
• Review Settings: Check your enhancement configuration

Still Need Help?

If you continue to experience issues:

1. Check Related Articles: Use the links above to find detailed articles
2. Contact Support: Contact me for personalized assistance
3. Check System Requirements: Ensure your Mac meets the minimum requirements

For immediate license retrieval, always start with the Polar Portal using your purchase email address.