Dell Night Light is a tool with wich one can schedule brightness and color temperature changes of ones Dell display.
Checkout repository. Open command line in /src folder and start a PowerShell session. Then simply execute the script Main.ps1.
> PowerShell
PS > . ./Main.ps1
As a User, i want my monitor to automatically adjust brightness whenever it gets dark, so that i don't have to myself.
As a User, i want my computer so spare my eyes with warm colors, when the sun has set.
- The program must save the brightness level and color temperature as a state, in order to read it on the next start up.
- The program must have the ability to retreive local sun set and rise times based on the region code of the machine its running on.
- The program must be able to parse datetime input and be able to handle false input (-formats). It should show errors accordingly.
- The application should provide a intuitive graphical user interface, in order to be accessible to a large variety of users.
- The input processing should not slow the application down nor interupt interaction flow.
- The user should be able to pick color temps from a expandable list.
- If the brightness of the display is set to below 25%, the application should present itself in dark mode.
| Set Times | |
|---|---|
| Type | GUI Interaction |
| Description | A user inputs times and ends the dialog by confirming, thereafter a scheduled task is set |
| Trigger | A user wants his monitor to dim and brighten by a set schedule |
| Result | Time data is saved to the Database and a windows scheduled task is set |
| Actors | User |
| Input information | Day time, night time |
| Preconditions | The input data must be in a parsable date time format, the application must have privilages required to interact with the windows task scheduler |
| Postconditions | The GUI dialog was ended positively, the setting of a task was successful |
| Essential steps | 1. Input data 2. Parse data 3. Confirm dialog 4. Write data to Database 5. Create task 6. Delete already existing task 7. Schedule task |
| Variants | 1a. Input data automatically by selecting the option to align task schedule to local sun rise/set times |
Unfortunately mermaid doesn't support use-case diagrams, so here's a png generated with yEd graph editor.
classDiagram
direction TB
class View
<<GUI>> View
View : -Model Model {mandatory}
View : -Hashtable~Control~ Controls {mandatory}
View : +View() void
View : +LoadValues() void
View : +StoreValues() void
View : -AddHandler(window#58;System.Windows.Window) void
View : -RetreiveReferences(window#58;System.Windows.Window) void
class Control {
<<enumeration>>
ConfirmButton
CancelButton
LocalTimesCheckBox
DayTimeTextBox
NightTimeTextBox
DayBrightnessTextBox
NightBrightnessTextBox
DayColorComboBox
NightColorComboBox
DDMPath
}
class Main
class Model
<<DataManagement>> Model
Model : -PSCustomObject Store {mandatory}
Model : +Model() void
Model : +WriteValuesToDataBase() void
Model : +GetDDMPath() string
Model : +SetDDMPath() void
Model : +GetDayTime() string
Model : +SetDayTime() void
Model : +GetNightTime() string
Model : +SetNightTime() void
Model : +GetBrightnessDay() int
Model : +SetBrightnessDay() void
Model : +GetBrightnessNight() int
Model : +SetBrightnessNight() void
class Controller
<<BusinessLogic>> Controller
Controller : +CreateTask() void
Controller : +GetLocalSunSetAndRiseTimes() System.Tuple
View ..> Model : <<<read>read>>
View "1" --o "1" Main
Model "1" --o "1" Main
Controller "1" --o "1" Main
classDiagram
class View
View : Controls = {
View : #160;[DayTimeTextBox]#58; [TextBox]
View : #160;[NightTimeTextBox]#58; [TextBox]
View : #160;[DayBrightnessTextBox]#58; [TextBox]
View : #160;[NightBrightnessTextBox]#58; [TextBox]
View : #160;[LocalTimesCheckBox]#58; [CheckBox]
View : #160;[DDMPath]#58; [TextBox]
View : #160;[ConfirmButton]#58; [Button]
View : #160;[CancelButton]#58; [Button]
View : }
View : Model = [Model]
class Model
Model : Store = {
Model : #160;is_day = false,
Model : #160;ddm_path = "C#58;/Desktop",
Model : #160;day = {
Model : #160;#160;time = "08#58;00",
Model : #160;#160;brightness = 75
Model : #160;},
Model : #160;night = {
Model : #160;#160;time = "22#58;00",
Model : #160;#160;brightness = 10
Model : #160;}
Model : }
class Controller
class Main
View --o Main
Model --o Main
Controller --o Main
stateDiagram
direction LR
state Configuration
state Decision <<choice>>
state "Process input" as Processinput
[*] --> Configuration : Startup
Configuration --> Configuration : User input
Configuration --> Decision : End Dialog
Decision --> Processinput : Confirm
Decision --> [*] : Cancel
Processinput --> [*] : Set task
sequenceDiagram
actor User
participant App
participant DataBase
participant Windows
User ->>+ App : Startup
App ->>+ DataBase : Query current settings
DataBase -->>- App : Settings
App ->> App : Load settings into GUI
loop
User ->> App : Input
App -->> User :
end
User ->> App : End dialog
App -->> User :
App ->> App : Read out input fields
alt Window.DialogResult = True
App ->>+ DataBase : Write data
DataBase -->>- App :
App ->>+ Windows : Query for task existence
Windows -->>- App : Yes/No
alt task_exists = True
App ->>+ Windows : Delete task
Windows ->> Windows : Remove task
Windows -->>- App : Deletion successful/failed
end
App ->>+ Windows : Create task
Windows -->>- App : Creation successful/failed
end
App -->>- User :
sequenceDiagram
loop bi-daily
Windows ->>+ Task : Start
Task ->>- Windows : successfull/failed
end
This program was implemented with Powershell because of its communication capabilites with the Windows operating system and therefore with the Task Scheduler.
Currently the user data is stored in a JSON file, alternatively it could be implemented with a DataBase like MySQL.
See source code in src subfolder.
- Dell Display Manager executable
- Powershell
- assemblies: presentationframework, presentation
- implement time adjustment lined up with local sun rise/set times
- add input validation (in xaml using validation rules)
- make setting of color temperature available
- make setting of windows theme available