v0.4.0-preview.7 / windows_beta.5

This release has some important fixes and enhancements on all platforms. This is now the final planned release before the v0.4 stable release.

Your feedback is always appreciated! 🙏 (Mac, Windows, Linux)

Note (Linux): If you have issues running Mouseless on Linux, I've centralized solutions/workarounds to common issues here in the docs.

Note (Windows): The original beta.5 version here had an issue where the AltRight key wasn't recognized. This is fixed as of 2025-09-01 21:34 GMT, in the beta.5.1 version below.

Enhancements

All platforms

• You can now can pass -h or --help to see available CLI args
• Check for preview releases setting now available on all platforms
• Updated internal dependencies for security and stability
• New defaults
  • Free mode's back/forward/middle/right button hotkeys are now Q, W, E, R. On Mac and Windows, this frees up the bottom row (ZXCV) for copy/cut/paste/undo operations.
  • Movement easing default is now 0.2 (slightly looser/smoother)

Mac

• Automatic check for updates now checks daily, in addition to on startup
• Status bar icon now reflects update available and enabled/disabled state
• Execution modes: On M-series Macs, you can now choose between the implementation built for Intel and older OS versions, or the standard implementation. macOS 13 users may benefit from standard mode, while macOS 12 users may have issues with overlay position in that mode.
  • Compatibility mode: the only available mode on Intel Macs, and the default on macOS 12 and 13. Enabled via the --compatibility (or --compat) CLI flag.
  • Standard mode: the default on MacOS 14+ on Apple Silicon. Enabled via the --standard CLI flag.

Windows

• Added back and forward buttons in all contexts (overlay, free mode, global)
• System tray icon now reflects update available and enabled/disabled state
• Added Debug: clear keyboard state option to menu, may help if bugs encountered where hotkeys become unresponsive
• Added display input feature

Linux

• Non-English and non-QWERTY layouts now supported. Use the Update layout button at the top of the config editor to set the layout Mouseless uses to the current system layout.
• Added back and forward buttons in all contexts (overlay, free mode, global)
• Added display input feature
• New --no-compositing cli arg, can be used in place of WEBKIT_DISABLE_COMPOSITING_MODE environment variable, for systems with GPU compatibility issues (e.g. blank windows)
  • There is a minimal_background style preset to help minimize opacity buildup in this mode
• New debug options field allows you to enter JSON for certain options
  • Currently, can be used to fix mouse position on certain Linux systems, with these fields (adjust values as needed): { "mouse_screen_position_mult": 1, "mouse_screen_size_mult": 1.25 }

Fixes

All platforms

• tap hotkeys are now recognized during subgrid key holds and free mode 'hold for' commands
• Fixed some suppression issues with tap hotkeys in free mode
• Fixed some issues with subgrid nudge, including where the overlay could become largely unresponsive if the overlay closes while the subgrid key is held (e.g. by executing right click instead of releasing the subgrid key)

Mac

• Fixed issue with machine hash retrieval failing on some users' systems
• (Intel Mac) Closing the app window with the native red 'x' no longer prevents the window from being re-opened

Windows

• Fixed issue where Mouseless is unresponsive after coming back from sleep / lock screen
• Extended keys (e.g. Arrow keys, Numpad keys, Delete key) now properly recognized in hotkeys
• App window's icon is no longer generic

Linux

• Continuous mode should now work as expected
• Drag and drop with the overlay should now work
• Removed free mode's experimental jump commands -- severe issues have been observed in both Debian+KDE and Fedora+Gnome
• Fixed console alerts locking user out of keyboard input

---

Happy clicking ✨