cymian/mouseless v0.4.0-preview.5

v0.4.0-preview.5 (Linux-only)

on GitHub

This Linux (X11) -only release greatly expands compatibility across distros and architectures. It also has important stability and usability fixes, and improved diagnostic capabilities. It's still QWERTY-only, but I will prioritize other languages/layouts for v0.4 stable or v0.4.1.

Your feedback is essential and greatly appreciated! Thank you in advance! 🙏

Currently supported distros (both x86_64 and ARM)

• Ubuntu 20, 22, and 24
• Debian 11 and 12
• Fedora 41 and 42
• Arch (x86_64 only)

If there isn't an exact match for your system, but its base distro is present (e.g. Ubuntu for Mint), please try that and let me know if it doesn't work. Please also let me know if you're on a unique distro that you'd like to see supported.

Getting started

• Download the .AppImage for your OS and architecture, and the corresponding .sha256sum file.
• Verify the download integrity

sha256sum -c <filename>.sha256sum

• Make the AppImage executable

chmod +x <filename>.AppImage

• Run the application

./<filename>.AppImage

• Start a trial or activate with a license key
• Enjoy!

Documentation is linked from the header bar menu, and more in-depth tutorials (both in-app and video) are coming very soon!

Usage notes

On Arch Linux, you may need to install the webkit package:

sudo pacman -S webkit2gtk-4.1

Fixes

• Should now account for DPI scaling set in system settings or a .Xresources file
• Should no longer crash due to LC_ALL environment variable values (or lack thereof)

Enhancements

• Improved diagnostics
  • Use -d on command line for increased log messages (to file and terminal)
  • Use -p on command line to print keyboard input and mouse output events (to terminal only, not to file). This automatically turns off after 5 minutes to avoid accidental exposure.
• New presets
  • position_based_32_9 for ultra-wide monitors
  • alternate_hands for faster coordinate typing (at the cost of precision)

Known Issues

• Only QWERTY is supported -- other languages/layouts are a top priority for v0.4 stable or v0.4.1
• The overlay may 'stick' on the first time shown or moved to another monitor. If you press the hotkeys to hide it (Escape), then show it (ShiftLeft tap), then hide it one more time, it should work thereafter.
• Clicking Mouseless' header menu via Mouseless (usually) doesn't work
• Activating the product via the menu may not work, but if you rename or remove the trial license file (at ~/.mouseless/licenses/trial_license), you should be able to activate on app startup

Minor

• The toast message / status widget appears beneath the overlay
• Overlay can't be invoked while free mode is active
• The Open config folder menu item may not work (the folder is at ~/.mouseless/configs)

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.