Skip to content

crustyoldhuman/ProperDim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

220 Commits
 
 
 
 
 
 

Repository files navigation

Welcome to ProperDim 1.4.1!


Now you can dim your screen. Properly.

 

What is ProperDim?

ProperDim is a tiny-but-mighty screen brightness management and automation utility that includes a scheduler, hotkeys, and minimum brightness adjustment all packaged in a clean interface that won't get in your way.

Is ProperDim for me?

  • Are you running at least Windows 10? Then, YES!
  • Have the brightness options that came with your screen left you feeling unsatisfied and yearning for more? Then, YES!
  • Do you want to adjust your screens physical backlight? Then, NO!
  • Are you looking for something with a blue light filter? Then, NO!
  • Do you want your screen to go very dark? Then, YES!
  • Do you want to adjust your screens contrast, saturation, or that sort of thing? Then, NO!
  • Do you use multiple screens with one of them being a virtual (wireless) or USB connected device? Then, MAYBE! (see Multiple Monitor Support below for details)

What are the features of ProperDim?

Main Controls

The Controls tab is home to a responsive brightness slider which utilizes a hybrid dimming method that takes advantage of gamma adjustments in tandem with RGB manipulation to bring as accurate of an image as possible without sacrificing how low the brightness goes. Six QuickSet buttons are provided for instant access to common brightness levels. Below these you can find a link to open the Adjust Minimum Brightness settings.

In the Adjust Minimum Brightness window you can customize the minimum brightness value to whatever you see fit. Having a nice, dark black was important for me and the only way to ensure it was right for every screen was to allow adjustment of the minimum value. If the default setting is too bright or too dark for you, this is where you can dial it in exactly how you want it. The available minimum is *quite* dark, so be sure to take precautions against blacking out your screen by accident and enable the Hotkeys feature.

Event Schedule

The Schedule tab allows you to add events to the schedule list which will be automatically triggered when the set time comes to pass. The event list is sorted from top to bottom in chronological order, with upcoming events showing at the top and recently triggered events at the bottom. You can add new events by pressing the "+" button on the top right to open the Event Scheduler.

The Event Scheduler window provides all the fields required for a valid event. Entry fields for the time of day, brightness level to adjust to, and what days of the week it should trigger on are all presented. Enabling or disabling the 24-hour clock checkbox will convert the time entry fields as well as the events in the schedule to 12 or 24-hour format, respectively. The blue "Eyeball" icon will show you a preview of the brightness level. If you want to edit a previously added event, you can double-click the existing event in the full schedule list.

Hotkeys

With Hotkeys enabled you can program ProperDim to accept global hotkey commands to increase or decrease your brightness anytime and anywhere without needing to interact with the program directly. When using your assigned hotkeys, adjustments are done in 5% increments by tapping, or by holding down your hotkeys for larger adjustment changes.

System Tray Control

The right-click menu on the system tray icon houses expected program shortcuts as well as the QuickDim widget — an easy-to-access slider that lives directly in the right-click menu. The QuickDim slider works a lot like the windows volume icon widget. When the slider is visible, the scroll wheel adjusts the brightness, so dimming your screen is just one right-click away at all times. Clicking the icon with the left mouse button once will open the main Controls window, and another left-click will close it again.

Options

The Options tab provides some quality of life program features for the user. Here you can enable auto-start when Windows boots, change the behavior of the "Close" button on the Controls window, and whether to display or hide the main window when ProperDim starts up. You can also swap the left and right mouse click actions on the system tray icon if you'd like the tray menu behavior to match the Windows Volume icon. Finally, there are two red buttons for resetting the displays within the dimming system and clearing the event schedule. With these, you can reset the dimming system if something goes wonky or restart your schedule from a clean slate.

Multiple Monitor Support

Additional screens that are connected via traditional cables (HDMI, etc.) and natively support gamma adjustment are fully supported. This represents the large majority of usage cases, so you should be fine. If you are using a USB cable or wireless methods to connect to your secondary displays, they will likely ignore the first half of the brightness slider entirely. These types of connections will straight up lie to Windows about their capabilities, masquerading as genuine displays when they aren't which makes any "detection" logic unreliable at best. The only real solution I found was maintaining a complete list of displays and their functions on a cloud server for reference which is completely outside the intended scope of the project, so I begrudgingly accepted defeat on this.

Usage & Licensing

ProperDim is free to use, modify, and distribute without worry. The only thing you CAN'T do is use it to make money. This is a tool for humans, not for bank accounts. For full details & legal jargon, see the license document here.

System Requirements

  • Windows 10 and up
  • .NET Desktop Runtime 10.0 (x64) (Direct Download, 57.4 MB)
  • Between 7 MB and 140 MB of hard drive space, depending which installation method you use

Installation & Download

The release page has two installation versions available: Full and Lite

  • Full: The complete package including all Windows dependencies. Grab this if you don't wanna worry about anything (49.3 MB download)
  • Lite: Nothing but ProperDim itself (8.29 MB download)
  • Portable: Everything packaged in one .EXE, no install required (64.1 MB download)

The installers are available to download as .EXE's or compressed in .ZIP format. Right click -> Extract All to unzip these files to access the installer.

Additional setup instructions are provided on the release page as well as in the accompanying Tutorial (readme) file in the installation download.


**Honorable mention to Chiko for the invaluable bug testing. This would def be more broken without their eye.


After a lifetime of using HD TV's for PC screens due to minimal funds and living space, ProperDim feels like home to me. If you like ProperDim too, help spread the word and save another pair of eyeballs by telling a friend! I hope you have an awesome day/existence.