LiQuid Screen Dim

A simple utility which dims your screen. It saves the previous brightness too, so you can restore to the point before dimming.

This is useful if you are running a standalone screen locking setup like swayidle/swaylock. Check out my configuration files for an example use case.

Usage

USAGE:
    lqsd [FLAGS] [OPTIONS]

FLAGS:
    -d, --dim            Dims the screen to idle level set in configuration
    -r, --resume         Sets the backlight to the value it was before dimming
        --copy-config    Copies the default config file to $XDG_CONFIG_HOME/lqsd
    -h, --help           Prints help information
    -V, --version        Prints version information

OPTIONS:
        --config <FILE>    Sets a custom config file

The configuration file resides at ~/.config/lqsd/config.toml. There you can set these values:

Key	Explanation	Default
resume_file	The location where the previous brightness is saved	/tmp/lqsd-resume
idle_level	The minimum brightness that will be dimmed to. Can be a value between 0-100	0
dim_speed	This sets the "sleep time" between each backlight command. It's in milliseconds	50
resume_speed	Same as dim_speed, but for the resume operation `-r`	25

Installation

Dependencies

The only external dependency is light

Building

Clone this repository and run cargo build --release inside the project to compile a static binary.

Arch Linux

So far, I have only packaged this for Arch Linux. Packages are in AUR

To install it, use your favorite AUR helper, yay for example:

yay -S lqsd

Or if you don't want to build it from source, a binary version is also available:

yay -S lqsd-bin

Releases

Release notes can be found in GitHub (Gitea does not support editing tags yet)

Prebuilt binaries, their checksums and signatures can also be found there

Why Rust?

I wanted start a small project to learn Rust. Before lqsd, I was using this script and figured, why not rewrite it in Rust.

Mirrors

This repository lives at ReekyNET Git, but it is also mirrored to GitLab and GitHub

2.8 KiB Raw Blame History