Common Issues
This page lists frequent LinguaX problems and the fastest recovery order.
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.