Skip to content

Latest commit

 

History

History
39 lines (31 loc) · 2.23 KB

mouseable.md

File metadata and controls

39 lines (31 loc) · 2.23 KB

mouseable configuration for mousemaster (mouseable.properties)

Overview

  • Designed to mimic the features of the mouseable project.
  • 3 main modes: normal, hint, and grid mode.
  • Normal mode uses vi-like bindings for local mouse movement.
  • Hint and grid modes assist in larger screen movements and are used with normal mode for comprehensive navigation.

Normal Mode (leftctrl, leftctrl)

  • Used for short-distance mouse manipulation.
  • Useful for manipulating menus and selecting text.
  • Vi-like behavior with directional keys (h, j, k, l) for continuous mouse movement.
  • Press mouse buttons with a (left button), s (middle button), d (right button).
  • Warp to screen edges with leftalt + h, leftalt + j, leftalt + k, leftalt + l.
  • Warp to screen center with leftshift + m.
  • Scroll vertically or horizontally (wheel) with y, u, i, o.
  • Slow down mouse movement by holding space while moving the mouse (slow mode, called sniper mode in original mouseable).
  • Accelerated mouse movement by holding space while moving the mouse.
  • Exit with ; or esc.

Hint Mode (leftalt, leftalt)

  • Display labels on the screen for direct mouse warping.
  • Similar to Vimium-like browser extensions, but applicable to the entire screen.
  • Automatically switch back to the previous mode (idle mode or normal mode) after hint selection.
  • Trigger a left button click by holding leftshift while selecting a hint.
  • Trigger a second hint pass with a smaller hint grid centered around the mouse by holding leftctrl while selecting a hint.
  • A balance between hint size, number and screen space is crucial and can be configured: see hint.font-size, hint.grid-max-column-count, and hint.grid-cell-width in mouseable.properties.
  • Exit with leftalt, esc, or backspace.

Grid Mode (leftshift, leftshift)

  • Divide screen into a 2x2 grid, refining target area with each key press.
  • Move mouse to the middle of the targeted grid section.
  • Shrink the grid in one direction with h, j, k, l.
  • Move the grid in one direction with leftshift + h, leftshift + j, leftshift + k, leftshift + l.
  • Exit with leftshift, ;, or esc.