Skip to content

Latest commit

 

History

History
68 lines (53 loc) · 3.28 KB

warpd.md

File metadata and controls

68 lines (53 loc) · 3.28 KB
Raw

warpd configuration for mousemaster (warpd.properties)

Overview

  • Designed to mimic the features of the warpd 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 (leftalt + c)

  • 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 m (left button), , (middle button), . (right button).
  • Press mouse buttons then exit ("oneshot" clicks) with n (left button), - (middle button), / (right button).
  • Warp to screen edges with leftshift + h, leftshift + j, leftshift + k, leftshift + l.
  • Scroll vertically or horizontally (wheel) with w, e, r, t.
  • Slow down mouse movement (decelerate) by holding d while moving the mouse.
  • Accelerate mouse movement by holding a while moving the mouse.
  • Exit with esc.

Hint Mode (leftalt + x or x in normal mode)

  • 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 second hint pass with a smaller hint grid centered around the mouse with leftalt + leftshift + x (or leftshift + x in normal mode).
  • 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 warpd.properties.
  • Exit with esc.

History Mode (; in normal mode)

  • Similar to hint mode, but shows hints over previous mouse positions.
  • Exit with esc.

Grid Mode (leftalt + g or g in normal mode)

  • 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 to one quadrant with u, i, j, k (see illustration below).
  • Move the grid in one direction with w, a, s, d.
  • Switch to normal mode with c.
  • Exit (to idle mode) with esc.
                 +--------+--------+            +--------+--------+
                 |        |        |            |  u |  i |       |
                 |   u    |   i    |            |----m----+       |
 leftalt + g     |        |        |     u      |  j |  k |       |
------------->   +--------m--------+   ----->   +---------+       |
                 |        |        |            |                 |
                 |   j    |   k    |            |                 |
                 |        |        |            |                 |
                 +--------+--------+            +--------+--------+

Screen Selection Mode (leftalt + s or s in normal mode)

  • Provide hints for moving the mouse to the center of a monitor.
  • Suitable for multi-screen setups.
  • Exit with esc.

Drag Mode (v in normal mode)

  • Allow for selecting text and dragging objects around.
  • Switch to normal mode with v or a mouse button click (m, ,, .).
  • Exit (to idle mode) with esc.