ddc-brightness 1.0.0

# ddc-brightness

A simple, fast command-line tool for controlling monitor brightness on Windows and Linux. Designed for easy brightness management across multiple displays. Supports increasing or decreasing brightness by a set amount.

This is a fork of [lumix](https://github.com/Yrrrrrf/lumix).

## Features

- 🖥️ Multi-monitor support
- 📊 Visual brightness indicator
- 🚀 Fast and lightweight
- 🎯 Simple command interface
- 📈 Show brightness range for each monitor
- 🎨 Formatted output
- 💯 Changing brightness by a relative amount

## Usage

### Basic Commands

- Get brightness:
```bash
ddc-brightness get  # List all monitors and their brightness
ddc-brightness get 12345  # Specific monitor brightness
```

- Set brightness:
```bash
ddc-brightness set 75  # All monitors to 75%
ddc-brightness set 10+  # Increase all monitors by 10%
ddc-brightness set 5-  # Decrease all monitors by 5%
ddc-brightness set 12345 50  # Specific monitor to 50%
```

### Output Example

```
Monitor 12345: 75% [0..=100] ██████████░░░░░░░░░░
```

Where:
- `12345`: Monitor identifier
- `75%`: Current brightness (bold)
- `██████████░░░░░░░░░░`: Visual brightness indicator
- `[0..=100]`: Supported brightness range

## Troubleshooting

### Common Issues

1. **Monitor Not Found**
   - Ensure the monitor supports DDC/CI
   - Verify the monitor handle is correct

2. **Permission Denied**
   - Run the command prompt as administrator

3. **Invalid Brightness Value**
   - Use values between 0 and 100

### Error Messages

- `Monitor X not found`: Invalid monitor handle
- `Invalid brightness value`: Brightness must be 0-100
- `Error setting brightness`: Monitor might not support DDC/CI

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

This project is licensed under the [MIT License](./LICENSE).