wlsunset(1)

📦
version 0.4.0 · 9 versions
, in opensuse-leap 16.0

💅 wlsunset(1) — day/night gamma adjustments, but make it cozy

okay so bestie, welcome to wlsunset(1) 💖 this is a page from the General Commands Manual, and honestly? it's giving "your screen but it knows what time it is." no cap.

Here's the whole vibe: wlsunset does day/night gamma adjustments for Wayland compositors that support wlr-gamma-control-unstable-v1. that's it. that's the whole product. iconic behavior, zero notes. ✨

🦋 SYNOPSIS

wlsunset [options...]

that's literally it — you just run it with some options and let it do its little gamma thing. 🎀

🌸 OPTIONS

every single flag, bestie, not one skipped, i promise 🫶

  • -h — shows this help message. the "help me help you" button. 💅
  • -T <temp> — sets the high temperature (default: 6500). this is your daytime baddie setting. ☀️
  • -t <temp> — sets the low temperature (default: 4000). this is the 3am "everything is warm and soft" era. 🌙
  • -l <lat> — sets the latitude (e.g. 39.9). where are you on this earth, bestie? 🌍
  • -L <long> — sets the longitude (e.g. 116.3). the other half of the coordinates. 🗺️
  • -S <sunrise> — manual time for sunrise as HH:MM (e.g. 06:30). you're overriding the sun fr fr. 🌅
  • -s <sunset> — manual time for sunset as HH:MM (e.g. 18:30). sun's going night-night on your schedule. 🌇
  • -d <duration> — manual animation time in seconds (e.g. 1800). how slowly the transition glides. so smooth. 🧚
heads up bestie: this one is only applicable when you're using manual sunset/sunrise times. so like, don't come for it if you're in auto mode. 😭
  • -g <gamma> — sets the gamma (default: 1.0). the final little seasoning on top. ⭐

🎀 RUNTIME CONTROL

so you don't have to restart anything — sending SIGUSR1 to wlsunset causes it to cycle through the following modes, in this exact order, one press at a time:

  1. Forced use of the high temperature. 🔥
  2. Forced use of the low temperature. 💜
  3. Automatic temperature calculation — and that's the default behavior, so this is where it lives most of the time. 🌈

three modes, one signal, no drama. iykyk. 😌

✨ EXAMPLE

okay here's the actual example from the page — Beijing lat/long, look at her go:

# Beijing lat/long.
wlsunset -l 39.9 -L 116.3

and then the page says something truly iconic, and i quote the meaning exactly: greater precision than one decimal place serves no purpose (https://xkcd.com/2170/) other than padding the command-line. so like. don't do 39.9042. it's not slaying, it's just extra. 💀

👑 AUTHORS

Maintained by Kenny Levinsen <contact@kl.wtf>. 💖 For more information about wlsunset development, see https://sr.ht/~kennylevinsen/wlsunset. go be nosy, it's encouraged. 🦋

and that's the whole page, bestie! this one's dated 2024-04-23, from the General Commands Manual, filed under wlsunset(1) — so go forth, set your temperatures, and let your screen be cozy at the right hours. slay. 💅✨🌸

📦 where this page comes from