Omahub
← All plugins
J

Night Light

by Jeremy Langer

Night light switch and editable schedule for hyprsunset

GitHub

Security review

No obvious issues detected

Deterministic scan — not a security guarantee

None
Risk level
None
Analyzed commit
e6c36d1
Scanned
2 weeks ago

No potentially dangerous behavior detected in the analyzed commit.

Automated analysis only — not a security guarantee.

AI advisory review

No obvious issues detected

Language-model assessment · ~deepseek/deepseek-v4-flash-latest — advisory only

None
AI risk level
None
Recommendation
install
Model
~deepseek/deepseek-v4-flash-latest
Analyzed commit
e6c36d1
Reviewed
2 weeks ago

This plugin only manages the local hyprsunset night-light config and process: it writes ~/.config/hypr/hyprsunset.conf through a Perl helper that rejects symlinks and writes atomically, and it invokes hyprctl/uwsm-app with fixed or numeric-validated arguments. The test harness is isolated and there are no install hooks, network calls, or hidden persistence mechanisms.

How this check works

This review combines the deterministic scan (the rule-based results above) with an independent look at the plugin's code by a language model. The model reads a trimmed sample of the repository's files, the manifest, and the README, then gives a plain-language risk level and a recommendation: install (no notable danger), review (look closer first), or avoid (clearly dangerous).

It runs on the same analyzed commit as the deterministic scan and is strictly advisory — it is not a security guarantee and never blocks a plugin by itself. A human moderator still reviews plugins before they are listed.

AI advisory only — automated analysis, not a security guarantee.

Install
$ omarchy plugin add https://github.com/jeremylanger/omarchy-nightlight --enable
Widgets #bar #quickshell #system

Night Light

Omarchy bar widget for the built-in night light (hyprsunset): on/off switch and an editable schedule, next to the clock.

Night Light panel

  • Click the icon to open the panel; right-click to toggle without opening.
  • Edit turn-on time, turn-off time, and temperature, then Apply. This writes ~/.config/hypr/hyprsunset.conf and restarts hyprsunset. File access goes through nightlight-file.pl (Perl ships with Omarchy): the config must be a regular file, not a symlink; writes are atomic.
  • Gradual fade eases the screen in and out instead of snapping. Turn it on and set how long it should take (5-240 minutes); the same duration is used at both ends. In both cases the time you set is when the ramp begins: with a 20:00 turn-on, a 07:00 turn-off and a 60 minute fade, the screen leaves 6500K at 20:00 and reaches the target by 21:00, then starts back up at 07:00 and is fully neutral at 08:00. The panel draws both ramps as gradient bars painted in the colours the screen will pass through. While a fade is actually running, that bar grows a marker at the current position and the temperature above it; outside a fade there is nothing to report, so neither appears. Switching the light off during a fade, or any time before the next fade out, stops hyprsunset rather than just setting a neutral temperature: its schedule would otherwise re-warm the screen at the next step. It is started again at the point the schedule agrees the light is off, so the following evening runs normally. hyprsunset holds one temperature per profile, so each fade is written out as a staircase of one-minute profiles. Steps are spaced evenly in mireds, not kelvin, so each one is the same perceived shift — around 5 mired for an hour-long fade, which is well under what the eye catches on a slow ramp. Either ramp is shortened automatically if it would otherwise run into the other end of the schedule.
  • Changing only the temperature while the light is on applies instantly, with no flash. The hyprsunset restart it needs is deferred until the light is next off.
  • The icon hides when the light is off and reveals on hover, like the stock indicators.

Install

omarchy plugin add https://github.com/jeremylanger/omarchy-nightlight --enable

Optional: remove the stock night light indicator from the bar so this one takes its place. In ~/.config/omarchy/shell.json, set items on the omarchy.indicators entry to exclude NightLight, then place this widget next to it:

omarchy bar move io.github.jeremylanger.nightlight --section center

For the schedule to run at login, make sure ~/.config/hypr/autostart.lua has:

o.launch_on_start("hyprsunset")

Remove

omarchy plugin remove io.github.jeremylanger.nightlight

Your hyprsunset.conf is left as is.

IPC

omarchy-shell io.github.jeremylanger.nightlight open    # or close, toggle, apply
omarchy-shell io.github.jeremylanger.nightlight fade on 60   # or: fade off ""

Dependencies

Omarchy (Quattro or newer), hyprsunset, and perl — all part of a stock install. No external services. The widget reads and sets hyprsunset itself, so it works with the stock omarchy.nightlight plugin enabled or disabled.

Tests

tests/run.sh

Runs the widget in Quickshell against the installed Omarchy UI, with hyprsunset faked. Needs a Wayland session; it never touches the live display.

License

MIT