Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Roadmap

Done in current preview release

  • Multi-color backgrounds
  • Modifier clicks on Windows

April 2026

  • 1.0.0 stable release
    • All platforms:
      • Invert colors action
      • Increased logging (for troubleshooting)
      • Log level config field
      • Consolidated settings / config file (settings menu items now appear in config editor)
      • Force overlay resize hotkey (e.g. to fix issues after screen change on Windows)
    • Mac:
      • In-place, automatic updates
      • Overlay now shows overs fullscreen apps
      • Fixed double trigger needed to show after switching spaces
      • Deep links
        • Will help resolve inter-app conflicts, allow automated triggering of overlay, etc.
    • Windows:
      • Non-English key fixes

May 2026

  • v1.1 preview release
    • Custom actions (all platforms)
      • set, cycle, or adjust any setting to any value(s) you want, with any hotkey you want
    • Revamped config editor, consolidated app window
    • Dark mode theme
    • Customizable config location - #110, #187
      • Workaround for now: use a hard link: ln ~/.config/mouseless/config.yaml "$HOME/Library/Containers/net.sonuscape.mouseless/Data/.mouseless/configs/config.yaml"

Future

  • Improved welcome / tutorial
  • Comprehensive tutorial video
  • Monitor selection improvements
    • Direct selection via hotkey - #324
  • New wheel-related hold for commands (hold for wheel mode, stepped scrolling)
  • Hide inactive portion of overlay - #261
  • Show status toast on active overlay/monitor - #318
  • Improved preset management - #303
  • Single overlay across multiple monitors
  • Zoom on subgrid for readability - #53, #320
  • Improved precision
    • Shift/case sensitive overlay keys
    • Additional grid level
  • Preserve comments and field order in config file - #129
  • Allow wheel movement in overlay mode - #194