Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

https://github.com/octagony/rumos

CLI utility to control screen brightness
https://github.com/octagony/rumos

brightness cli rust

Last synced: about 2 months ago
JSON representation

CLI utility to control screen brightness

Lists

README

        

# ☀️ Rumos

CLI utility for controlling screen brightness

[![asciicast](https://asciinema.org/a/BMPA2AsNL2k22ydjL5yQhCUxT.svg)](https://asciinema.org/a/BMPA2AsNL2k22ydjL5yQhCUxT)

## Installation

- Build from source

```bash
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

```bash
cargo install rumos
```

## Usage

```bash
Usage: rumos [OPTIONS]

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

```bash
rumos -p get
// 100%
```

- Set the maximum brightness level quietly
```bash
rumos max -q
// No output
```
- Decrease and display only brightness level in a percentage

```bash
rumos -p dec 10
// 90%
```

- (Recipe) Use rumos with dunstify.

You can find a script to control the brightness level [in my DWM config](https://github.com/octagony/dwm-config-files/blob/master/dwm/scripts/brightnessnotifications.sh). In a simplified version you can use this input

```bash
dunstify $(rumos -p get) -t 2000
```