v0.4.0-preview.3

Mouseless has landed on Linux (X11), Intel Mac, and MacOS 12 and 13! 🎉

Note: There is no Windows build for this release, and it is entirely optional for Apple Silicon with MacOS 14+ (it likely has some regressions relative to the prior version, but also may have a couple fixes).

For Wayland-only Linux users: You can follow forthcoming Wayland progress here.

• If you're unsure which display server you use, run this in your terminal: echo $XDG_SESSION_TYPE. If it says wayland, to use Mouseless at this time, you'll have to log out, and choose an X11 (or 'Xorg') session before logging back in (you may have to select your username before you can choose the session type).

For Linux (X11) users

Thank you for trying the first Linux release! Your feedback and patience while any discovered issues are worked on is appreciated.

Note: It has limited compatibility right now (see notes below), but there will be another release by ~July 6th that should improve this (i.e. hopefully will work with Ubuntu 20, Debian 11).

Getting started

• Download the .AppImage file and the sha256sum.txt checksum file.
• Make the AppImage executable: chmod +x Mouseless_v0.4.0-preview.3.AppImage
• Run the application: ./Mouseless_v0.4.0-preview.3.AppImage
• Start a trial or activate with a license key
• Enjoy!

To verify the integrity of the AppImage file, run the following command in the same directory as it and the checksum file:

sha256sum -c sha256sum.txt

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

Known issues

Compatibility

• Only QWERTY is supported -- other languages/layouts will be a top priority for a fast follow-up release.
• I will evaluate an ARM build as a fast follow as well.
• Will not work on distros with glibc v2.37 or lower (e.g. Ubuntu <= 22, Debian <= 12) -- I'll attempt to build for compatibility with glibc 2.35 or lower very soon!
  • To check your glibc version: ldd --version
  • Possible workaround: You may be able to get it working with nix, with this configuration shared by a user
• Error at startup: Failed to spawn child process “/usr/libexec/webkit2gtk-4.1/WebKitNetworkProcess”
  • Workaround: sudo mkdir -p /usr/libexec && sudo ln -s /usr/lib/webkit2gtk-4.1 /usr/libexec/webkit2gtk-4.1

Usage

• The welcome screen says to press ShiftLeft tap to enter free mode, but it's actually ControlLeft tap by default
  • My intention was indeed for ShiftLeft tap to enter free mode, and ControlLeft tap to show the overlay, but they are swapped
• 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.
• Mouse position may be incorrect if DPI scaling is used (e.g. via ~/.Xresources, with a value other than 96)
• 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

• Subgrid shows briefly when showing the overlay
• 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)

For Mac users

At long last, Mouseless has made its way to Intel and MacOS 12 and 13. Your feedback is greatly appreciated!

Getting started

• Download and open the .dmg
• Drag Mouseless.app into the Applications folder
• Open Mouseless (e.g. via spotlight search)
• Start trial or activate with a license key
• Give Mouseless the Accessibility permission when prompted
• Restart the application for permissions to take effect
• Enjoy!

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

Known issues

• The overlay closes when you start a drag with the hold for drag command -- you can re-open the overlay to finish the drag operation

---

Happy clicking! 🐧✨🖱️

- croian