Skip to content

Usage guide

Jump to bottom
alfredosequeida edited this page Jan 5, 2025 · 7 revisions

This page will tell you everything you need to know about using hints. Note that modifiers can be used at any time while typing in a hint (before a hint is finished being typed). This gives you the flexibility to decide what to do at any time while typing in a hint.

Stop showing hints

To stop showing hints at any time, press the ESC key.

Multiple clicks

To click on an element in an application more than once, you can type in the number of clicks you want to perform at any time while typing a hint. Assuming the hint is jk, that might look something like:

  • 2jk, this will double click on an element with the hint jk.
  • j2k, this will also double click on an element, but this gives you the ability to decide to send a number of clicks at any time while tipping in the hint.
  • 10jk, as you would expect, this will send 10 clicks.

Right clicks

By default, typing in a hint will send a LEFT mouse click. However, you might want to send a RIGHT click instead. To do this, use the SHIFT modifier at any time while typing in a hint. This is the same as typing a capital letter. For example:

  • SHIFT + ab, will RIGHT click on a hint shown as ab
  • aSHIFT + b, will do the same.

Hovering

Sometimes you might want to hover over a GUI element in an application without clicking on it. To do this you can use the hover_modifier(Ctrl by default).

  • Ctrl+ab
  • aCtrl+b

Dragging

Some applications might require more complex mouse movements like dragging. This is a three step process:

  • First you need to select an element by telling hints to grab it (after showing the hints on screen in hint mode), this is like holding the left mouse button. This can be achieved by using the grab_modifier (Alt by default).
  • Then you can move the element by using the mouse_move_[left/right/up/down] keys (h,l,k,j by default respectively).
  • Finally, you can release the element by using the exit_key(Esc) by default.

Note, all modifiers mentioned above can be configured. See the Configuration section of this wiki for more information.

Scrolling

Hints has a scroll mode for scrolling. First you will need to start hints in config mode hints --mode scroll. You can bind a key to this in your Desktop Environment / Window Manager to start hint mode on demand. Then you can scroll by using the mouse_scroll_[left/right/up/down] keys (h,l,k,j by default respectively).

Clone this wiki locally