#brightness #system #command-line-tool #cli

app rumos

CLI utility for controlling screen brightness

2 releases

0.0.6 Jul 18, 2023
0.0.5 Jul 16, 2023

#16 in #brightness

MIT license

14KB
165 lines

☀️ Rumos

CLI utility for controlling screen brightness

asciicast

Installation

  • Build from source

    Clone repository
        git clone https://github.com/octagony/rumos.git
    
    Build project
        cargo build --release
    
    Find the executable file in target/release
    
  • Use cargo install

    cargo install rumos
    

Usage

Usage: rumos [OPTIONS] <COMMAND>

Commands:
  get   Get brightness level (in percent)
  set   Set brightness level (in percent)
  inc   Increase brightness level (in percent)
  dec   Decrease brightness level (in percent)
  max   Set maximum brightness level
  min   Set mininum brightness level
  help  Print this message or the help of the given subcommand(s)

Options:
  -q, --quiet    Do not output result to console
  -p, --percent  Print only brightness level(percentage)
  -h, --help     Print help
  -V, --version  Print version

Examples

  • Get brightness level in a percentage

    rumos -p get
    // 100%
    
  • Set the maximum brightness level quietly

    rumos max -q
    // No output
    
  • Decrease and display only brightness level in a percentage

    rumos -p dec 10
    // 90%
    
  • (Recipe) Use rumos with dunstify.

    You can find a script to control the brightness level in my DWM config. In a simplified version you can use this input

    dunstify $(rumos -p get) -t 2000
    

Dependencies

~5–38MB
~548K SLoC