Roadmap and Known issues

Note: This document is new as of June 17th. I still have to comb through some of the older issues to make the enhancements and issues lists complete.

- croian

Roadmap

June 2025

  • Intel Mac beta
  • Linux X11 alpha or beta
  • Tutorial videos
  • v0.4 release candidate (Mac and Windows) (June 24th)
  • v0.4 stable (June 30th)

July 2025

  • Initial v0.5 preview
  • Linux Wayland, compositor 1 (wlroots or Mutter)

August 2025

  • v0.5 stable
  • Linux Wayland, compositor 2 (wlroots or Mutter)

September 2025

  • v0.6 preview

Key enhancements

v0.4 (in preview)

  • Allow one set of keys to work across input sources (language/layout) - #108
  • Allow user to choose font - #165
  • Separate overlay keys into two separate levels - #161, #38, #97
  • Fewer keypresses to execute action (grid action level) - #41
  • Keep overlay up after click (continuous mode) - #137
  • Option to make click action happen at system cursor - #89
  • Relative mouse movement (free mode) - #191
  • subgrid nudges for improved precision - #44

v0.5 (upcoming)

  • Improved welcome / tutorial
  • Custom, separate background colors for top-level cells/rows/columns - #203
  • Customizable config location - #110, #187
    • Workaround: use a hard link: ln ~/.config/mouseless/config.yaml "$HOME/Library/Containers/net.sonuscape.mouseless/Data/.mouseless/configs/config.yaml"
  • Monitor selection improvements
    • Guaranteed left/right ordering - #133
    • Direct selection via hotkey - #324
    • 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 while overlay is up - #194
  • New wheel-related hold for commands (hold for wheel mode, stepped scrolling)
  • Hide inactive portion of overlay - #261
  • Improved preset management - #303
  • Show status toast on active overlay/monitor - #318

Known issues

All platforms

  • Wheel-related hold for commands prevent modifier clicks - #189
  • Non-printable and whitespace keys cannot be assigned to grid - #19
  • Keyboard navigation in config editor is limited
  • Global mouse button keybinding fields map to free mode buttons - #302
    • Workaround: manually edit these fields in the config file
  • \ char in overlay causes it to be unresponsive - #277
    • Workaround: use | instead
  • Modifier+click (with physical mouse) can cause keybindings to trigger if done fast enough - #305
  • Subgrid nudge (beta feature) mode gets stuck - #311

Windows

  • Some users have issues with blank windows - #310
  • Double/triple clicks require extra keypress - #301
  • Some keys don't work in keybindings - #300
  • Modifier tap hotkeys don't work in Jetbrains IDE - #306
  • Overlay doesn't work after screen is locked - #298
  • Free mode movement doesn't clamp to desktop edge - #313
  • At least one user gets erroneous network errors, prevents starting trial - #234

Mac

  • In Apple Music, some UI elements don't respond to clicks - #167
  • In Jetbrains IDE, project tabs don't respond to clicks - #293

Issues in preview

  • Inconsistent double/triple click behavior in certain apps - #226
  • Global mouse buttons keybindings causes keypresses to be blocked that shouldn't be - #178
  • Crosses and dashed line styles not available

Fixed in preview

  • Excess memory usage after editing the config - #156
  • Overlay shows up when pasting into a password field - #189
  • Move system cursor with virtual can cause action to execute at incorrect location - #181
  • Shifted version of keys don't activate subgrid - #107
  • Option and Control shortcuts don't work on non-qwerty layouts - #93
  • repeat last action keybinding passes through to underlying app - #159

Possibly fixed?

  • Overlay not showing after computer is locked - #164