Signed-off-by: Marko Korhonen <marko.korhonen@reekynet.com>

2020-01-19 23:43:52 +02:00

2.2 KiB

Raw Blame History

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
    -h, --help       Prints help information
    -r, --resume     Sets the backlight to the value it was before dimming
    -V, --version    Prints version information

OPTIONS:
    -c, --config <config>    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, only for the resume operation `-r`	25

Installation

So far, I have only packaged this for Arch Linux

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

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