Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/allanlaal/screen-brightness-cli
Change the brightness of all panels (monitors) of a X11 screen using DDC or xrandr brightness trick to get over 100% brightnesses
https://github.com/allanlaal/screen-brightness-cli
Last synced: about 2 months ago
JSON representation
Change the brightness of all panels (monitors) of a X11 screen using DDC or xrandr brightness trick to get over 100% brightnesses
- Host: GitHub
- URL: https://github.com/allanlaal/screen-brightness-cli
- Owner: allanlaal
- License: mit
- Created: 2024-09-11T16:35:03.000Z (4 months ago)
- Default Branch: master
- Last Pushed: 2024-09-11T17:13:05.000Z (4 months ago)
- Last Synced: 2024-09-12T02:15:02.926Z (4 months ago)
- Language: Shell
- Size: 3.91 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# screen-brightness-cli
Change the brightness of all panels (monitors) of a X11 screen using DDC or xrandr brightness trick to get over 100% brightnesses
# Brightness Control Script
This script adjusts the brightness of all connected screens to the same value. It allows users to increase, decrease, or set a specific brightness level using simple commands.
## Author
- **Allan Laal**
- **Email:** [email protected]
- **Repository:** [https://github.org/allanlaal/brightness](https://github.org/allanlaal/brightness)
## Requirements
- **ddcutil**: For controlling brightness on supported displays.
- **xrandr**: For controlling brightness on unsupported displays via a software method.
## Features
- Adjust brightness for all screens to the same level.
- Supports commands:
- `up`: Increase brightness by 10%.
- `down`: Decrease brightness by 10%.
- `+X`: Increase brightness by X%.
- `-X`: Decrease brightness by X%.
- `[number]%`: Set brightness to the specified percentage.
- Uses `ddcutil` for hardware-level brightness control (preferred).
- Falls back to `xrandr` for software-level brightness control if necessary.
## Usage
Run the script with one of the following arguments:
```bash
./brightness.sh
```
### Available Commands
1. **up**: Increases brightness by 10%.
```bash
./brightness.sh up
```
2. **down**: Decreases brightness by 10%.
```bash
./brightness.sh down
```
3. **+X / -X**: Increases or decreases brightness by X%.
```bash
./brightness.sh +20 # Increases brightness by 20%
./brightness.sh -15 # Decreases brightness by 15%
```
4. **[number]%**: Sets brightness to the specified percentage.
```bash
./brightness.sh 70% # Sets brightness to 70%
```
### Display Current Brightness
Simply run the script with no arguments to display the current brightness of the screens.
```bash
./brightness.sh
```