Skip to main content

Brightify is an OS-independent application that adjusts monitor brightness using the DDC/CI protocol and custom protocols for USB monitors, featuring a brightness sensor for automatic adjustments based on ambient light, and can be controlled via a taskbar icon.

Project description


Brightify

CodeFactor

This app allows you to set the brightness of your monitor(s). It is essentially a wrapper around the DDC/CI protocol, which is supported by most monitors. It also supports adding custom communication protocols to control the brightness of USB monitors. For this, you most likely need to reverse engineer the communication protocol of the monitor. In my experience, this provides a more stable experience than using the DDC/CI protocol. You can find an example implementation for the Gigabyte M27Q in here. The app is designed to be run in the background and can be controlled via a taskbar icon. It also supports a brightness sensor that can automatically adjust the brightness based on the ambient light.

Getting started

  1. Install brightify by running pip install Brightify. This package is regularly uploaded to PyPi. If you want to install the latest version, you can clone this repository from GitHub and install it with pip install -e . in the root directory.
  2. To start the app: python -m brightify run. You can exit either by right-clicking the icon in the taskbar and selecting "Exit" or by pressing Ctrl+C in the terminal.
  3. To start the app at startup (or logon) and add a menu icon, run python -m brightify add all. To remove the both, run python -m brightify remove all.

Optional arguments

There are several other arguments you can pass to the app, see python -m brightify --help for more information.

  • To target add/remove only the startup run python -m brightify add/remove startup.
    • To add a task to the task scheduler on Windows, pass --use-scheduler. It will request elevated permissions.
  • To add/remove only the menu icon run python -m brightify add/remove menu-icon.
  • By default, the terminal will be hidden, but you can change this by passing the --force-console argument to the run or add action.
  • To disable animations, pass the --no-animations argument to the run or add action.

Set up the brightness sensor

  • Modify the SensorComm class to match your device and firmware
  • Modify the code that is polling from the brightness sensor Device Firmware
  • Modify platformio.ini and enter your board ( see supported boards)
  • Run pio run -t upload in the terminal to upload the firmware to the board. If everything is working, the Auto Checkbox for each supported Monitor should now be clickable

Remarks

  • Currently, only the Windows task bar icon is supported, the main part of this app is OS independent.
  • Feel free to create a pull request and add your own USB Monitor
  • Note that a USB Monitor will replace a DDC/CI Monitor with the same name. If you want to use both, you need to change the name of your USB Monitor implementation. In case a monitor is found but does not send its name, we cannot distinguish between DDC/CI and USB Monitors. In this case, both will be added.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

brightify-0.1.11.tar.gz (38.5 kB view details)

Uploaded Source

Built Distribution

Brightify-0.1.11-py3-none-any.whl (47.3 kB view details)

Uploaded Python 3

File details

Details for the file brightify-0.1.11.tar.gz.

File metadata

  • Download URL: brightify-0.1.11.tar.gz
  • Upload date:
  • Size: 38.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.5

File hashes

Hashes for brightify-0.1.11.tar.gz
Algorithm Hash digest
SHA256 5d91553b09b2d4ded6b6d81bbe00d5f68db4188afc4d52094e607f896ccf7445
MD5 bdb22077de8d170c178f9fb5d58c9d0d
BLAKE2b-256 f368fa6b8e003871cac8072ec5dbc2f7be960a5da70a417204df85f8a001570b

See more details on using hashes here.

File details

Details for the file Brightify-0.1.11-py3-none-any.whl.

File metadata

  • Download URL: Brightify-0.1.11-py3-none-any.whl
  • Upload date:
  • Size: 47.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/5.0.0 CPython/3.12.5

File hashes

Hashes for Brightify-0.1.11-py3-none-any.whl
Algorithm Hash digest
SHA256 08b32b4fbf082b4066ad9618f98b76d68361fce2f986f8a57112eb3ff5be39df
MD5 a37271a2124deb65521239b5e93b2059
BLAKE2b-256 fb3d4ab8bef1f1f724fb371c1715c041e80d54cd99e0d65ebc3f1971de407beb

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page