Skip to content

A comprehensive Linux monitor brightness control script with multi-language support and advanced features for managing display brightness across single and multi-monitor setups.

Notifications You must be signed in to change notification settings

felipefacundes/brightness_adjust

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 
 
 
 
 
 
 

Repository files navigation

Brightness Adjust

A comprehensive Linux monitor brightness control script with multi-language support and advanced features for managing display brightness across single and multi-monitor setups.

This script is part of the shell_utils framework, one of the largest collections of scripts and utilities designed to enhance user experience on Linux systems.

Features

  • Multi-monitor Support: Control brightness across all connected displays simultaneously or individually
  • Extensive Language Support: Includes localization for multiple languages:
    • Portuguese, French, Spanish, German
    • Russian, Romanian, Hebrew, Arabic
    • Chinese, Korean, Japanese
    • English (default)
  • Fine-grained Control: Precise brightness adjustment with values from 0.00 to 0.99
  • Persistent Settings: Maintains brightness values between sessions
  • User-friendly Interface: Simple command-line arguments with intuitive controls
  • Robust Error Handling: Comprehensive input validation and dependency checks

Installation

# Clone the repository
git clone https://github.com/felipefacundes/brightness_adjust

# Enter the directory
cd brightness_adjust

# Make the script executable
chmod +x all_bright

Dependencies

  • xorg-xrandr (The script will prompt for installation if not found)

Usage

./all_bright [option]

Available Options

  • i or +: Increase brightness
  • d or -: Decrease brightness
  • = or set: Set specific brightness value (0.00 to 0.99)
  • m: Set brightness for a specific monitor
  • l: List connected monitors
  • h: Display help information

Examples

# Increase brightness
./all_bright +

# Decrease brightness
./all_bright -

# Set specific brightness value
./all_bright set 0.75

# Set brightness for specific monitor
./all_bright m HDMI-1 0.80

# List connected monitors
./all_bright l

Technical Details

  • Uses xrandr for direct hardware communication
  • Maintains state through temporary files in /tmp
  • Implements proper error checking for system dependencies
  • Provides flexible brightness adjustment options
  • Supports both percentage and decimal values
  • Built-in safety checks to ensure xrandr is installed and monitors are properly connected

Integration

This script is a component of the larger shell_utils framework, which provides a comprehensive suite of utilities for Linux systems. For the complete collection of tools and utilities, visit the shell_utils repository.

License

This project is licensed under the GPLv3 License.

Credits

Created and maintained by Felipe Facundes.

Contributing

Contributions are welcome! Feel free to submit pull requests or create issues for bugs and feature requests.

Support

If you encounter any problems or have questions, please open an issue in the project repository.

About

A comprehensive Linux monitor brightness control script with multi-language support and advanced features for managing display brightness across single and multi-monitor setups.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages