Common Issues
This page lists frequent LinguaX issues and a practical recovery order you can follow step by step.
Mouse-Related Problems
Mouse+ enhancement is the core of LinguaX. Scrolling, side buttons, gestures, pointer speed, and device recognition issues have their own dedicated page:
The sections below cover input-source switching and automation.
1) Input Source Does Not Switch
Quick checks:
- LinguaX is running in menu bar.
- Rule is enabled.
- App/domain text matches exactly.
Fix steps:
- Keep one rule for the failing context.
- Remove overlaps.
- Test by switching away and back.
2) Browser Domain Rule Does Not Trigger
Quick checks:
- Correct browser selected.
- Domain typed correctly.
- Rule is enabled.
Fix steps:
- Recreate rule with exact domain.
- Keep browser app default simple.
- Retest with two clearly different domains.
3) Shortcut Script Action Fails
Quick checks:
- Shortcut is not captured by another app.
- Script action is mapped correctly.
Fix steps:
- Run one built-in template first.
- Approve macOS Automation prompt when shown.
- Retry custom script.
4) Behavior Changed After Update
Quick checks:
- Restart LinguaX.
- Check release notes for migration notes.
Fix steps:
- Wait for first-launch migration to finish.
- Retest minimal rules.
- Add rules back gradually.
5) Permission-Related Problems
Fix steps:
- Re-enable missing permissions in macOS settings.
- Relaunch LinguaX.
- Test one app rule and one domain rule.
Recommended Debug Order
- App running state.
- Permissions.
- Exact app/domain match.
- Rule overlap cleanup.
- Minimal retest.