DISPLAY_TO_HLG(1)

πŸ’– DISPLAY_TO_HLG β€” the manual page, bestie edition ✨

okay so you found display_to_hlg in the User Commands section of the manual and you're like "what is this" β€” don't worry, I got you. sit down, grab a strawberry πŸ“, we're doing this together.


🌸 NAME 🌸

display_to_hlg β€” literally just display_to_hlg. that's it. that's the whole name. iconic minimalism, no notes πŸ’…


✨ SYNOPSIS ✨

display_to_hlg input output [OPTIONS...]

read that again bestie. input, then output, then whatever OPTIONS you wanna sprinkle on top. that's the whole vibe πŸ¦‹


πŸ‘‘ DESCRIPTION πŸ‘‘

okay here's where it gets juicy. the options live right here in the description, so let's go one by one, no skipping, we're thorough in this house πŸ’œ

  • -m nits, --max_nits=nits β€” the maximum luminance of the display. basically: how bright can this screen possibly go? tell it in nits, it's not gonna guess 😭
  • -s nits, --surround_nits=nits β€” the surround luminance of the viewing environment. like, what's the light situation around the screen. default is 5. yes, five. it's giving cozy dim room energy πŸ•―οΈ
  • --preserve_saturation=0..1 β€” to what extent to try and preserve saturation over luminance if an inverse gamma < 1 generates out-of-gamut colors. so like, if things go out of gamut, how hard do we fight to keep the saturation? zero to one, that's your range. rip to anyone who likes gamut surprises πŸ’€

and then the positional args, which honestly deserve their own moment:

  • input β€” the input image. the one you're bringing in. the main character πŸ‘‘
  • output β€” the output image. the glow-up. the after photo ✨
  • -h, --help β€” prints the help message. and listen, all the options are shown above it. no cap, everything is up there ☝️
lowkey a reminder: those positional args are just as real as the flags, so input and output are not optional garnish, they're the whole meal 🍽️

🫢 AUTHOR 🫢

this manual page was written by Mathieu Malaterre <malat@debian.org> for the Debian GNU/Linux system β€” but bestie, it may be used by others too. open invite, slay 🌈


and that's the whole page!! version display_to_hlg 0.11.2, dated August 2026 β€” go read it again whenever you need it, i'll be right here πŸŽ€πŸ’–

πŸ“¦ where this page comes from