Settings

Open Settings from the menu bar panel (Settings, near the bottom), or press ⌘, while the panel is open. The sidebar lists the pages, and the search field at the top finds any setting by name.

General

Setting	What it does	Default
Automatic tiling	Arrange windows as they open and close. Turn off to pause.	On
Open at login	Start Shoji when you log in. Open Login Items… opens the matching System Settings page.	On
App icon	The icon shown in Finder, Launchpad and Spotlight, from seven styles.	Washi
Clean Space background	The plain background Clean Space shows: Graphite, Mist or Stone.	Graphite
Accessibility access	Whether Shoji has Accessibility access, with Grant Access… when it doesn’t.
Check for updates automatically	Once a day. Shoji shows what’s new and asks before installing. Check Now checks straight away.	On
Welcome tour	Open Tour shows the welcome tour again.

Layout

Setting	What it does	Default
Layout	How windows share a wide screen: Grid (one big window, the rest beside it) or Columns (every window side by side). Tall screens always stack windows in rows.	Grid
Windows per screen	How many windows share a screen, 1 to 4.	3
When a screen is full	Stack in the active tile (see Stacks) or Float in the middle.	Stack in the active tile
Space between windows	0 to 24 pt, also used around the screen’s edges.	8 pt

Layout and Windows per screen are where every screen starts. To change them for one screen, use the menu bar panel or ⌃⌥⌘1–4: that screen keeps its choice, even after Shoji restarts. See How tiling works.

Highlight

Setting	What it does	Default
Highlight	None, Border on active, Border on all or Glow on active.	None
Border thickness	2 to 6 pt. The space between windows grows to fit.	3 pt
Color	Your Mac’s accent color, a preset, or any color. Used for borders and the glow.	Accent
No peek mode	Every window except the one you’re working in fades back. `⌃⌥D`	Off
Dim amount	How dark the other windows get, 10% to 90%.	50%
Blur other windows	Makes what’s in them unreadable, not just darker.	On

See Borders, glow and gaps and No peek mode.

Mouse

Setting	What it does	Default
Quick actions above windows	Rest on the grip above a window for quick actions.	On
Activate windows on hover	Point at a window to make it active, no click needed. See Focus.	Off

Always available, with nothing to turn on: Swap two windows (hold ⌘ and drag one onto another), Resize (drag the edge between two windows) and Move to another screen (drag a window onto it).

Keyboard

Setting	What it does	Default
Keyboard shortcuts	Arrange windows with `⌃` Control and `⌥` Option.	On

Below the switch, every shortcut with its keys. If another app already uses some, a card says which and they’re dimmed. See Keyboard shortcuts.

Apps

Setting	What it does
Don’t tile these apps	Their windows stay wherever you put them. Add apps with Choose from Applications…. iPhone Mirroring is listed by default. See Floating and excluding windows.
Apps that can’t shrink	Apps Shoji learned a smallest size for, with that size. Forget All clears the list. See Apps that won’t shrink.

Activity

How many windows Shoji placed for you this week, an estimate of the time it saved compared with dragging windows by hand, and the shortcuts you use most, with one to Try next. Numbers only, kept on this Mac: never window titles or app names.

Setting	What it does	Default
Count activity	Turn off to stop counting; your numbers stay as they are.	On
Reset activity	Start every count again from zero.

License

Whether Shoji is activated on this Mac, with Buy Shoji… and Enter Key… when it isn’t, and Deactivate… to move your license to another Mac. See Buy and activate.

About

Shoji’s version, Check for Updates…, links to the website and these docs, and Report a Problem… and Suggest a Feature…. See Report a problem or suggest an idea.

Some choices live in the menu bar panel because they belong to one screen or one moment: the layout and window count for the screen you’re on, Retile, and Tile app name for the app in front.