# Settings (/settings)



The menu-bar icon is the only way in — **Settings…** opens this window, on
**General**.

General is the pane whose settings have no other home: everything on the panes
below it belongs to a feature, and is explained where that feature is —
[Shortcuts](/features/shortcuts), [Snippets](/features/snippets),
[Flows](/features/flows), [Hyper key](/features/hyper-key), and
[Pro](/pro#activating) for the License screen under About.

## General [#general]

Four settings sit above the tabs, because each is a choice about the app rather
than about a feature.

| Setting              | Does                                                                                                                                                                                                         |
| -------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Start at login**   | Registers a login item with macOS. Shortcuts and the Hyper key only work while Lumi runs, so this is what makes them survive a restart. A launch at login opens no window; a launch you made opens this one. |
| **Appearance**       | Light, Dark, or follow the system.                                                                                                                                                                           |
| **Accessibility**    | Shows whether the grant is in place, with a way straight to the pane that gives it. See [Permissions](/get-started/permissions).                                                                             |
| **Share usage data** | Off unless you turn it on. Counts, never content — see [Privacy](/privacy).                                                                                                                                  |

<Screenshot name="general-pane" alt="The General pane: Start at login, Appearance, Accessibility and Share usage data above the five tabs" />

Below them, five tabs.

### Commands [#commands]

**App shortcuts** — combinations for Lumi itself rather than for anything you
bound. One opens this window, one opens the [flow editor](/features/flows), and
each toggles: press it while that window is in front and it hides again. Change
or clear them at any time.

<Screenshot name="general-commands" alt="General → Commands: App shortcuts, the combinations that open Lumi's own two windows" />

### Alerts [#alerts]

**On-screen alerts** decides how the **Show alert** action draws over whatever
you are working in. An alert **never takes focus**, so the keys you press next
still go where you were typing.

| Field        | Options                                                         |
| ------------ | --------------------------------------------------------------- |
| **Position** | Top of the screen · Middle of the screen · Bottom of the screen |
| **Size**     | Small · Medium · Large                                          |
| **Theme**    | Match this window · Dark · Light                                |
| **Duration** | In seconds                                                      |

A **preview** button draws one in the chosen style so you can see it before
binding anything. A shortcut can override all of this on its own row — see
[Show alert](/features/shortcuts#lumi).

<Screenshot name="general-alerts" alt="General → Alerts: position, size, theme and duration, with a button that draws a preview" />

### Menus [#menus]

Everything about the [leader menu](/features/leader-menus) panel.

| Section          | Does                                                                                               |
| ---------------- | -------------------------------------------------------------------------------------------------- |
| **Leader menus** | How many seconds a half-typed menu stays open. A single menu can override it on its own row.       |
| **Panel layout** | **Grid** lines the marks and names up in columns; **Flowing** packs as many as fit onto each line. |
| **Columns**      | How wide the grid is, up to six. A *ceiling*, not an exact count.                                  |
| **Empty menus**  | **Show steps that open empty menus** — on by default, so a menu is visible while you build it.     |

Explained in full under [The grid](/features/leader-menus#the-grid) and
[Menus with nothing in them](/features/leader-menus#menus-with-nothing-in-them).

<Screenshot name="general-menus" alt="General → Menus: the seconds a menu stays open, the panel layout, the column count and the empty-menu switch" />

### Windows [#windows]

For the **Arrange window** and **Move to another display** actions.

| Section                       | Does                                                                                                     |
| ----------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Arranging windows**         | How long a window takes to travel to its new place. Zero puts it there at once.                          |
| **Moving to another display** | What happens when a window hangs off the edge of its display — **Keep its size**, or **Trim it** to fit. |

<Screenshot name="general-windows" alt="General → Windows: how long a window takes to move, and what happens to one that hangs off the edge" />

### Advanced [#advanced]

| Section           | Does                                                                                                                                                                                                                                                        |
| ----------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **This network**  | **Let flows reach this network.** Off, a script node in a [flow](/features/flows) can still fetch from the internet once its own *Use the network* box is ticked — but addresses on this machine and this network stay refused. Turning this on lifts that. |
| **Configuration** | Your shortcuts live in a JSON file you can open or back up, with a button to reveal it in Finder. **Reset to defaults** is beside it and asks first: &#x2A;Shortcuts and snippets go.*                                                                      |

<Callout type="warn" title="Why the network switch is off">
  Loopback and the local network are where everything else on your machine
  lives — a router's admin page, a database, a service with no password because
  it never expected a caller. That is why an imported flow cannot reach them
  until you say so.
</Callout>

<Screenshot name="general-advanced" alt="General → Advanced: the network switch for flows, and the configuration file with Reveal in Finder and Reset to defaults" />