Getting started

MacOS

To install (or update):

• Download the .dmg file from https://mouseless.click
• Open the .dmg file
• Drag Mouseless.app into the Applications folder
• If updating: choose “Replace” instead of “Keep both” when prompted

You can also install in the terminal via Homebrew:

• brew install --cask mouseless (stable channel)
• brew install --cask mouseless@preview (prerelease channel)

First time usage:

• Open Mouseless (e.g. via spotlight search)
• Read/agree to the terms of service
• Start trial or activate
• Give Mouseless the Accessibility permission when prompted
• Restart the application for permissions to take effect
• Enjoy!

To run Mouseless on startup:

As a sandboxed app (for enhanced security), Mouseless can not add itself as a ‘Login Item’, so you must do this:

1. Open ‘Login Items’ via spotlight search
2. Click the ‘+’ button
3. Add Mouseless.app

Windows

To install (or update):

• Download the latest Windows installer (.exe) or portable (.zip) file from https://mouseless.click
• Run the installer (or extract the .zip)
• If installing, choose whether to install for current user (no admin privileges required) or for all users (admin privileges required)
  • On subsequent installations / updates, the installer will use the previously chosen option. To override this, run the installer from the command line with the /ALLUSERS or /CURRENTUSER argument, e.g.: .\mouseless-installer_v0.4.2.exe /CURRENTUSER

First time usage:

• Open Mouseless, e.g. via the start menu if installed, or if using the portable, by running the mouseless\mouseless.exe file in the extracted folder/location
• Read/agree to the terms of service
• Start trial or activate
• Enjoy!

Linux

Wayland users: Please see the Enabling keyboard/mouse access on Wayland page before running Mouseless. If you’re unsure if you’re on Wayland or X11, run echo $XDG_SESSION_TYPE in a terminal.

First time usage:

• From https://mouseless.click, download the .AppImage and .sha256sum file for your OS and architecture
• Verify the download integrity: sha256sum -c <file>.sha256sum
• Make the AppImage executable: chmod +x <file>.AppImage
• Run the application: ./<file>.AppImage
  • If you are an Arch user, you may need to install webkit2gtk and configure its path (more info)
• Start a trial or activate with a license key
  • If you don’t see an alert dialog at this point, but instead see “ALERT:” in the terminal, install the zenity package (or kdialog)
• Enjoy!

Not working right? See the Linux troubleshooting section for solutions and workarounds.