External display setup
Mac external display setup checklist
DeskCommit
See how DeskCommit works
Start with the connection, establish a stable picture, and only then adjust the layout and display modes. This checklist separates an external monitor that will not display an image from one that works but needs different settings.
You can check the connection and adjust your screens with macOS alone. DeskCommit is an option after the Mac detects the displays, for changing settings from a keyboard palette or saving a setup to restore manually later.
By Yuto TakahashiLast updated: Last verified: Tested with: DeskCommit 0.4.3 (13) · macOS 26.5.1 · Apple silicon
macOS menu bar app
What is DeskCommit?
DeskCommit lets you choose a display and move it left, right, above, or below another with the arrow keys. Press the default shortcut, Control–Shift–D, from any app, use Shift–Arrow when you want to align edges or centers, review the pending change, and press Return to apply it. You can change the shortcut in DeskCommit Settings. Resolution, refresh rate, and Main stay in the same palette.
The checklist works with macOS alone. DeskCommit becomes useful after the displays are detected, when you want to make arrangement and display-mode changes from one keyboard palette or save a setup you use again.
See how DeskCommit worksThe 10-point checklist
- Check your exact Mac model's display limit, including resolution and refresh-rate combinations.
- Check power, the selected input, and every cable, adapter, and dock; establish a stable picture.
- Choose an extended desktop or mirroring.
- Arrange the screens to match their physical positions.
- Start with the default resolution, then check text size and usable workspace.
- Choose an appropriate refresh rate; return to the default when a special rate is no longer needed.
- Change the main display only if you need different behavior.
- Move the pointer and a window across every screen boundary.
- Check text, video, screen sharing, and sleep/wake behavior.
- Save the verified setup if you use the same displays regularly.
Press Command–P in your browser to print this checklist or save it as a PDF.
1. Check the Mac and the complete connection
Confirm the display count, resolution, and refresh-rate combinations supported by your exact Mac model. Every cable, adapter, and dock between the Mac and the display must also support the signal you want to use.
Make sure the display has power and is set to the input connected to the video cable. When connecting more than one display, Apple recommends connecting the highest-resolution display first.
Start with Apple's guide to connecting a display to your Mac for the requirements that apply to your model.
2. Get a stable picture before changing modes
If the screen stays blank, reseat the power and video cables and check the selected input. Where possible, connect the display directly to the Mac to isolate a dock or adapter.
In System Settings → Displays, hold Option to reveal Detect Displays when it is available. DeskCommit can only control screens macOS already detects. It cannot repair an unsupported cable, dock, adapter, DisplayLink configuration, or bandwidth problem.
3. Choose an extended desktop or mirroring
An extended desktop gives each screen separate workspace. Mirroring shows the same content on the external display as on the Mac. Decide this before arranging screens: mirrored displays do not act as independent positions in the layout.
4. Match the layout to the desk
In System Settings → Displays → Arrange, position the screens to match their physical locations: left, right, above, or below the reference screen. Align the shared edge where you normally move the pointer between them.
Move the pointer across every boundary and correct any unexpected jump.
In DeskCommit, use the default shortcut, Control–Shift–D, to open the palette. Select a display, and use an arrow key for direction and Shift–Arrow for edge or center alignment. Review the pending position and press Return to apply it. While the palette remains open, Command–Z undoes the last applied display change.
You can change the shortcut in DeskCommit Settings.
5. Start with the default resolution
Once the connection is stable, check text size, usable workspace, and application performance at the default resolution. Adjust from there rather than changing modes while troubleshooting the connection.
Apple notes that a display may go black after an unsupported resolution change. Wait 15 seconds for it to revert, or press Escape if the confirmation is visible.
In DeskCommit, a pending change that includes a Low Resolution (LoDPI) mode requires Option–Return. You then have 15 seconds to keep it. Without confirmation, DeskCommit restores the previous display mode.
6. Check the connection when a refresh rate is missing
Available rates depend on the Mac, display, resolution, cable, adapter, and dock. Choose a rate suited to your content, and return to the default when a special rate is no longer useful.
If a rate is missing, check those connection requirements. DeskCommit cannot create a rate that is not available through the connected hardware.
7. Change the main display only when needed
The main display affects where the menu bar and some new windows appear. Leave it unchanged if the current behavior works for you. To change it, see how to change the main display on Mac in System Settings or with the keyboard. After changing it, open a new window to check that the result matches your expectation.
Menu bar and window behavior can also depend on your macOS desktop settings.
8. Test the setup with real work
- Move the pointer and a window across every screen boundary.
- Read small text on each display and check the available workspace.
- Play video or other moving content if refresh rate matters to your work.
- Open a screen-share preview and check which display you are about to share.
- Test sleep and wake once for a permanent desk setup.
9. Save the settings after checking them
Once arrangement, resolution, refresh rate, and the main display work as intended, press Command–S in DeskCommit and give the setup a recognizable name.
Restoration is manual and is available only when the connected display set matches the saved set exactly. The product page explains the display controls and saved setups.
If the picture is still unstable
- Test a direct Mac-to-display connection to isolate the dock or adapter.
- Check the cable and adapter specifications for your target resolution and refresh rate.
- Recheck your exact Mac model's supported display count and combinations.
- Install applicable macOS updates and display, dock, or adapter firmware updates.
- Return to the default resolution and refresh rate, then change one setting at a time.
If the Mac still does not detect the screen or the picture remains unstable, continue with Apple's external display troubleshooting guide.
Apple references
DeskCommit Personal
Set up displays from your keyboard.
macOS 13 or later. Apple silicon and Intel. Up to two Macs for one person.
One-time purchase · No recurring charge · 7-day money-back guarantee