Skip to main content

A Python tool to control monitor brightness on Windows and Linux

Project description

screen_brightness_control

A Python tool for controlling the brightness of your monitor

How to install (Pip):

  • Open a terminal and run "pip3 install screen-brightness-control"

How to install (Github):

  • Clone/download the repository
  • Enter the folder it has been cloned to and run "pip3 install ."
  • That should be all

How to use:

import screen_brightness_control as sbc
current_brightness = sbc.get_brightnness()
if current_brightness<100:
    sbc.set_brightness('+5')

The module has 2 basic functions: set_brightness and get_brightness.

get_brightness

Returns the current screen brightness in percent by default.
On Linux you can run get_brightness(raw_value=True) to get the 'actual value' which is usually stored in /sys/class/backlight/*/brightness.

set_brightness

Accepts either an integer or a string input. Any floats will be converted to integers.
You can also pass strings such as '+5' or '-15'. These are added/subtracted from the current brightness.
On Linux the brightness goes to a minimum of 1 unless you pass the 'force=True' kwarg. This is because setting the display brightness to 0 on Linux usually turns the screen off, which is not ideal.
You can also pass 'raw_value=True' as a kwarg to make the program attempt to write the number you supply directly to the /sys/class/backlight/*/brightness file. However, this will often not work as that file is above user permissions.

Both functions return False upon failure.

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

screen_brightness_control-0.1.5.tar.gz (3.4 kB view hashes)

Uploaded Source

Built Distribution

screen_brightness_control-0.1.5-py3-none-any.whl (3.6 kB view hashes)

Uploaded Python 3

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