Skip to content

Latest commit

 

History

History
190 lines (150 loc) · 7.76 KB

author.md

File metadata and controls

190 lines (150 loc) · 7.76 KB

Author's configuration of mousemaster (author.properties)

(Refer to configuration-reference.md for documentation on the complete list of configuration properties.)

Overview

  • Designed for controlling the mouse with the right hand only.
  • Normal mode, grid mode, and hint mode can be used entirely with the right hand, without moving it.
  • Normal mode automatically exits (to idle mode) after 5s of inactivity.
  • Normal mode automatically exits when any non-normal mode key is pressed (e.g. when starting to type).
  • To be used in conjunction with Alt Tab Terminator for a better Win+Tab task view.
  • (The author uses rightalt + space as the PowerToys Run activation shortcut.)

Key Aliases

Alias Keys
Direction keys (up/down/left/right) i / k / j / l
Left button space
Middle button ; ' #
Right button p [ ]
Hint keys (level 1) i j k l m o
Hint back backspace h
Surgical/slow key n
Hint no-move key / n
Hint scroll b
Position history key m

Idle mode (starting mode)

  • Tap rightalt → normal mode.
  • Hold rightalt for 250ms → screen grid mode.
  • space then l → close active window (via alt+space menu).
  • space then k → minimize active window.
  • space then i → Win+Tab task view.
  • rightshift tap → UI hint mode.
  • ; (middlebutton) + m or n → UI hint mode.
  • Start typing any letter → typing mode (prevents interference with normal typing).

Normal mode (tap rightalt from idle)

Mouse movement

  • Move mouse with i, j, k, l.
  • Hold rightalt while moving → fast mouse mode (higher velocity).
  • Hold n → surgical/slow mode (very slow movement + 2x zoom).

Mouse buttons

  • space = left click, ; ' # = middle click, p [ ] = right click.
  • Left and right buttons toggle (remain pressed) if held for more than 250ms.
  • Ctrl-click: hold leftctrl then click.

Scrolling

  • Double-tap a direction key → wheel mode (continuous scrolling in that direction).
  • In wheel mode: hold rightalt → fast wheel mode; hold space → superfast wheel mode.

Screen navigation

  • Press rightalt (no direction key held) → enters a transient snap state:
    • Release rightalt within 250ms → hint mode (hint3-1-then-click).
    • Press a direction key → screen snap mode (snap to screen edges).
    • Press a middle button key → window snap mode (snap within active window).
    • Wait 250ms → screen grid mode.
  • Hold m → position history mode (jump to saved positions).
  • Copy with c (sends Ctrl+C), paste with v (sends Ctrl+V).

Exiting

  • rightctrl or backspace/h → idle mode.
  • Pressing any unhandled key → idle mode.
  • 5s timeout with no activity → idle mode.

Hint mode (3-level progressive zoom)

The hint system uses a 3-level zoom progression. At each level, selecting a hint key zooms into a smaller area centered on the selection, with finer-grained hints.

Level 1 — large grid (~6x6 cells covering the screen)

  • Grid cells: 320x180px (scaled per screen DPI).
  • Each cell has a 2x2 subgrid with visible borders.
  • Hint keys: i, j, k, l, m, o (right hand only).
  • Font: Consolas 72pt, yellow on semi-transparent black boxes.
  • Selecting a hint key → level 2.

Level 2 — medium grid (centered on level 1 selection)

  • Grid cells: ~53x30px, font size 15, no shadow.
  • Up to 6x6 hints centered on the last selected hint.
  • Selecting a hint key → level 3.
  • backspace/h → back to level 1.

Level 3 — fine grid (centered on level 2 selection, with 30x zoom)

  • Same grid dimensions as level 2, with 30x zoom overlay.
  • Selecting a hint key → performs a left click and enters click-after-hint state.
  • backspace/h → back to level 2.

Click behavior

  • By default, selecting a final hint performs a left click.
  • Hold a mouse button key before/during hint selection to change click type:
    • space (left), ; (middle), p (right). The hint box border color changes to indicate: yellow = left, magenta = middle, cyan = right.
  • After clicking, the hint key can be pressed again within 250ms to double-click.
  • Holding the hint key for 250ms after selection toggles the button (drag mode).
  • Hold / or n (no-move key) to prevent the mouse from following the grid center during selection; mouse jumps only on final selection.

Scrolling in hint mode

  • Hold b + direction key → scroll while hints are displayed.

Exiting

  • esc, backspace/h (at level 1), or rightctrl → idle mode.
  • rightalt tap → normal mode.

Grid mode (hold rightalt for 250ms from idle or normal)

Screen grid

  • Divides the active screen into a 2x2 grid, mouse follows grid center.
  • Press a direction key → refine grid (select quadrant in that direction).
  • leftshift + direction → move grid.
  • leftctrl + direction → snap mouse to grid edge.
  • Direction key only → shrink grid in that direction.
  • leftshift tap → move mouse to grid center.
  • Middle button key → switch to window grid.
  • Right button key → switch to screen snap.

Window grid

  • Same as screen grid but confined to the active window.
  • Middle button key → switch to screen grid.
  • Right button key → switch to screen snap.

Exiting

  • Release rightalt → normal mode (if a direction key is held, starts moving).

Snap modes

Screen snap

  • Enter from normal mode: press rightalt, then a direction key. Or press rightalt + p from idle.
  • Quickly snap the mouse to screen edges using direction keys.
  • Right button key → screen grid mode.
  • Middle button key → window snap mode.

Window snap

  • Enter from normal mode: press rightalt + middle button key. Or press rightalt + middle button key from idle.
  • Snap within the active window (with 15px top inset to reach title bars).
  • Middle button key → window grid mode.
  • Right button key → screen snap mode.

Surgical mode (hold n in normal mode)

  • Very slow mouse movement (max velocity 75 vs normal 1125).
  • 2x zoom centered on the mouse cursor.
  • Mouse buttons work the same as normal mode.
  • Release n → normal mode.

Position history mode (hold m in normal mode)

  • Displays saved mouse positions as hints (up to 16).
  • Uses Consolas 20pt font, 4-key selection (i j k l).
  • rightalt tap → save current position.
  • rightalt hold 500ms → clear all positions.
  • Hint key tap → jump to saved position.
  • Hint key hold 500ms → remove saved position.
  • Release m → return to previous mode.

UI hint mode (rightshift tap, or ; + m/n)

  • Displays labels on detected UI elements (buttons, links, etc.) for direct targeting.
  • Selection keys: i j k l m o n.
  • Font: Consolas 10pt bold, white on blue boxes (#204E8A) with yellow border.
  • Mouse follows selected hint.
  • Selecting a hint performs the appropriate click (left/middle/right depending on held button).
  • Hold rightalt to browse hints without clicking.
  • After clicking, pressing the hint key again within 250ms repeats the click.
  • Holding the hint key for 250ms toggles the button (drag mode).

Arrow key mode (; + i/j/k/l)

  • Hold ; (middlebutton) and press i/j/k/l → emits arrow keys.
  • space in this mode → Enter key.
  • Modifiers (leftshift, leftctrl, etc.) work normally for Shift+Arrow, Ctrl+Arrow, etc.
  • Release ; → return to previous mode.

Typing mode (auto-detected)

  • Triggered when typing any letter in idle mode.
  • Prevents interference with macros that use space + direction keys.
  • Automatically returns to idle mode after 500ms of no typing.
  • rightalt tap → normal mode.
  • ; → idle mode.

Macro hint mode

  • Invisible hint grid used by macros.
  • 4x10 layout, 40 hint keys covering the full keyboard.