# Functions & Actions

Functions are the building blocks you bind to keys. An **Action Instance** is a Function plus saved parameter values.

## Use it

1. Open **Keyboard Layout Config** (<kbd>Alt</kbd>+<kbd>C</kbd>).
2. Browse or search the **Actions Library** (card or table view).
3. Select a Function. If it has parameters, create or edit an **Action Instance** (name it clearly).
4. Click a Keyboard Reference keycap to place that instance.
5. Press the key on a normal page to run it.

To change behavior later, edit the instance’s parameters in Config — every key that uses that instance picks up the change.

## Reference

### Concepts

| Term | Meaning |
| --- | --- |
| **Function** | Reusable operation definition |
| **Action Instance** | Function + saved parameters |
| **Key Action** | What occupies a slot — Function/instance or Macro |
| **Result destination** | Clipboard, popover, page change, Media Library, etc. |

### Library categories (overview)

Navigation · Tab Control · Begin URL · Get Page Data · Maps · Scroll · Select · Clipboard · Type · Keystrokes · Data · Lookup · Translate · Script · Media Library · AI · KeyPilot · Tools · System

### Notable Functions

- **Type Characters** — insert text (modifier-chord friendly while typing)
- **Copy image / video / URL** — with destination choices
- **Get text/media under cursor**
- **Lookup Word** — Free Dictionary API definition for the word under the cursor
- **Translate**
- **Send selection to AI** — instruction + result destination
- **Add URL to Media Library**
- **Execute JS** — custom script (see that topic)
- **Macro Keys** — hotkey, burst, round-robin, continuous key, synthetic mouse, remaps

### Stock vs user

Built-in layouts are read-only sources; editing forks a user copy you own.
