/hass-favicon

🔹 Change the favicon of your Home Assistant instance

Primary LanguagePythonMIT LicenseMIT

favicon

hacs_badge

Change the gui page title, favicon and app icons of your Home Assistant instance

browser

Installation instructions

  • Copy the contents of custom_components/favicon/ to <your config dir>/custom_components/favicon/.

  • Get some icons

    There are some nice ones available here, and you can generate favicons from them using an online tool, such as this one.

  • Put your icons in e.g. <your config dir>/www/favicons/. Note that <your config dir>/www/ translates to /local/ for the Icon path. Note: If you created <your config dir>/www/ you need to restart Home Assistant once before any icons will be found.

About the icons

hass-favicon will scan the specified directory and automatically apply icons when found based on their filename. There are three types of icons, and it's important that you get the filenames correct.

  • favicon.ico - The icon which is displayed on the browser tab and in the bookmark menu
  • favicon-apple-<anything>.png - The icon which is displayed if you save your interface to the home screen of your iDevice.
  • favicon-<size>x<size>.png - Used by android devices. <size> indicates the icon size in pixels, e.g. favicon-1024x1024.png.

Method 1/2 Integration

  • Go to your Home Assistant configuration and to Integrations

  • Add a "Favicon" integration

  • Enter your wanted title and the path to your icons. E.g. Icon path: /local/favicons/

  • Press submit

  • Refresh the page. Make sure to clear the cache of your browser to get the new icons.

integration

Method 2/2 YAML configuration

  • Add the following to your configuration.yaml:
favicon:
  title: My Home
  icon_path: /local/favicons/
  • Restart Home Assistant

  • Make sure to clear the cache of your browser to get the new icons.

Options

  • title - The title to display at the top of the window or browser tab.

  • icon_path: - The path (frontend path) of the directory containing your icons.

it IS charging thankyouverymuch


Buy Me A Coffee