# Settings reference

Source: https://chainyourmac.com/docs/settings  
Updated: 2026-11-12 · Author: Ahmed Gagan (maker of ChainYourMac)

Every option in ChainYourMac's Configuration screen, what it does and its default. **Settings apply the moment you change them**; there's no Save button.

Open the ChainYourMac window and choose **Configuration** in the sidebar (or **Settings…** in the menu bar menu, or ⌘,). The sections below follow the order on screen.

## General

- **Launch at Login** (off). Starts ChainYourMac quietly in the menu bar when you log in. macOS may ask you to approve it under Login Items.
- **Start Window Manager Automatically** (on).
- **Show This Window When ChainYourMac Opens** (on).
- **Show in Dock** (on). Off keeps it in the menu bar, with a Dock icon only while its window is open.
- **Automatically Check for Updates** (on), and a **Check for Updates…** button. Updates download in the background and install when your Mac has been idle for a while and the ChainYourMac window is closed. Your windows stay in place.

## Displays

**Manage windows on …** for each connected display (on). Switch it off and ChainYourMac leaves that display's windows where you put them. Remembered displays that aren't connected can be forgotten here. More: [multiple displays](https://chainyourmac.com/docs/multiple-displays-and-spaces).

## Layout

- **Gap Between Windows** and **Gap at Screen Edges**: 0 to 32 points each (8).
- **Keep Clear of the Dock** (on).
- **Keep Original Height** (off). Windows keep the height they opened with, aligned to the top.
- **Center Focused Column**: Never (default), On Overflow or Always.

## Preset Window Widths

The widths ⌃⌥R steps through: 25, 33, 50, 66 and 75% by default. Click one to edit it, + to add one (10–100%). More: [column widths](https://chainyourmac.com/docs/column-widths).

## Appearance

- **Animation**: Smooth (default), Fast or Instant.
- **Focus Border** (off): a border around the focused window, with Border Color (amber by default), Border Width (1–8, default 2) and Corner Radius (0–24, default 10). Apps in macOS full screen don't get one.
- **Dim Inactive Windows** (off), with Dim Strength from 5 to 60% (25%).
- **Strip Minimap** (on): the bar of app icons shown while you move around.
- **Interactive Minimap** (on): keep holding the keys to keep it up, click a tile to jump, drag to reorder.
- **Pin Indicator** (on): the blue line beside a pinned column.

## Gestures & Mouse

- **Swipe to Scroll the Strip**: 4 Fingers (default), 3 Fingers or Off. The app warns when macOS uses the same swipe, and can switch to the free finger count in one click.
- **Natural Swipe Direction** (on).
- **Swipe Settles**: Snap (default) or Free.
- **Drag to Reorder** (on): drag a window onto another column to swap them.
- **Scroll to Move Through the Strip**: hold ⌃⌥ (default), ⌥⌘ or ⌃⌘ and scroll, or Off.

## Behavior

- **Restore Layout After Restart** (on): column order, widths, stacks, tabs and pins come back when the window manager restarts.
- **Native Tabs as One Column** (on).
- **Float Dialogs and Previews** (on).
- **Focus Follows Mouse** (off) and **Mouse Follows Focus** (off).

## Window Rules

Per-app rules to float windows or open them at a fixed column. More: [pinning, floating and rules](https://chainyourmac.com/docs/pinning-and-floating).

## The settings file

Everything above is saved to a TOML file, `~/Library/Application Support/ChainYourMac/config.toml` (`~/.paneru` before version 2.5). Reveal it with **Configuration › Reveal Config File** (or hold ⌥ in the menu bar menu). Edit it by hand if you like: the window manager reloads it on save, and **⋯ › Reload from Disk** brings the app's screens up to date. A few rarely needed options exist only in the file, such as `tab_bar_titles`, `pinned_color`, `swipe_sensitivity` and the animation timing. Help › Settings File Reference in the app lists them.

Coming from niri? [niri's config.kdl options, translated](https://chainyourmac.com/niri-config-macos).

## The menu bar menu

The ChainYourMac menu bar icon shows whether the window manager is **Running**, and has Start, Stop and Restart, an **Actions** submenu with every action, Settings…, Mac Setup…, Accessibility Settings, Launch at Login, Check for Updates… and Quit. When an update is ready, **Restart to Install Update** installs it right away.

**Every option has a control.** One-time purchase, free updates, macOS 13 or later on Apple silicon. Price and checkout: https://chainyourmac.com/#pricing (one-time purchase, lifetime license; macOS 13+ on Apple silicon).

## FAQ

### Where is the ChainYourMac settings file?

At `~/Library/Application Support/ChainYourMac/config.toml` (before version 2.5 it was `~/.paneru`; 2.5 moves it there for you). It can also be `~/.config/paneru/paneru.toml` or the path in `$PANERU_CONFIG`, and it can be a symlink to a copy in your dotfiles. Configuration › Reveal Config File shows it in Finder. It's a TOML file; the window manager reloads it whenever it's saved.

### How do I reset ChainYourMac to its defaults?

Configuration › Reset to Defaults… resets every setting and keeps a .backup copy of your old file. To reset only the shortcuts, use Reset to Defaults… on the Shortcuts screen instead.

### How do I hide ChainYourMac from the Dock?

Turn off Show in Dock in Configuration › General. ChainYourMac then lives in the menu bar and appears in the Dock only while its window is open.

## Related

- [Keyboard shortcuts](https://chainyourmac.com/docs/keyboard-shortcuts) — Every default shortcut, and how to change them.
- [Automation](https://chainyourmac.com/docs/automation) — The CLI, chainyourmac:// URLs, Raycast and Keyboard Maestro.
- [Niri config on macOS](https://chainyourmac.com/niri-config-macos) — niri config.kdl options and their Mac equivalents.
- [Privacy and permissions](https://chainyourmac.com/docs/privacy-and-permissions) — What ChainYourMac can see on your Mac, and the only things it sends.
