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.

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.

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.

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.

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.

Get ChainYourMac — $19.99 one-time purchase · free updates forever · 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.