A highly customizable YouTube Music theme featuring dynamic backgrounds and glassmorphism. Available for Better Lyrics Extension and Pear Desktop.
- Full site-wide theme for YouTube Music
- Dynamic backgrounds that change with the current song, or use static colors/images
- Highly customizable
- Modern glassmorphism UI with blur and rounded corners
- Smooth, configurable animations that can be adjusted or disabled
Toggleable player enhancements:
- Centered player controls
- Increment skip buttons
Note: The animations may affect performance and can be disabled in the settings.
Install Better Lyrics Extension For Youtube Music.
Known Limitations
- Background transitions don’t work in Firefox yet.
Method 1 (Built-in):
- Open extension settings → Themes → Click Change → Select Dynamic Background.
Method 2 (Marketplace):
- Open Theme Marketplace → Search for "Dynamic Background" → Click Install.
The Album Color Theme plugin is required for dynamic background functionality.
Known Limitations
-
On Pear Desktop 3.11.0, the Album Color Theme plugin has been reported to not work properly on some systems such as macOS, Fedora, and Arch-based Linux. See #3857.
-
Dynamic backgrounds behave differently from the Better Lyrics version, as Pear Desktop does not provide a variable for fetching the song’s album cover. This implementation relies on the Album Color Theme plugin as a workaround.
-
The search suggestion background blur workaround does not work on Pear Desktop yet due to its current Chromium 140 base, where CSS anchor behavior differs from Chromium 144+. This should be resolved once Pear updates to a compatible Chromium version.
- Download
style.css - Open the app menu → Options → Visual Tweaks → Theme → Import custom CSS file
- Select the downloaded
style.css - Restart the app
Image: NASA
Background Blur Setting: 0.05
All variables are defined at the top of the CSS/RICS file.
- Edit values to customize colors, fonts, layout, and animations
- Supports standard CSS formats (rgb, rgba, hex, etc.)
- Custom fonts must be installed on your system
Animations
- Better Lyrics: uses
on/offtoggles - Pear Desktop: set duration to
0sto disable
Notes
- Dynamic backgrounds on Pear require the Album Color Theme plugin
- Better Lyrics includes presets (
default,light,dark) as quick starting styles. You can still override any value manually - Pear Desktop uses CSS variables (
--cfg-*) and comment-based toggles
- Better Lyrics v2.2.0 and later
- Pear Desktop 3.11.0 (tested)
This theme is licensed under the MIT License, allowing you to use, modify, and redistribute it. If you reuse or fork any part of the theme, please credit the original project and preserve this license notice. Any code snippets borrowed from other themes are already credited within this repository.
- walm-git's Modern YouTube Music Theme, which served as the base CSS for this theme.
Snippets used in this theme:
- Background Fix: Mixcraftio's Customisable Youtube Music Theme V3
- Search Box and Song Timestamp: zgoly's YouTube Music Frosted Glass
The theme is also heavily inspired by “Even Better Lyrics Plus” by Noah & BetterLyrics for Better Lyrics extension.
This CSS started from a theme made by walm-git, and over time I’ve rebuilt nearly every part of it. It’s now mostly my own work. A lot of hours went into it, digging through DevTools, reading other people’s code, getting stuck, and figuring things out along the way. I’m really proud of how it turned out.
Thanks to everyone who uses this theme. I hope you enjoy it as much as I enjoyed making it. And thank you to everyone who supported the project from the beginning—those who left feedback, shared kind words, and the people credited above.
Thank you.
Sincerely, Cheng