cymian/mouseless v0.4.0-preview.6

v0.4.0-preview.6 / windows_beta.4 (All platforms)

on GitHub

This recommended release has several key enhancements and fixes. This will be the last preview release before the stable v0.4 release (barring any unexpected hotfixes).

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

Enhancements

• New toggle app enabled command -- disables all hotkeys (except itself)

• double tap and triple tap hotkeys now officially supported (fixed for modifier keys)

• Added direct right click, middle click, back click, and forward click commands to overlay context

• Improved keyboard navigation in config editor (and other windows)

• Restored ability to trigger the overlay while in free mode

• Added --diagnostics cli option, will print system graphics and display info

• Experimental: added --dpi_scale cli option for forcing a specific value (primarily for Linux)

• Miscellaneous performance optimizations

• New defaults

  • hold for speed decrease is now assigned to A by default on all systems, so that Shift remains open for shift+clicks. Accordingly, A is also no longer a default hold for speed increase hotkey.
  • Linux: cycle font and cycle font reverse default hotkeys have changed (shift+3 wasn't working)

Windows:

• Improved multi-language/layout support: no need to switch between layouts to use Mouseless
  • To set the layout Mouseless will use to interpret keypresses, simply click the update button next to keyboard layout at the top of the config editor

Fixes

• Fixed welcome window sometimes being taller than screen height
• Config loading/format errors are now logged to file (and now displayed as alerts on all platforms)

Windows:

• Mouseless now ensures cursor is visible when a mouse action is executed
• Fixed errors/delay when pressing escape before an app window (other than overlays) is shown

Mac (Arm and Intel):

• Fixes nudges_per_cell value (was off by a factor of 2). Your previous value (if present) will be migrated.

Intel mac:

• Fixed drag and drop with overlay
• Fixed continuous mode
• Fixed subgrid nudge
• Fixed drag with global mouse buttons

Linux:

• Fixed delayed wheel movement in free mode (easing has been removed, for now at least)
  • Still a work in progress -- if it's choppy, try bumping up the base wheel speed, or using the 'wheel step' commands
• Fixed new version alert dialog
• Activate and purchase links now disappear from menu once activated
• The activation dialog should work when opened from the header bar menu now

Known issues

• On Linux, using Alt tap or (AltLeft/Right tap) for a global hotkey causes menu bars to activate.
  • On Windows, the same happens unless you specify (in the behavior section) to send Escape after global Alt tap.

Usage notes

Mac:

• If you are upgrading from preview.1 or earlier, and downloaded the preview.6.dmg file that was up until ~2025-08-09 03:35 GMT, your config will fail to load on startup (my apologies). Simply download the new preview.6.1.dmg below (or on the Mouseless homepage) and it should load your prior config just fine.
  • If you are in this situation but install/update via homebrew, please see this comment for the fix.

Linux:

• If you get blank windows, running the app with WEBKIT_DISABLE_COMPOSITING_MODE=1 ./Mouseless_v0.4.0-preview.6... should make the app usable, but the overlay will periodically accumulate opacity. This is far from ideal, but some may find it worth using still.
  • If you run it with --diagnostics and post or send me the system graphics data, it may help point to which drivers have this issue.
  • I believe a full fix is possible, but hopefully won't (though may) require an alternative overlay implementation
• See prior release notes for other known issues, and getting started instructions

Privacy note

I've updated the privacy policy to note that the 'platform' string sent to the license server now may include the linux distro, os version, and machine architecture (x86_64 or arm64). This will improve customer support, inform development priorities, and make it easier for users to manage their machines.