Changelog

This page tracks notable LinguaX app release notes, including input switching, mouse enhancement, smooth scrolling, and gesture updates.

2025.12.5013

Summary: Wired Logitech G-series mice (like the G502 HERO) now support button capture and custom mappings, the G502 family's button layouts are corrected, your saved DPI is restored automatically after reconnects, and background power usage is lower.

New features

• Wired Logitech G-series support: USB-connected G-series mice (G502 HERO and siblings) can now capture buttons and run custom mappings, on par with their wireless counterparts.
• G102 LIGHTSYNC support: buttons are recognized and mappable; the DPI button becomes configurable once remapped in G HUB.

Improvements

• Faster, steadier G-series recovery: waking from sleep or replugging a receiver re-arms button capture quickly, and your saved DPI is restored automatically when the device comes back online.
• Corrected G502 family layouts: side buttons and the tilt wheel on G502 X models now map to the right physical buttons; legacy G502 layouts fixed too.
• Lighter background footprint: mouse-movement tracking now runs only when needed, and device event handling uses less CPU.
• Clearer settings layout: keyboard and mapping groups expand as full rows, and app icons are larger and sharper.

Fixes

• Fixed cases where a DPI slider change could be ignored or overwritten.
• Fixed an occasional glitch where app icons in settings displayed incorrectly.
• Several stability fixes for setups with multiple mice or receivers connected at once.

2025.12.5005

Summary: A big quality release — a redesigned first-run permission onboarding, one-click import/export for your mouse mappings, faster input switching in Safari and Chromium (no more AppleScript polling), and a ground-up rework of the Bluetooth / HID layer for steadier reconnects, wake-ups, and multi-device setups.

New features

• Redesigned first-run onboarding: a clearer step-by-step permission flow with better visuals, live status hints, and full localization in 9 languages. Walks you through Accessibility and Input Monitoring, then hands you off cleanly to the main app.
• Mouse config import / export: back up your entire mouse mapping setup to a file, or move it to another Mac. Import shows a preview and lets you choose merge or overwrite. Default location is ~/Downloads.
• Fresh app icon: updated to the new LinguaX logo.

Improvements

