DimScreen.ini Explained: dimming, hotkey1 and hotkey2

DimScreen keeps its configuration in a small text file called DimScreen.ini, stored in the same folder as DimScreen.exe. For such a tiny file it generates a surprising number of questions — mostly because old forum posts describe keys that do not exist, and people go looking for settings the program never had. This article documents exactly what the file contains, based on the program’s own source: one section, three keys, and nothing else.

The Whole File: One Section, Three Keys

Open DimScreen.ini in any text editor and you will find a [Settings] section with up to three entries. The first is dimming, which holds the startup dimming level — the value from 0 to 9 that corresponds to the tray menu’s steps of 0% through 90%. The factory default, when no .ini exists, is 5, which is the 50% level the program starts at on a fresh run. The second key is hotkey1, the combination that increases dimming (makes the screen darker); the factory default is Ctrl + plus. The third key is hotkey2, the combination that decreases dimming (makes the screen brighter); the factory default is Ctrl + minus.

That is the complete list. There is no key for selecting a monitor, no key for scheduling, no key for per-application behaviour, and — despite what some old guides claim — no key called DimKey. Anything beyond dimming, hotkey1, and hotkey2 is not read by the program, so adding invented lines to the file does nothing. If a tutorial tells you to add a key that is not one of these three, the tutorial is wrong about this program.

How the File Gets Written

You are not expected to author this file by hand. DimScreen writes it when you save changes in the Settings dialog — right-click the tray icon, choose Settings, adjust the startup dimming level or either hotkey, and confirm. The program then records dimming, hotkey1, and hotkey2 in DimScreen.ini itself, in the format it expects. This is why the supported advice is always “use the Settings dialog”: hand-editing risks typos and stale values, while the dialog guarantees the file matches what the program will actually load at the next start.

The file’s location rule is equally simple: it must sit beside the executable. Move DimScreen.exe without its .ini and the program behaves as a fresh copy, using defaults and creating a new .ini the next time settings are saved. Keep them together — especially on a USB stick, where the pairing is what makes your configuration portable — and the tool behaves identically on every machine.

Reading the File for Troubleshooting

Where the .ini genuinely earns its keep is diagnosis. If your hotkeys seem wrong, open the file and read hotkey1 and hotkey2: what is stored is what the program loaded, regardless of what you remember setting. If the wrong startup level keeps appearing, check dimming: a value of 5 means the 50% default is in effect, whether because it was saved that way or because the file beside the .exe is a fresh one rather than the copy you edited elsewhere.

A classic trap is having two copies of the program — one in a Downloads folder, one in a permanent folder — each with its own .ini. Editing one copy’s settings and launching the other produces the baffling result that “settings never save.” They do save; they save next to the copy you configured. Find every DimScreen.exe on the disk, keep one in a permanent home with its .ini, delete or ignore the others, and the mystery disappears. If the file is ever damaged or filled with doubtful edits from old advice, the clean reset is simple: exit the program, delete DimScreen.ini, run DimScreen again, and set your preferences once through the Settings dialog.

What the File Does Not Do

Because .ini files in other programs can hold dozens of options, it is worth listing what this one pointedly does not control, so you stop looking for it here. There is no monitor selection: the overlay targets the primary display, full stop. There is no schedule or automatic evening mode: the program applies its level when it runs and when you change it. There is no transparency curve, colour, or per-window behaviour: dimming is a single level from the ten tray steps. And there is no update, network, or account setting of any kind — the program predates that pattern and simply does not have the machinery. Each of those absences is sometimes reported as a “missing setting” in old threads. They are not missing; they were never features. The file’s three keys are the program’s whole configuration surface, and that smallness is precisely why the program is easy to back up, move, and reason about.

Frequently Asked Questions

What keys does DimScreen.ini contain?

Exactly three, in a [Settings] section: dimming (the startup level, 0–9, default 5 = 50%), hotkey1 (darken, default Ctrl + plus), and hotkey2 (brighten, default Ctrl + minus).

Is there a DimKey setting?

No. DimKey does not exist in the program. The only hotkey keys are hotkey1 and hotkey2, written by the tray Settings dialog.

My settings never seem to save. Why?

Usually there are two copies of DimScreen.exe, each with its own .ini, and you are launching a different copy than the one you configured. Keep a single copy in a permanent folder, with its .ini beside it.

Related Guides

Similar Posts