THE SETUP GUIDEFREE TESTING BETA

Your first dim.

Two apps. One comfortable desk.
Here’s what each one does, and how to get started.

01 / READ THE LIGHT

DimYourMini

Takes brief webcam samples, reads changes in image brightness and decides how your enabled screens should respond.

02 / REACH YOUR SCREENS

BetterDisplay

Provides the display controls this beta uses to read and change monitor brightness. It is a separate app and needs to stay running.

Yes, BetterDisplay is required for this beta. It isn’t bundled with DimYourMini. Its own feature availability, compatibility and license terms apply. You don’t need a separate command-line download or a Terminal command for this setup.

Before you begin: an Apple silicon Mac mini with macOS 14+, an external monitor controllable through BetterDisplay, and a webcam recognized by macOS. The Anker C300 shown below is our tested camera, not a required brand. Other cameras and displays still need testing.

01 / THE DISPLAY CONTROLS

Start with BetterDisplay.

Download BetterDisplay from its official website ↗, move it to your Applications folder, then open it. This beta expects /Applications/BetterDisplay.app.

Open BetterDisplay’s menu and check that your external monitors appear. Try its brightness slider for each monitor first. If a monitor doesn’t respond here, resolve that in BetterDisplay before starting DimYourMini.

Actual BetterDisplay menu listing HP 24mh and RTK QHD HDR, with a Brightness Combined slider at 62 percent
BetterDisplay 5.2.1 on our Mac mini. Two connected monitors are listed; your names and available controls may differ.

Ready when: each monitor you want to automate responds to BetterDisplay.

02 / THE CONNECTION

Let the two apps talk.

In BetterDisplay, open Settings → Application, then scroll to Integration. Confirm that Enable CLI access and notification based integration is on.

This lets DimYourMini send local brightness requests to BetterDisplay. Keep BetterDisplay running while you use automatic brightness. The custom URL scheme and HTTP server aren’t needed for this connection.

Actual BetterDisplay Application settings, Integration section, with Enable CLI access and notification based integration switched on
The required switch is already on on this Mac. No settings were changed for this screenshot. BetterDisplay’s integration guide ↗

Ready when: CLI access is on and BetterDisplay is still running.

03 / YOUR SCREENS, YOUR CALL

Meet your desk.

Download the DimYourMini beta, open the ZIP and move DimYourMini.app to Applications. Open it and connect your webcam and monitors.

The current download is ad-hoc signed and not notarized; macOS may block it. Only continue if you trust this beta and its source. If that happens, read Apple’s guidance on opening apps safely ↗ before deciding whether to proceed.

In Overview, choose your webcam under Your webcam. External monitors are detected automatically and enabled by default. Leave a monitor on to automate it; turn it off for manual control. At least one must be enabled to start.

Actual DimYourMini Overview before a session, showing two enabled monitors, a selected webcam, 5-second sampling and Start Auto Brightness in the toolbar
Actual idle app: two displays detected and enabled, camera selected, no readings yet. The camera stays off until Start. This is the local testing build.

Ready when: your webcam is available and the monitors you want to control are enabled.

04 / YOUR FIRST SESSION

Allow. Start. Settle in.

Set each enabled monitor to a comfortable brightness in your normal room lighting. Keep the webcam uncovered and in its usual position. In Overview, leave Read every at 5 seconds for your first test, then click Start Auto Brightness in the top-right toolbar.

Choose Allow if macOS requests camera access. To review permission, open DimYourMini’s Preferences → Camera & privacy. If access was denied, its System Settings… button takes you to macOS settings; allow DimYourMini under Privacy & Security → Camera, then try again. Apple’s camera permission guide ↗

Actual DimYourMini Preferences showing Camera permission Granted, System Settings button, brightness range 20 to 80 percent, and Sensor test only unchecked
Camera access is already Granted on this Mac, so there is no first-run permission dialog to show. Keep Sensor test only unchecked if you want the monitors to change.

Return to Overview. Once the first reading appears, change your room light and allow a few readings for the response to settle. The first reading and each monitor’s starting brightness form the initial reference. Sampling and smoothing mean changes aren’t instant.

Use Preferences → Brightness range to set your dim- and bright-room targets. Optional Mark dim room and Mark bright room in Overview let you calibrate two real lighting conditions. Keep the camera position the same for both.

Switching a display off attempts to restore its starting brightness and leaves it under manual control. Stop attempts to restore all controlled displays. Sessions stop after the selected duration—15 minutes by default. A crash, force quit, disconnect or stopped BetterDisplay can prevent restoration.

Ready when: readings arrive and your enabled displays follow a change in room light.

A LITTLE HELP

Something not following?

Readings change, but my monitor doesn’t.

Confirm BetterDisplay is in Applications and running, CLI access is on, and its own brightness slider works for that monitor. Check the monitor’s switch in Overview. In Preferences, Sensor test only must be unchecked. Stop the session before changing that mode, then start again.

My monitor is missing.

Check its cable, power and macOS connection, then confirm BetterDisplay sees it. Stop and reopen DimYourMini if needed. Display and adapter compatibility vary; physical hot-plug behavior is still being tested.

The response feels slow or doesn’t match the room.

Use 5-second sampling for the fastest available setting. Longer intervals intentionally delay readings. Keep the webcam in a stable position; auto-exposure, screen light and objects in the frame affect image brightness. Try the optional dim/bright calibration. The reading is relative camera luminance, not a lux measurement.

My webcam is unavailable or busy.

Check the selected camera and camera permission. Close other camera apps, refresh the camera list and try again. Stop DimYourMini during video calls; coexistence with meeting apps hasn’t been fully validated. Other webcam models still need testing.

Why does the camera indicator keep appearing?

The camera opens briefly for each reading, so its indicator lights during capture. Frames are processed in memory and released, without saved photos, video or microphone access. Choose 30–60 seconds for fewer captures, or Stop to end the session.

Get the free beta