At half past two one morning I walked into my office and found one of my monitors blazing. Not subtly off. Blazing: a reading lamp in a room that was otherwise trying to sleep. I dragged the sliders down, squinting, and went back to bed wondering what I had broken.
The next morning I asked the obvious question: what did the app do at 2:30? It keeps a diary of every change it makes and why, so the question was answerable. And the diary’s answer was uncomfortable: nothing broke. The app had done exactly what I taught it. The problem was what I taught it.
The thermostat problem: settings taught in the wrong light
Imagine setting your thermostat’s winter temperature on a mild October afternoon while wearing a sweater. You pick a number that feels right. Then the first real cold night arrives, the furnace faithfully holds the number you chose, and you wake up freezing. The thermostat isn’t broken. Your instruction was. It was given under conditions that only resembled the real thing.
That is precisely what had happened. This Mac app learns each monitor’s dim setting from you: you dim the room, set every screen by eye, and it remembers. But the night I taught it “dim,” the room wasn’t truly dark: lights on, evening, curtains open. A merely-dim room. When the first genuinely black night came, the app went looking for levels it had never been taught, extended the pattern it knew, and one monitor’s pattern pointed somewhere bright.
The app is a player piano. It performs whatever roll you recorded. Beautifully, faithfully, and even at 2:30 a.m.
The fix was already happening
Here is the part worth telling the story for. Those sleepy drags at 2:30, pulling each screen down to where it should have been, weren’t just first aid. In this app, adjusting a slider is teaching. Each drag replaced the bad lesson with a real one: this is what these monitors should do in actual darkness. By morning the calibration was healthier than it had ever been, and a warning the app had been quietly showing (two reference points suspiciously close together) had cleared on its own.
I fixed it without knowing I was fixing it, just by doing the natural thing. That is what I mean when I say the app has no second, hidden way of learning. There is no settings page where calibration lives apart from use. Use is calibration.
Keep a diary: what the app’s log tells you
The other lesson is about the diary. Brightness is ambient. It changes while you’re asleep, while the monitor wakes, while clouds pass. When something looks wrong, the difference between a mystery and a five-minute answer is whether anyone wrote down what happened. This app logs every adjustment with its cause: the light sensor moved, a monitor woke up wrong and was corrected, a hand was on a slider. Plain text, on your machine, readable by you.
So the 2:30 a.m. mystery took one cup of coffee to solve, and the answer made the app better at exactly one thing: telling you sooner when a lesson was taught in the wrong light. If you ever hit your own 2:30 a.m., the diary is waiting, and the fix is the same. Drag the sliders to where they should be, in the light where it matters. The piano records a new roll.