Clight(1)

📦
version 4.11 · 2 versions
, in nixos 26.05

💖 NAME 💖

Clight — a user daemon utility that aims to fully manage your display. That's it, that's the whole vibe. It's Clight(1), section 1 of the manual, and bestie it is so much more than it sounds, keep reading 👑

✨ SYNOPSIS ✨

clight [-vw?] [-f, --frames INT] [-d, --device video0] [-b, --backlight
intel_backlight]
[--no-backlight-smooth] [--no-gamma-smooth] [--no-dimmer-smooth-enter]
[--no-dimmer-smooth-exit]
[--day-temp INT] [--night-temp INT] [--lat DOUBLE] [--lon DOUBLE]
[--sunrise 07:00] [--sunset 19:00]
[--no-gamma] [--no-dimmer] [--no-dpms] [--no-backlight] [--no-screen]
[--no-kbd]
[--dimmer-pct DOUBLE] [--no-auto-calib] [--shutter-thres DOUBLE]
[--gamma-long-transition] [--ambient-gamma]
[-c, --conf-file STRING] [-w, --wizard] [--verbose] [-v, --version] [-?,
--help] [--usage]

That's the whole launch menu, no cap. Every flag below has its moment 💅

🦋 DESCRIPTION 🦋

Okay so here's the tea ☕ — clight lets you match your backlight level to ambient brightness, and that ambient brightness is computed by capturing frames from webcam or Ambient Light Sensors. Like, it literally looks at the room and goes "mm, yes, this is the brightness we're doing today" 🌸

It does also support adjusting external monitors and keyboards backlight, which honestly? iconic. Multi-device queen behavior 👑

Moreover, it can manage your screen temperature, dim your screen after a timeout, and manage screen DPMS. So it's giving full display custody arrangement, and you're the one winning 🫶

🎀 OPTIONS 🎀

  • -c, --conf-file config-file — Parse an additonal config-file to override other configs. Yes, extra configs, on top of the ones you already have — it overrides them 💖
  • -v, --version — Print program version. Literally just tells you what version you're on, and honestly sometimes that's enough 🫶
  • -w, --wizard — Run a small wizard to calibrate sensor curve. A wizard. In your terminal. Go be the main character of your own sensor calibration 🧚
  • -f, --frames number — Customize frames taken for each capture, between 1 and 20. Respect the range, bestie, it's not a suggestion ✨
  • -d, --device device — Specify sensor device. If empty, first matching device is used. So if you don't pick a fave, it just adopts the first one it finds, lowkey 🦋
  • --no-backlight-smooth — Disable backlight smooth transitions. Instant jumps only, no gentle glide 💀
  • --no-gamma-smooth — Disable gamma smooth transitions. Same energy, but for gamma 🌈
  • --no-dimmer-smooth-enter — Disable smooth transitions while entering dimmed state. Dimming go snap, not swoosh 🙈
  • --no-dimmer-smooth-exit — Disable smooth transitions while leaving dimmed state. Waking back up is now abrupt, periodt ✨
  • --day-temp number — Customize daily screen temperature. Your daytime glow-up, your rules 🌞
  • --night-temp number — Customize nightly screen temperature. Cozy hours, cozy kelvins 🌙
  • --gamma-long-transition — Enable a very long smooth transition for gamma (redshift-like). Emphasis on very long. It's a slow burn, iykyk 🔥
  • --ambient-gamma — Enable screen temperature matching ambient brightness instead of being time based. So it stops clock-watching and starts room-reading 👀
  • --lat double — Desired latitude. Yep, actual coordinates, we're being geographic now 🗺️
  • --lon double — Desired longitude. The other half of the coordinates, matching set fr fr 🌍
  • --sunrise time — Specify sunrise time for gamma correction. Like 07:00 in the synopsis — that's your golden hour cue ⭐
  • --sunset time — Specify sunset time for gamma correction. 19:00 in the synopsis, and then it's cozy mode 😌
  • --no-gamma — Disable gamma correction tool. Off. Gone. Not today ✋
  • --no-dimmer — Disable dimmer tool. Your screen will simply refuse to fade away dramatically 💅
  • --no-dpms — Disable dpms tool. No display power management shenanigans 💀
  • --no-backlight — Disable backlight calibration tool. The core feature? Yeah you can just turn it off 😭
  • --no-screen — Disable screen emitted brightness correction tool. Screen brightness correction, canceled 🙈
  • --no-kbd — Disable keyboard backlight calibration tool. The keyboard gets to stay however it wants, lucky thing ⌨️
  • --dimmer-pct double — Backlight level used while screen is dimmed, in pergentage. That's percentage, but with flavor — and yes, it's a double, so decimals are welcome 🍓
  • --verbose — Enable verbose mode. It will tell you everything. Everything. Grab a snack 🍿
  • --no-auto-calib — Disable screen backlight automatic calibration. You want manual control? Respect, icon behavior 👑
  • --shutter-thres double — Threshold to consider a capture as clogged. Like, if something's blocking the sensor, this is where it calls it out 💀

🌸 FILES 🌸

  • /nix/store/aa921lyr99w6x6ijgrkrf4saz4g9wgsh-clight-4.11/etc/clight/clight.conf — The system wide configuration file. The big boss config, everyone shares it 🏛️
  • $HOME/.config/clight.conf — Per user configuration file. Your personal config, your personal vibes, just for you 🎀

💜 AUTHOR 💜

Federico Di Pierro nierro92@gmail.com ⟨mailto:nierro92@gmail.com⟩ — thank him, he built the whole display-management situation we're all living in 🫶

That's the page, bestie! You were reading Clight(1) from the User Manuals collection on Linux — the manual-page equivalent of a group chat you're now fully caught up on 💖✨ See you in the next one, mwah 🎀

📦 where this page comes from