Skip to content

wessamlauf/frosted-glass-manager

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

73 Commits
 
 
 
 
 
 

Repository files navigation

Frosted Glass Theme Manager 🎨

HACS Badge Home Assistant Maintainer Buy Me a Coffee

Frosted Glass Manager logo

Customize your Frosted Glass experience without touching a single line of YAML. 🛠️

Frosted Glass Theme Manager is a powerful companion integration for Home Assistant. It allows you to easily customize the popular Frosted Glass aesthetic directly from the UI. Change colors, switch backgrounds, and generate optimized theme files instantly.

✨ Features

  • UI Color Picker: Change the Primary Color for both Light and Dark modes using a visual picker. No more editing code! 🎨
  • Smart Tonal Palette: This isn't just a simple color swap. The manager mathematically calculates a complete Material Design tonal palette (shades 05–95) based on your chosen color. This ensures text remains readable and contrast stays perfect. 🧠
  • Custom Backgrounds: Easily paste a URL for your custom background images. 🖼️
  • Dual Generation: With a single click, the manager generates two themes:
    1. Frosted Glass Custom: The full experience with blur and glass effects. ❄️
    2. Frosted Glass Custom Lite: A performance-optimized version for older devices (no blur). ⚡
  • Instant Updates: Changes are applied immediately without needing to restart Home Assistant. 🚀

🚀 Installation Guide

Step 1: Prerequisites

  • You must have HACS installed.
  • You must have the card-mod integration installed (required for the glass effects to work).

Step 2: Install via HACS

  1. Open HACS -> Integrations.
  2. Click the menu (three dots) in the top right -> Custom repositories.
  3. Paste this repository URL: https://github.com/wessamlauf/frosted-glass-manager
  4. Select Category: Integration.
  5. Click Add, then find Frosted Glass Theme Manager in the list and install it.
  6. Restart Home Assistant.

Step 3: Install Manually (Alternative)

  1. Download this repository.
  2. Copy the custom_components/frosted_glass_manager folder into your config/custom_components/ directory.
  3. Restart Home Assistant.

⚙️ Usage & Configuration

Once installed and restarted, you need to add the integration to your instance:

  1. Go to Settings -> Devices & Services.
  2. Click Add Integration (bottom right).
  3. Search for "Frosted Glass Theme Manager".
  4. Finish the setup.

How to Customize:

  1. Find the integration in your list and click CONFIGURE.
  2. You will see a form where you can set:
    • Light Mode Primary Color ☀️
    • Light Mode Background URL
    • Dark Mode Primary Color 🌑
    • Dark Mode Background URL
  3. Click SUBMIT.

The integration will automatically generate two new files in your themes/ folder: Frosted Glass Custom.yaml and Frosted Glass Custom Lite.yaml.

Activating the Theme:

  1. Go to your Profile (click your name in the bottom-left corner).
  2. Under Theme, select either Frosted Glass Custom or Frosted Glass Custom Lite.

🔄 Reset to Defaults

Want to go back to the original "Blurple/Blue" look?

  1. Open the integration configuration.
  2. Check the box: RESET to Defaults.
  3. Click Submit.

Everything will revert to the original Frosted Glass color scheme.


🖼️ Screenshots (color picker/custom color/custom background)

Untitled design (1)

image

❤️ Support the Project

If this tool helped you make your dashboard beautiful and saved you time, consider buying me a coffee!

Buy Me A Coffee


🐞 Issues / Feedback

Found a bug or have a suggestion?
Open an issue on GitHub.

This integration is based on the visual design of the Frosted Glass Themes.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Languages