Manual
Everything MoreDisplays does, in the order it makes sense to learn it. If you are here because a Mac is about to lose its monitor, go straight to Headless setup, and read step 1 before anything else.
Start here
Getting started After this page you will have one working display group and three ways to switch to it. Concepts After this page you will know what every word in the window means, and why the app is built the way it is. Headless setup After this page you will have a Mac that presents the display you chose as soon as you log in, and you will know exactly which gap the app does not cover. Displays at the login window After this page you will know whether to switch this on, what macOS will ask you when you do, and how to tell from a shell what state it is in.
Displays
Virtual displays After this page you will be able to define a display that makes your remote client render at the right sharpness and the right text size. Templates and the catalogue After this page you will be able to define any display without looking up a single specification. Refresh rates After this page you will know which refresh rates are worth asking for and why 59.94 is not 60. HDR After this page you will know which of the three ranges to pick, what headroom each one produces, and why this feature is the most likely to break on a macOS update.
Groups
Groups After this page you will be able to build a set of groups covering every desk you work from, and switch between them safely. Attached monitors After this page you will know how to make one group put your monitor at 3840 by 2160 and another put the same monitor at 2560 by 1440. Protection After this page you will know which displays to protect, what happens when something fights back, and why turning it on takes effect on the next activation. Switching without the window After this page you will be able to switch setups without opening the app, from a keyboard, a script, a link or the machine's own launch.
Beyond one Mac
Sync and backups After this page you will know exactly what leaves your machine, what stays on it, and how to get a deleted group back. Brightness After this page you will know whether the brightness feature can work on your Mac, and why it is off by default. Remote clients After this page you will know which display settings suit your client, and which of them need one setting changed to stop fighting for the resolution.
When things break
CLI reference
All commands
Every command with its synopsis, flags, JSON output schema, exit codes and worked
examples. Generated from the binary's own description of itself.
Recipes
Complete scripts rather than individual commands: switching on arrival, a real
health check, restoring from cron, and waiting for the app to be ready.
Single page reference
The whole CLI on one page, for a browser find or for printing.