The short answer: Check system microphone permissions, select the right device in AICHE settings, and test with the Space bar before using the global hotkey.
Most microphone problems are permission or device selection issues that take 2 minutes to fix.
Quick Diagnosis
Identify your issue:
- No input - AICHE shows no audio levels
- Wrong device - Using built-in mic instead of headset
- Poor quality - Transcription has many errors
- Permission denied - Can't access microphone
Common Solutions
Check Permissions
macOS:
- System Settings → Privacy & Security → Microphone
- Ensure AICHE is checked
- Restart AICHE after granting permission
Windows:
- Settings → Privacy → Microphone
- Toggle "Allow apps to access microphone" ON
- Find AICHE in list and enable
- Restart AICHE
Linux:
Check if running in sandbox:
# Flatpak
flatpak override --user --device=all com.aiche.app
# Snap
snap connect aiche:audio-record
Select Correct Microphone
AICHE might be using wrong input:
- Open AICHE window
- Go to Settings
- Select your microphone from dropdown
- Test with Space bar in the app
Common devices:
- Built-in Microphone (laptop)
- USB Audio Device (external mic)
- Headset (Bluetooth or wired)
- Webcam microphone
Test Recording
Before using global hotkey:
- Click in AICHE's main window
- Press Space bar to start recording
- Speak clearly
- Press Space again to stop
- Check if text appears
If this works but global hotkey doesn't, it's a hotkey permission issue.
Platform-Specific Issues
macOS
"AICHE would like to access the microphone"
- System Settings → Privacy & Security → Microphone
- Add AICHE to allowed apps
- Quit AICHE completely (Cmd+Q) and restart
Global hotkey not working
- System Settings → Privacy & Security → Accessibility
- Grant AICHE accessibility permission
- This allows hotkey to work system-wide
Windows
Microphone blocked by antivirus
- Check antivirus settings
- Add AICHE to exceptions
- Windows Defender: Settings → Virus & threat protection → Exclusions
Can't hear any input
- Right-click speaker icon → Sound settings
- Under Input, check volume level
- Click "Test your microphone"
Linux
No audio with PulseAudio
# Check if mic is muted
pactl list sources | grep Mute
# Unmute
pactl set-source-mute @DEFAULT_SOURCE@ 0
# Set volume to 80%
pactl set-source-volume @DEFAULT_SOURCE@ 80%
PipeWire issues
# Restart PipeWire
systemctl --user restart pipewire
# Check if AICHE sees the device
pw-cli list-objects | grep alsa
Audio Quality Tips
Environment
- Find quiet space
- Stay 6-8 inches from microphone
- Avoid echo-prone rooms
- Close windows to reduce street noise
Speaking Technique
- Speak at normal pace
- Don't over-enunciate
- Maintain consistent volume
- Complete your thoughts before stopping
Hardware
- USB microphones work better than built-in
- Wired headsets beat Bluetooth for quality
- Position mic to side of mouth to avoid breathing sounds
Bluetooth Issues
Bluetooth can cause problems:
- Latency: Slight delay in recording
- Quality: Lower than wired connections
- Battery: Low battery affects performance
Solutions:
- Keep device within 10 feet
- Charge headset above 20%
- Disconnect other Bluetooth devices
- Use wired connection for important recordings
Still Not Working?
Basic Checks
- Test microphone in another app (Voice Recorder, Zoom)
- Restart computer
- Update audio drivers
- Check physical mute button on headset
AICHE-Specific
- Completely quit AICHE (not just close window)
- Restart AICHE
- Try Space bar recording first
- Then test global hotkey
Contact Support
If nothing works:
- Email [email protected]
- Include your OS version
- Describe when issue occurs
- List your audio devices
Prevention
To avoid future issues:
- Keep AICHE updated
- Don't change audio devices during recording
- Test weekly with Space bar
- Grant all permissions during setup
Heads-up: Changing default system microphone while AICHE is running requires restart.
The pro-tip: Create a test document and practice with Space bar recording before relying on the global hotkey for important work.
Result: 95% of microphone issues are fixed by checking permissions and device selection.
Do this now: Open AICHE, press Space bar, say "Microphone test," and verify you see the text appear.
