Brightness Restore - A GNOME Shell extension that solves the "missing persistence" issue for software brightness controls (especially on external monitors combined with OLED/Wayland setups).
It automatically saves your local brightness adjustments and restores them upon login, ensuring your preferred brightness level is always maintained.
Status: Live on GNOME Extensions (ID: 9214).
- Persistence: Automatically saves the last known brightness level to disk.
- Auto-Restore: Applies the saved brightness level immediately upon session startup.
- Integration: Connects directly to Gnome Shell's internal
brightnessManager. - Indicator: Shows a simple percentage indicator in the panel (configurable).
- Positioning: Choose to place the indicator on the Left or Right of the QuickSettings area.
Status: ✅ Passing
Last Updated: 2026-01-29 14:56:31 UTC
Summary: 0 errors, 0 warnings
Click to view full lint output
> brightness-restore@3.0.0 lint:fix
> eslint --fix extension .scripts --format stylish
Latest Update (v3)
- Attach the first real PreferencesPage to the window (avoids Adw warnings without dummy pages).
- Logging UI: Open Log Folder + Clear Log File actions (shown only when debug + file logging enabled).
- Log file path resolution now respects custom paths and defaults to cache directory when empty.
You can configure the extension using standard Gnome Extensions settings (or dconf).
| Setting | Default | Description |
|---|---|---|
| Restore on Startup | true |
Whether to restore the saved value on login. |
| Indicator Style | quick-settings |
standalone (Panel Button) or quick-settings (Pill). |
| Indicator Position | right |
left, right, or default (Only for Quick Settings). |
| Interval | 2 |
Internal update interval (debounced save). |
./build.shCopy the extension/ folder to ~/.local/share/gnome-shell/extensions/brightness-restore@DarkPhilosophy.
