cymian/mouseless v1.0.0-preview.4

v1.0.0-preview.4 (Mac-only)

on GitHub

This release adds multiple features, enhanced diagnostics, and key fixes for system permissions prompts and other areas.

Feedback always appreciated!

Enhancements

Free mode

• Added hold for free mode command (marked as 'beta') #444
• Added subpixel tracking for smoother free mode movement
• Added Free mode status display setting, allows for a dot indicator at the cursor instead of (or in addition to) the toast window. Default: "both"
  • Indicator size, color, and offset are customizable (in Style > HUD section)
  • Cursor indicator not available on macOS 13 and below

Display

• Added Toast opacity setting, allows you to prevent toast from overly-obscuring underlying screen content. Default: 0.5
• Status bar icon now shows a lock when macOS' "secure input" mode is active (i.e. a password field is active -- Mouseless hotkeys will be disabled)
• Added char anchor setting, to control whether characters are spaced edge-to-edge or center-to-center

Mouse actions

• Added modifier clicks for free mode back and forward buttons, and all global mouse buttons
• Added Mouse value cycle behavior, affects cycle button/action/count commands #531
  • once - value returns to default after executing an action (default)
  • persist - value remains after executing an action, until cycled again

System / debug

• Added Hud window level setting -- may fix issues when using software that captures displays (e.g. Yabai)
• Added --print-hid-events-verbose / -P cli flag (prints mouse move and wheel events)
• Expanded the scope of clear keyboard state and added extra diagnostics
  • To retrieve diagnostics, click the status icon menu > Debug > Copy state diagnostics
  • May help workaround/diagnose #532

Fixes

• Fixed accessibility permissions prompt not showing on first usage, app going silent
• Moved user data location to ~/Library/Application Support/Mouseless/
  • Should prevent the access data from other apps prompt, though you may see it one more time when Mouseless attempts to perform the data copy from the old location (or you can copy manually, see notes below)
• Fixed conflicts when multiple free mode commands mapped to same key, one with modifier and one without
• Fixed tap commands in free mode leaking to underlying app
• Fixed modifiers in keybinding affecting mouse action commands (resulting in unintended modifier+click)
• Fixed errant system beeps in config editor

Usage notes

User data has a new location

The user data location has changed, to prevent disk access permission prompts related to the old sandbox location. Your data (configs, license, presets) now lives at:

~/Library/Application Support/Mouseless/

If you have existing user data, Mouseless will copy it to the new location automatically. You may see a one-time "Mouseless.app would like to access data from other apps" prompt — click Allow (the permission is temporary) and your settings will carry over.

If you'd prefer not to grant that permission, click Don't Allow, then run this command in Terminal to perform the data copy, then restart Mouseless:

mkdir -p ~/Library/Application\ Support/Mouseless
cp -R ~/Library/Containers/net.sonuscape.mouseless/Data/.mouseless/. \
      ~/Library/Application\ Support/Mouseless/

Known issues

• Free mode: Virtual mouse position can momentarily accumulate past the screen edge (resets if no movement for half a second)
  • Cause: Side effect of the new subpixel tracking
  • Status: Fixed, pending release