Soft Brightness Plus uses an alpha overlay to control the brightness on all or some of your monitors. It integrates smoothly and does not interfere with other Gnome Shell features. It works flawlessly with the Night Light, the Magnifier from the Accessibility Services, or with screen captures (as long as they are initiated by Gnome Shell).
Common uses are:
-
Your laptop has no backlight, maybe because it's not supported, or you have an OLED display.
-
You want to control the brightness level of external monitor like you do with your built-in screen.
Bonus features:
-
Minimum brightness level: do not get lost in the dark.
-
Can operate the shell in tear-free (VSync) mode at all time.
-
Disables itself temporarily when a screen shot is taken.
Soft Brightness Plus comes with a configuration panel, which can be accessed from the "Tweaks" application or the Gnome Shell Extensions page.
When enabled, Soft Brightness Plus will work together with your computer's backlight. The brightness slider and keyboard brightness hotkeys will control both the backlight and the Soft Brightness Plus overlays. This is most useful:
-
if you have a backlight and Monitors is set to External, or
-
if a backlight is detected by Gnome but is not working (like some OLED panel laptops which report having a backlight brightness which doesn't exist). In that latter case Monitors should be set to All.
If Use backlight control is disabled, the Brightness slider will only control the Soft Brightness Plus overlays. The keyboard brightness hotkeys will keep their default bindings.
-
If set to All, a brightness overlay will be added to all attached monitors.
-
If set to Built-in, the brightness overlay will only be added to the built-in monitor, which is the setting right below Monitor(s).
-
If set to External, a brightness overlay will only be added to all monitors which are not the built-in monitor, defined in the setting right below Monitor(s).
A list of currently attached monitors is displayed. Pick from the list which monitor should be considered the built-in monitor.
The setting only has an effect if Monitor(s) is set to Built-in or External.
Choose one of:
-
Do not enforce brightness in full-screen: When an application enters full-screen mode, remove the brightness overlays. You may want to try this setting if your applications' refresh rate is lagging in full-screen. The application will unredirect its window and will bypass Gnome Shell's compositing (this is the default for full-screen applications in Gnome Shell unless changed by another extension).
-
Brightness enforced in full-screen: The brightness overlay stays active when an application enters full-screen mode. This also prevents the app from unredirecting its window (its surface will be composited with Gnome Shell, and as a side-effect, will be subjected to vertical refresh synchronization, ensuring tear-free rendering). This is the default.
-
Brightness enforced in full-screen, always tear-free: Works like Brightness enforced in full-screen, but will still prevent full-screen applications from unredirecting their windows even if no brightness overlay is active (brightness is 100%). Applications will then always be rendered tear-free, whatever the brightness may be. In this mode, Soft Brightness Plus can be used as a replacement for extensions like Fix Fullscreen Tearing.
Sets the minimum allowable brightness for the display where 0 is completely dark and 1 completely bright. Defaults to 0.1 (10%).
The minimum brightness will also be enforced for the panel backlight if Use backlight control is on.
When the brightness is set to 0%, the display will go completely dark, it may be hard to reset the brightness with the slider then.
Toggles between having the mouse cursor brightness follow the screen brightness (on/true) and keeping the mouse cursor at full brightness (off/false).
Gnome Shell's handling of cursor tracking can be sometimes buggy and can show the wrong cursor type or size when the mouse cursor brightness follows the screen brightness. It also introduces some pointer motion lag.
Note that if an other Gnome Shell component enables mouse tracking (for example the Zoom accessibility option), then the mouse cursor brightness will always follow the screen's.
When toggled on, Soft Brightness Plus will log extra debugging information to the system journal (or syslog).
This will be useful if you encounter a bug: In that case, please turn Debug on, and try to reproduce the issue with that setting before capturing the debug logging.
Soft Brightness Plus's debug messages can be watched with:
journalctl -f | grep 'gnome-shell.*soft-brightness-plus'
Soft Brightness Plus will cause extra load on the hardware and therefore slightly increase power usage, as it needs to add extra alpha layers and track the mouse among other things. This is true of any Gnome Shell extension.
If Soft Brightness Plus controls an LCD panel, changing the brightness will not change at all the panel's power consumption. Use the backlight instead: Changing the backlight brightness will affect power consumption, the lower the brightness, the lower the power usage.
If Soft Brightness Plus controls an OLED panel, changing the brightness will affect power consumption, the lower the brightness, the lower the power usage.
Soft Brightness Plus can be used to control the brightness of all your attached monitors:
-
Set Use backlight control to Off.
-
Set Monitor(s) to All.
You can leave the control of your attached display to the backlight and use Soft Brightness Plus to control the brightness of external displays:
-
Set Use backlight control to On.
-
Set Monitor(s) to External.
-
Configure Built-in monitor to your built-in panel's name.
For example an OLED panel or non-functional backlight. Have Soft Brightness Plus control the brightness for all your monitors:
-
Set Use backlight control to On.
-
Set Monitor(s) to All.
Soft Brightness Plus is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
You should have received a copy of the GNU General Public License along with this program. If not, see [http://www.gnu.org/licenses/].
Install directly from the Gnome Shell Extensions site.
Or download the zip file from the GitHub releases page and run:
gnome-extensions install soft-brightness-plus@joelkitching.com.v40.shell-extension.zip- meson v0.50.0 or later.
-
Check out:
git clone https://github.com/jkitching/soft-brightness-plus -
cd soft-brightness-plus -
Run meson:
meson build -
To install in your your gnome shell extensions' directory (~/.local/share/gnome-shell/extensions), run ninja:
ninja -C build install -
To build the extension zip files, run:
ninja -C build extension.zip, the extension will be found underbuild/extension.zip.
- Fixed some bugs introduced by using
===and!==strict equality operators on gnome-shell objects by changing to truthy/falsy checks.
- Rewrite mouse cloning to fix bug (see GitHub issue) introduced as of gnome-shell 46.
- Update MouseSpriteContent in src/cursor.js to match changes in gnome-shell/js/ui/magnifier.js.
- Rename Clutter.Container terminology in function calls and signal names from "actor" to "child".
- Fix a bug which would access a previously-removed property when changing the "use-backlight" setting.
- Re-implement preferences window using Adw.ActionRow. This conveniently sidesteps the "window too small" issue.
- Split main class into multiple compartmentalized classes.
- Add my name to copyright message in preferences window.
- Fix up code for style and consistency.
- Re-implement logger.js instead of using meson-gse.
- Changes requested by extensions.gnome.org code review of v35.
- Update copyright notices at top of files to include my name.
- Rewrite to support GNOME 45. Since it is now required to
use ECMAScript modules, and since the
importandexportmechanisms are not compatible with previous GNOME versions, declare compatibility bankruptcy, and drop all support for previous GNOME versions. - Code is vastly simplified by removing all of the workarounds to support multiple versions of GNOME with the same file.
- Since the GNOME extensions website supports hosting multiple builds for different GNOME versions, simply leave all GNOME versions prior to 45 using Soft Brightness Plus v34.
- If bugfixes need to be made to version 34, a branch can be cut, and fixes can be applied there.
- Rewrite
enable()function as async in order to wait for the existence ofquickSettings._brightness. - Hard-code width and height of the preferences window, since after converting it to use Adw, the default width is not large enough to contain all widgets.
- Rewrite and simplify screenshot functionality. No longer need to handle cases for different GNOME versions.
- Code formatting: re-tabbing and other minor changes.
- Fix a bug which broke disabling and enabling the extension,
due to
ScreenshotClassgetting registered multiple times. - Rename project to "Soft Brightness Plus". Ensure consistent capitalization and formatting of the name.
- Fix a bug in checking for
global.backendbefore use. - These changes were requested as part of review on
extensions.gnome.org:
- Drop support for unstable GNOME releases 3.33 and 3.35.
- Refactor
ScreenshotClasscreation to include access tosoftBrightnessExtensionvia closure. - Stop storing reference to extension as a global.
- Support Gnome Shell 43 and 44.
- Support Gnome Shell 42.
- Drop compatibility with Gnome Shell 3.32. The earliest supported version is now 3.33.90.
- Fix version detection code to handle non-numeric versions (eg. 42.beta).
- Fix error at startup ("TypeError: this._overlays is null").
- Meson-gse update: Support js91, meson 0.61.
- Cleanups.
- Fixed long standing issue with Mouse cursor brightness control not working on Gnome 40 and later.
- Declare compatibility with version 40 and 41 of Gnome Shell instead of using minor versions (40.0 and 41.1). This should clear reports of the extension being incompatible with well-supported versions.
- Drop compatibility with Gnome Shell 3.28 and 3.30 (which do not have getSettings/initTranslations in ExtensionUtils).
- Update meson-gse:
- Fix build issues with meson 0.60.0.
- Bump minimum meson version to 0.50.0.
- Clean up code:
- Remove Lang imports.
- Use ExtensionUtils for getSettings/initTranslations instead of using meson-gse's convenience.js.
- Drop old Gnome Shell 3.28 compatibility code.
- Gnome Shell 41 compatibility.
- Update meson-gse to latest:
- Bug fix for preferences logging.
- Add Dutch translation (courtesy of @Vistaus).
- Gnome-shell 40.0 compatibility.
- Update preferences for Gnome-shell 40.0.
- Disable mouse cloning on Gnome-shell 40 and later.
- Update meson-gse to latest:
- Now prints the GJS version in the system log at start-up (if debug is enabled).
- Support more mozjs version (78, 68, 52) for build-time syntax
checks (
ninja test).
- Fix mouse cursor offset bug on GS 3.38.
- Added Persian translation.
- Added Turkish translation.
- GS 3.38 compatibility: CursorSprite.set_anchor_point has been removed.
- Only disable mouse tracking on Gnome-Shell 3.38 when gjs 1.65 up to 1.66.0 inclusive are detected.
- Report gjs version in log.
- Kludgy work-around a Gnome-Shell bug where mouse tracking doesn't generate events by delaying the mouse tracking initialization after the extension has loaded.
- Disable mouse tracking on Gnome-Shell 3.38 until Gnome-Shell Issue #3237 is fixed.
- Support Gnome-Shell 3.38.
- Add a preference for toggling mouse cloning.
- Fix typos.
- Update French translation.
- Fix Gnome-shell 3.34 cursor tracking broken on Wayland
- Enhance cursor tracking performance regression on GS >= 3.34 introduced in version 16.
- Gnome-shell 3.36 compatibility.
- Fix deprecation warning in preferences.
- Update meson-gse to latest.
- Re-enable mouse cloning on Wayland GS >= 3.34.1 (work-around only active for 3.33.90 < GS < 3.34.1).
- Added Czech translation (thanks to p-bo on GitHub).
- Fix annoying bug on GS 3.34 where the brightness slider will creep back to 100% whenever changed to something lower (only when using backlight control).
- Now compatible with GS 3.34 and GS 3.35.1.
- Do not clone mouse on GS > 3.33.90 when running under Wayland (work-around Mutter issue #826).
- Minor code clean-ups.
- Show GS version and session type (Wayland/X11) at start-up when debugging.
Fixed broken version 13 update.
- Fix slider not up-to-date at start on GS 3.33.90.
- Fix broken GS 3.32 compatibility code.
- Note that this version is broken. Please use versions 12 (on Gnome-Shell 3.32 and lower), or version 14 (all Shell versions).
- Gnome-shell 3.33 compatibility.
- Fix Drag-n-Drop (eg. in Overview).
- Fix bug where the cursor sprite changes were not tracked correctly on Gnome Shell 3.28.
- Fix regression crash by infinite recursion when attempting to "Use backlight" without a hardware backlight. If that happens, the extension will use its internal setting for the brightness value.
- Fix extension errors on Gnome Shell 3.32.
- Fix cursor disappearing when external monitors are plugged in or the Monitor(s) preference setting is changed.
- Fix flickering on Gnome Shell 3.32 when mouse hovers non-overlaid display sections but overlays are active on other monitors.
- Fix mouse still being tracked unnecessarily when the overlays should activate but don't because the monitors they would apply to are not connected.
- Gnome Shell 3.28 compatibility.
- Expand documentation.
- The mouse pointer is now affected by the brightness.
- Better & simpler Magnifier handling.
- Fix bugs.
- Improved code maintainability.
- Remove the overlay during screenshots: they are now unaffected by the brightness setting.
- Keep the brightness setting when the magnifier (aka. Universal Access Magnifier/Zoom) is on.
- Fix bugs.
- Fix warning in logger.js that was introduced in version 6.
- ES6 / Gnome-Shell 3.32 compatibility (still compatible with 3.30 and lower).
- Updated meson-gse to latest.
- Minor doc updates.
- Updated meson-gse to latest.
- Fix extension error on disable.
- Fix extension error on enable-disable-enable.
- Minor non-user visible, internal changes to preferences dialog.
- Minor doc updates.
- README.md: Meson 0.44.0 or later is required.
- README.md: Add credits.
- Drop duplicate shipped file in lib/convenience.js.
- Add GPLv3 in LICENSE.
- Use meson-gse for building: custom scripts moved there.
- Fix french translations not showing up.
- Beautify preferences dialog.
- Fix a few strings for consistency.
- Fix wrong gettext-domain in schema file.
- Remove all global variables from extension.
- Moved to git.
- Use meson for builds, restructure source tree.
- Added internationalization, and french translation.
- Added LICENSE and README.md files.
- Show git revision in debug logging.
- Brightness overlays now mask the entire desktop, including transients.
- Brightness overlays don't prevent DND actions in the overview anymore.
- Fix a couple of typos.
-
The extension now removes the standard brightness control and puts its own in place (as opposed to trying to monkey patch the existing control).
-
Handle external/built-in monitor.
-
Control what happens in full-screen.
The git release shows as 3 in the source code, but the extension (as built by the Gnome Shell Extensions website) shows the release at 2. Let's call it release 2 then.
First public release.
- The
meson-gsecredits are included here by reference.