Roadmap and Known Issues

Note: This document is relatively new and incomplete. Some time after the v0.4 stable release, I'll comb through the older issues to make the enhancements and issues lists more complete.

- croian

Roadmap

September 2025

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

October 2025

• Linux Wayland, compositor 2 (wlroots or Mutter)

November 2025

• v0.5 stable

Key enhancements

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

• Non-printable and whitespace keys cannot be assigned to grid - #19
• Keyboard navigation in config editor is limited
• Modifier+click (with physical mouse) can cause keybindings to trigger if done fast enough - #305

Windows

• Some keys don't work in keybindings - #300
• Modifier tap hotkeys don't work in Jetbrains IDE - #306

Mac

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