• Safari tab-aware input switching: switching between Safari tabs on different sites now switches your input source correctly (previously it could stick to the last tab's language).
• Snappier Chromium URL switching: Chrome / Edge / Arc / Brave now react to page changes the moment they happen, instead of being polled. Also lighter on CPU.
• Steadier reconnects and wake-ups: the Bluetooth / HID plumbing was reworked from the ground up. Waking from sleep, plugging / unplugging receivers, and switching Easy-Switch channels are all more reliable, especially with multiple mice connected at once.
• Steadier action feedback HUD: the on-screen action marker no longer drifts or jitters on its first frame, and stays put across the screen edge.
• Cleaner permission handling during onboarding: the app no longer triggers surprise system permission prompts while you're still in the setup flow.

Fixes

• Fixed a case where the shortcut-recording popup could silently ignore key presses.
• Fixed a case where a stale connection on one Bluetooth mouse could disturb writes to other connected mice.
• Fixed several rare crashes tied to disconnect / reconnect churn and waking from sleep.
• Fixed a case where reloading action mappings could leave a "held" button stuck across devices.
• Restored missing "Not now" / "I'll restart later" translations and polished onboarding copy across all 9 languages.

2025.12.4866

Summary: Fixes the Logitech scroll-mode (SmartShift) button on setups where it previously wouldn't respond — mice without a thumb button (MX Anywhere 3) and setups with multiple Unifying receivers — plus reliable shortcut triggering in Final Cut Pro and other pro apps, new M750 / M750 L support, and richer screenshot actions.

New features

• Logitech M750 / M750 L support: buttons on the M750 and M750 L are now recognized and mappable.
• Identified side buttons on virtual mouse: the virtual mouse view now labels each recognized side button, making it easier to see which button you're configuring.
• Richer screenshot actions: two new "copy to clipboard" screenshot variants added, and five existing screenshot actions renamed to match the system Screenshot menu for easier discovery.

Improvements

• Clearer empty-state hint: the mouse mapping panel now tells you a single button can hold multiple gestures, removing the impression that only one is allowed.
• Softer unrecognized-device prompt: the setup prompt for unknown devices is less alarming and clearer about what will happen next.
• No feedback HUD on Space switch: the on-screen action marker no longer flashes when switching Spaces, so the transition stays clean.
• Quieter Bluetooth polling: devices that don't support HID++ DPI / scroll-mode probes are no longer polled endlessly, cutting background load and saving power.
• Improved German localization: German UI strings polished across the app.

Fixes

• Fixed the scroll-mode (SmartShift) key not working on Logitech mice without a thumb button (e.g. MX Anywhere 3).
• Fixed the scroll-mode key failing when several Unifying / Bolt receivers are plugged in at once.
• Fixed mapped shortcuts silently failing in Final Cut Pro and other apps that require device-level modifier flags.
• Fixed a stray "empty action" feedback marker that could briefly appear on screen.
• Fixed a rare startup crash when connecting a Logitech Bluetooth mouse while the app is launching.
• Fixed a small memory leak when unregistering keyboard action triggers.
• Fixed spurious action-mapping reloads when refreshing DPI or battery status.

2025.12.4861

Summary: A reliability-focused release for Logitech Bluetooth mice — buttons recover faster and more dependably after an Easy-Switch hand-off or waking from sleep — plus on-screen action feedback and expanded modifier-hold.

New features

• Action feedback: a small marker briefly appears at the bottom-center of the screen when a mapped keyboard/mouse action fires, so you can tell it triggered (toggle off in Settings).
• Expanded Modifier Hold: ⌘ / ⌃ / ⇧ / ⌥ now all support "hold to apply, release to restore" (previously Fn only).
• Cleaner input-source rules: App / Web rules now use a clearer segmented switch.

Improvements

• Faster Bluetooth recovery: Logitech Bluetooth mice restore the scroll-mode key, side buttons and more faster and more reliably after an Easy-Switch hand-off or waking from sleep.
• DPI persists: Bluetooth mouse DPI now keeps your set value after restart / wake instead of falling back to default.
• No first-press delay: fixed a delay on the first button press after the mouse had been idle for a while.
• Steadier connection: overall improvements to Bluetooth connection stability and power use.

Fixes

• Fixed occasional unexpected quits when using Logitech Bluetooth mice — the Bluetooth layer was reworked from the ground up to be more stable.
• Fixed a rare startup crash — a database load failure now recovers safely instead of quitting the app.

2025.12.4850

Summary: Adjust your Logitech mouse's DPI and scroll-wheel mode right inside the app — no official driver needed — plus run Apple Shortcuts from mouse buttons and keyboard mappings, and a new option to hide the menu bar icon.

New features

• Adjust mouse DPI: set your Logitech mouse pointer speed (DPI) with a slider directly in the app, over both USB and Bluetooth, without installing the official driver.
• Toggle scroll-wheel mode: a new "Toggle Scroll Wheel Mode" action switches between free-spin and ratchet scrolling in one click (Logitech SmartShift).
• Run Apple Shortcuts: both mouse buttons and keyboard mappings can now run your Apple Shortcuts.
• Hide the menu bar icon: an option in Settings hides the top menu bar icon for a cleaner look; reopening the app restores it.

Improvements

• Tidied up the action menu: "Open Application" now lives under the "Apps & Windows" submenu, and Shortcuts sits on its own at the end, making actions easier to find.
• More reliable Bluetooth capability detection: DPI and scroll-wheel probing now retries and resets on failure for steadier reads on Bluetooth mice.

Fixes

• Fixed Logitech M720 and similar devices being ignored — composite Bluetooth devices that declare both mouse and keyboard are now recognized correctly.
• Fixed already-bound combos getting disabled during recording — keyboard triggers are no longer permanently turned off while recording a mouse shortcut.
• Fixed flicker and stutter in the Shortcuts picker for a smoother, more stable list.
• Fixed several scroll-wheel mode toggle glitches around rapid double-clicks and reconnects.

2025.12.4845

Summary: A big upgrade to mouse-button keyboard shortcuts — record richer combos (including ones that were previously impossible), plus a new Open Application action and Logitech Lift support.

New features

• Mouse buttons can now record Fn-based combos, such as Fn + Space.
• Mouse buttons can be set to send a single modifier key (like Fn) with a quick press.
• Added an "Open Application" action to launch a chosen app from a mouse button.
• Added Logitech Lift support.

Improvements

• You can now record shortcuts that are already in use. Even if a combo such as ⌘⇧V is already bound to another shortcut, recording it for a mouse button now works correctly instead of capturing only the modifiers.
• Clearer shortcut display: a standalone modifier now shows as an icon plus label.
• Redesigned the device Diagnostics Center with a cleaner layout and one-tap diagnostics export, making device issues easier to investigate and report.

Fixes

• Fixed the battery indicator flickering between green and red on some Logitech devices.
• Fixed the Stage Manager action not running.
• Removed non-functional checkmarks from some menu items to avoid confusion.
• Fixed repeated clicks opening multiple app-picker panels.

2025.12.4834

Summary: New side-button swipe and modifier-hold gestures, fluid Space switching, and more reliable licensing across system upgrades and iCloud changes.

New features

• Added swipe trigger modes for side-button drags, so dragging a side button up/down/left/right can trigger different actions, with a clear on-screen mode indicator.
• Added a modifier-hold mouse gesture that triggers an action while a modifier is held — ideal for push-to-talk voice input tools like Typeless, where the action stops as soon as you release.
• Added fluid, trackpad-like Space switching for smoother desktop transitions with your mouse.

Improvements

• Redesigned device licensing so activation stays valid after macOS upgrades, iCloud account changes, or device migration.
• Improved horizontal scrolling reverse and compatibility for more consistent behavior across apps.
• The running-apps list now refreshes automatically when apps launch or quit, making per-app setup easier.
• Optimized settings UI rendering for smoother scrolling in the app scope switcher.

Fixes

• Fixed cases where smooth scrolling could stop working.
• Fixed app-specific overrides that could swallow events in other apps.
• Fixed horizontal-scroll button ID parsing in app override configurations.

2025.12.4816

Summary: Per-app smooth scrolling, steadier mouse gestures, and improved side-button/device recognition.

New features

• Added per-app smooth scrolling controls so each app can have a scrolling behavior that fits how you use it.
• Added Logitech G502 X recognition for more accurate model detection and setup.

Improvements

• Improved mouse gesture timing so drag and swipe actions feel more predictable during daily use.
• Improved automatic side-button mapping for recognized mice, reducing manual setup after detection.
• Refined mouse enhancement controls and improved About page icon appearance in dark mode.

Fixes

• Fixed thumb-button and wheel-tilt setup issues affecting some mouse models, including MX Master 3.
• Fixed smooth scrolling edge cases so scroll distance remains more natural when smoothing is disabled or bypassed.
• Fixed gesture coordination issues that could make complex mouse actions trigger inconsistently.

2025.12.4811

Summary: Clearer media-control organization, broader key-trigger coverage, and stronger mouse compatibility.

New features

• Added a dedicated Media Control category so playback and volume actions are easier to find and configure.

Improvements

• Reorganized system-setting action types into clearer groups for faster action selection.
• Expanded keyboard trigger support with more navigation and consumer/media keys.
• Unified media-control icon semantics to improve recognizability across menus.

Fixes

• Improved button recognition and mapping stability for devices like MX Master 2S and M585.
• Fixed inconsistent default selection behavior in system-setting menus.

2025.12.4805

Summary: Better shortcut recording flexibility and clearer wheel-tilt localization across languages.

Improvements

• Allowed plain key bindings in the mouse shortcut recorder, so single-key triggers can be recorded directly.
• Improved localization for wheel tilt left/right labels to make direction semantics clearer in multilingual UI.

2025.12.4803

Summary: Stability-focused update for smoother long-running use and a better reopen experience.

Improvements

• Improved long-session stability for smoother daily use.
• Improved responsiveness during frequent mouse interactions.
• Improved overall runtime consistency for extended sessions.

Fixes

• Fixed an issue where memory usage could keep rising in some long-running scenarios.
• Fixed an occasional issue where reopening from Dock did not show the status window.

2025.12.4801

Summary: Expanded system actions, clearer categorized picker UX, and completed multilingual action translations.

New features

• Expanded built-in system actions to cover window controls, editing, screenshot, navigation, and developer workflows.
• Added categorized action picker groups (System Features, Apps & Windows, Document Editing, Finder Actions, Screenshot & Recording, Tabs & Navigation, Developer).
• Added category/action icons in picker menus for faster scanning and selection.

Improvements

• Improved action picker interaction and width behavior for better readability in the button panel.
• Moved Switch Space Left/Right into System Features for more accurate semantics.
• New Finder Window now opens Home by default.

Localization

• Completed missing translations for system-action category and action labels across supported locales.

Fixes

• Stabilized Copy File Path behavior by using the native Cmd+Option+C path.
• Stabilized Move to Trash behavior by using the native Cmd+Delete path.

2025.12.4701

Summary: Multi-device stability, full BLE HID++ support, and per-app gesture override.

New features

• Added per-app gesture override: configure button behaviors for specific apps independently from global settings.
• Added full BLE HID++ support for Logitech wireless mice via Bluetooth, enabling complete gesture and button mapping.
• Added MX Anywhere 3S thumb-button (SM key) support.
• Added a "Clear model binding" button in device settings to reset device recognition easily.

Improvements

• Improved multi-mouse stability: each mouse now has fully isolated button and gesture state, preventing cross-device conflicts.
• Tuned double-click detection to align with system settings for more natural trigger behavior.
• Bluetooth devices now recover automatically after sleep/wake without requiring manual reconnection.
• Reduced CPU usage by optimizing mouse-movement event handling in the background.

Fixes

• Fixed gesture states conflicting between multiple simultaneously connected mice.
• Fixed BLE mouse thumb-button mapping failing in some scenarios.
• Fixed button mappings occasionally becoming inactive after switching apps.
• Fixed device configuration not fully taking effect after clearing settings.

2025.12.4614

Summary: Full thumb-button gesture support, per-device pointer speed persistence, and a major HID runtime reliability pass.

New features

• Added full SM thumb-button gesture support with stronger mapping coverage for click, double-click, long-press, and swipe actions.
• Added per-device pointer speed persistence, so each mouse keeps its own speed profile.
• Added immediate pointer speed application through a lower-level system path, without app restart.

Improvements

• Replaced timer-based SM polling with event-driven HID++ reads for lower latency and better efficiency.
• Split blocking HID++ reads out of the serial queue to improve runtime responsiveness under load.
• Added automatic CGEvent tap recovery on system timeout to reduce gesture detection dropouts.
• Improved lifecycle safety by always closing IOHIDManager to avoid long-run Mach port leaks.
• Tuned double-click detection windows for more reliable trigger behavior.

Fixes

• Fixed virtual press state being interrupted by physical button input.
• Fixed intermittent gesture detection loss caused by timeout edge cases.
• Fixed MX Anywhere 2/2S/3 and MX Master 3S product ID/WPID normalization and mapping inconsistencies.
• Fixed M720 thumb button behavior to keep unsupported gestures from misfiring.

2025.12.4601

Summary: Major reliability upgrade for sleep/wake recovery, HID stability, and unified input runtime.

New features

• Added per-axis reverse scroll controls, so horizontal and vertical scrolling can be configured independently.
• Added stronger recovery strategy: refresh permissions and critical service states on app activation and system wake.
• Expanded mouse model recognition and improved readability for rule page icons and dark mode.

Improvements

• Reworked sleep/wake recovery flow to restore critical services and refresh permission state automatically.
• Optimized HID device enumeration using IOKit paths for more stable recognition and less enumeration jitter.
• Unified side buttons, long-press, and gesture semantics into one runtime engine.
• Unified keyboard recorder logic for special keys for more consistent recording and display.
• Enhanced diagnostics (real-time events and export flow) for troubleshooting; disabled by default.

Fixes

• Fixed horizontal gesture mapping not following reverse-scroll settings correctly.
• Fixed occasional smooth scrolling failure after sleep/wake.
• Fixed unmapped mouse buttons still being intercepted.
• Fixed diagnostics center button layout, window sizing, and multilingual UI details.

Notes

• This release includes an input module refactor. Diagnostics are intended for troubleshooting and remain disabled by default.

2025.12.4500

Summary: Better Logitech and connectivity support, plus battery and shortcut action enhancements.

New features

• Added two shortcut actions: open Control Center and Notification Center.
• Added Bluetooth mouse battery level display.
• Added support for configuring more side buttons, with improved multilingual coverage.

Improvements

• Improved Logitech MX Master 3S support: correct wheel mode switch key display and more accurate button recognition.
• Improved Bluetooth and receiver connectivity: faster device recognition, more accurate battery reporting, and better connection stability.
• Expanded automatic mouse model identification for more precise configuration.
• Added full thumb-button gesture support: single click, double click, swipe, and long press.
• Preserved default system mouse behavior when enhancement features are disabled.
• Improved isolation between multiple connected mice so device mappings do not interfere.

Fixes

• Fixed incorrect left/right wheel tilt direction mapping.
• Fixed device count display on the home page.
• Fixed rule count display on the home page.

2025.12.4401

Summary: Improved button configuration workflow with a new shortcut recorder and stronger mapping consistency.

New features

• Added a custom shortcut recorder that supports arbitrary key combinations, including system-reserved keys.
• Added grouped management for keyboard actions and mouse actions in button mapping.

Improvements

• Refactored the button configuration panel to improve state synchronization when switching gestures.
• Improved mouse speed control using lower-level system APIs for immediate effect without restart.
• Corrected ML/MR wheel tilt direction mapping logic.
• Improved multilingual translations, including iCloud sync-related copy.

Fixes

• Fixed gesture icon color display issues.
• Fixed action synchronization after switching button configuration.
• Fixed scroll mapping direction errors.
• Fixed multiple missing translation strings in UI.

2025.12.4300

Summary: Expanded mouse mapping capabilities and completed a large storage/runtime performance refresh.

New features

• Extended mouse button support: added MR/ML (mouse right tilt/left tilt) mappings.
• Added in-app language setting switch.
• Added global smooth scrolling option.
• Improved Input Monitoring permission guidance.

Improvements

• Upgraded storage architecture to CoreData for better performance and data safety.
• Refactored app state management for faster response.
• Improved keyboard and mouse configuration views.
• Improved multilingual translations.

Fixes

• Fixed mouse button index and mapping display issues.
• Fixed mapping registration when mouse connects/disconnects.
• Fixed input method switching and several system-control-related edge cases.

Notes

• This release includes a storage architecture migration; first launch may take longer for data migration.

2025.12.4260

Summary: Introduced AppleScript shortcut actions and improved script UX and safety guidance.

New features

• Added custom script execution via keyboard shortcuts (AppleScript).
• Added 6 built-in script templates:
  • Toggle dark/light mode.
  • Toggle system mute.
  • Restart Dock.
  • Control Spotify playback.
  • Copy current Finder path.
  • Clear clipboard.
• Added security prompts and local execution safety guidance for scripts.

Improvements

• Optimized shortcut list ordering (new actions shown on top).
• Added color icon indicators for different action types.
• Improved script editor UI.

Notes

• Some scripts require macOS Automation permissions on first run (for System Events, Finder, etc.).

Notes

• Use this page for concise, user-facing release notes.
• Prefer high-signal changes over internal implementation noise.