You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This PR introduces a customizable background gradient feature, allowing users to define up to five colors, gradient angle, and transparency.
The gradient is applied on top of existing themes rather than introducing new theme variants, enabling lightweight visual customization without affecting the core theming system.
Examples using the Silver and Butter themes are shown below:
Implementation
Introduced CustomThemeManager for dynamic background styling
Added color pickers and controls in Appearance settings
Gradient is computed and applied at runtime based on user settings
Design considerations
This proposal builds on the discussion in #357 with some differences:
Blur support is implemented but currently not exposed in the UI, as its visual impact is minimal in the current layout. This can be revisited in future iterations.
No additional structural class hooks were introduced. The implementation avoids relying on internal layout details, reducing maintenance overhead and improving compatibility with future UI changes.
How to test
Enable "Custom Background" in settings
(De-)select multiple colors
Adjust angle and transparency
Disable the setting and confirm it resets as intended
Thank you for your submission, we really appreciate it. Like many open-source projects, we ask that you all sign our Contributor License Agreement before we can accept your contribution. You can sign the CLA by just posting a Pull Request Comment same as the below format.
I have read the CLA Document and I hereby sign the CLA
0 out of 2 committers have signed the CLA. ❌ @johel004 ❌ @LilyLavenderPony johel004 seems not to be a GitHub user. You need a GitHub account to be able to sign the CLA. If you have already a GitHub account, please add the email address used for this commit to your account. You can retrigger this bot by commenting recheck in this Pull Request. Posted by the CLA Assistant Lite bot.
LilyLavenderPony
changed the title
Add: Custom background gradient support
feat: Custom background gradient support
Mar 26, 2026
I have read the CLA Document and I hereby sign the CLA
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
LilyLavenderPony
changed the title
Description
This PR introduces a customizable background gradient feature, allowing users to define up to five colors, gradient angle, and transparency.
The gradient is applied on top of existing themes rather than introducing new theme variants, enabling lightweight visual customization without affecting the core theming system.
Examples using the Silver and Butter themes are shown below:
Implementation
Design considerations
This proposal builds on the discussion in #357 with some differences:
How to test
Tested on: