wlsunset is a lightweight utility that adjusts the colour temperature of displays connected to Wayland compositors supporting the wlr-gamma-control-unstable-v1 protocol.
The program changes the appearance of the screen according to the time of day. During daylight hours, it uses a higher colour temperature, gradually transitioning to warmer tones as evening approaches.
wlsunset calculates sunrise, sunset and twilight periods using geographical coordinates and the system clock. Alternatively, users can specify fixed transition times if they prefer a consistent schedule.
The utility runs without a graphical configuration interface. Its behaviour is controlled through command-line options, making it suitable for minimalist Wayland desktops and users who prefer managing their display settings through scripts.
This is free and open source software.
Key Features
- Adjusts display colour temperature through the Wayland wlr-gamma-control-unstable-v1 protocol.
- Automatically calculates day, twilight and night periods from latitude, longitude and the current date.
- Configurable high and low colour temperatures, with defaults of 6500K for daytime and 4000K for nighttime.
- Custom solar-elevation thresholds control the beginning and end of twilight transitions.
- Supports manually configured sunrise and sunset times in place of automatic solar calculations.
- Adjustable animation duration when using manually specified transition times.
- Can apply adjustments to all connected displays or selected outputs identified by name.
- Provides configurable gamma correction independently of the colour temperature settings.
- Runtime mode switching using SIGUSR1 cycles between forced daytime, forced nighttime and automatic modes.
- Uses a combination of daylight and black-body colour models to produce natural-looking temperature changes.
- Gradual transitions between warmer and cooler colours minimise abrupt changes in the display’s appearance.
- Command-line configuration makes it suitable for integration into compositor startup scripts.
Website: sr.ht/~kennylevinsen/wlsunset
Support:
Developer: Kenny Levinsen
License: MIT License
wlsunset is written in C. Learn C with our recommended free books and free tutorials.
Related Software
| Eye Care Software | |
|---|---|
| Safe Eyes | Simple and extensible break reminder |
| Clight | Lightweight C daemon that turns your webcam into a light sensor |
| Stretchly | Reminder to take breaks |
| BreakTimer | Set up customizable breaks and will remind you to take them |
| Workrave | Assists in the recovery and prevention of Repetitive Strain Injury |
| Gammastep | Adjust the color temperature of your screen |
| wluma | Adaptive brightness based on screen content and ambient light |
| hyprsunset | Blue-light filtering and gamma adjustment for Hyprland |
| ZenBreak | Menu bar app that reminds you to take breaks |
| RSIBreak | Take care of your health and take regular breaks |
| sunsetr | Automatic blue-light filter |
| wlsunset | Adjusts display color temperature on Wayland compositors |
| Stretch Break | Digital wellbeing tool that helps you take regular breaks |
| Sane Break | Gentle break reminder |
| Taline | Eye-break reminders based on the 20-20-20 rule |
| eyerest | Remind your eyes to take a screen break |
| Blink | Configurable reminders to take regular screen breaks |
Read our verdict in the software roundup.
 LinuxLinks helps you discover the best free and open source software for Linux. Explore our extensive collection of recommended applications, including alternatives to popular proprietary software.We also publish software reviews, Linux tutorials, hardware reviews, free programming books and articles covering the wider open source community. Browse our Linux resources to discover more. Know a useful free and open source Linux application we haven't covered? Suggest a program for inclusion. Has your software been featured on LinuxLinks? Display one of our Featured on LinuxLinks badges on your website or GitHub README. |
Please read our Comment Policy before commenting.