{"id":47728189,"url":"https://github.com/playfaster/very-dark-black-ha-theme","last_synced_at":"2026-05-02T02:01:28.502Z","repository":{"id":348425607,"uuid":"1196296364","full_name":"PlayFaster/very-dark-black-ha-theme","owner":"PlayFaster","description":"🟪  ⬛  A very dark black theme for Home Assistant  ⬛  🟦","archived":false,"fork":false,"pushed_at":"2026-04-29T00:28:15.000Z","size":297,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-29T01:25:09.113Z","etag":null,"topics":["dark-mode","dark-theme","hacs","hacs-theme","home-assistant","lovelace","lovelace-theme","theme"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/PlayFaster.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-30T15:02:14.000Z","updated_at":"2026-04-03T21:10:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/PlayFaster/very-dark-black-ha-theme","commit_stats":null,"previous_names":["playfaster/very-dark-black-ha-theme"],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/PlayFaster/very-dark-black-ha-theme","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlayFaster%2Fvery-dark-black-ha-theme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlayFaster%2Fvery-dark-black-ha-theme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlayFaster%2Fvery-dark-black-ha-theme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlayFaster%2Fvery-dark-black-ha-theme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/PlayFaster","download_url":"https://codeload.github.com/PlayFaster/very-dark-black-ha-theme/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/PlayFaster%2Fvery-dark-black-ha-theme/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32520156,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dark-mode","dark-theme","hacs","hacs-theme","home-assistant","lovelace","lovelace-theme","theme"],"created_at":"2026-04-02T21:00:52.644Z","updated_at":"2026-05-02T02:01:28.485Z","avatar_url":"https://github.com/PlayFaster.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Very Dark Black Theme for Home Assistant\n\n[![HACS Theme](https://img.shields.io/badge/HACS-Theme-orange.svg)](https://hacs.xyz/) [![HACS Custom](https://img.shields.io/badge/HACS-Custom-41BDF5?logo=homeassistant\u0026logoColor=white)](https://hacs.xyz/docs/faq/custom_repositories) [![Latest Release](https://img.shields.io/github/v/release/PlayFaster/very-dark-black-ha-theme?label=Release\u0026logo=github)](https://github.com/PlayFaster/very-dark-black-ha-theme/releases) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![Validate](https://github.com/PlayFaster/very-dark-black-ha-theme/actions/workflows/validate.yaml/badge.svg)](https://github.com/PlayFaster/very-dark-black-ha-theme/actions/workflows/validate.yaml) [![Last Commit](https://img.shields.io/github/last-commit/PlayFaster/very-dark-black-ha-theme?label=Last%20commit)](https://github.com/PlayFaster/very-dark-black-ha-theme/commits/main)\n\nA Home Assistant dark mode theme that provides black or very dark backgrounds wherever possible along with a choice of primary colours.\n\n## ✅ Features\n\nThis is a simple theme focused on providing a very dark mode look. It's designed to be clean and simple, with a choice of primary colours.\n\n- **Black Backgrounds**: Black background applied everywhere.\n- **Primary Colour Choice**: Various sub-themes with different foreground colours.\n  - Cyan\n  - Green\n  - Red\n  - Fuchsia\n  - Orange\n  - Purple\n  - Indigo\n  - Silver (Monochrome)\n  - Black (Standard): A monochrome theme (this is the base the others are built on).\n  - Black (Background Only): This is the \"sub-base\", but has to remain in the list. Black backgrounds, everything else is HA default.\n\n## 📋 Requirements\n\n- **[`card-mod`](https://github.com/thomasloven/lovelace-card-mod)** – Highly recommended. The theme will still work without this integration, but `card-mod` is used to polish fine UI details and ensure a consistent experience across all elements.\n\n## 📊 Compatibility\n\nTo ensure all features (like custom scrollbars and border removals) work correctly, verify you meet these minimum requirements:\n\n| Dependency         | Minimum Version | Reason                                   |\n| :----------------- | :-------------- | :--------------------------------------- |\n| **Home Assistant** | `2022.11.0`     | Required for `ha-card` border variables. |\n| **card-mod**       | `3.0.0`         | Required for theme-level CSS injection.  |\n\nThe theme is fully usable from HA 2022.11 onwards. Newer versions have additional refinements:\n\n- **2022.11+** — Core dark backgrounds, cards, sidebar, and text\n- **2025.1+** — Inputs, dialogs, and modern card layouts\n- **2026.4+** — Dynamic HSL colour scales\n\n## 📸 Screenshots\n\n![Black with Purple Preview](.github/images/vdbt_preview_home_purple.png)\n\n![Black with Green Preview](.github/images/vdbt_preview_theme_select_green.png)\n\n| Cyan | Fuchsia | Silver |\n| :-: | :-: | :-: |\n| ![Cyan](.github/images/vdbt_preview_sensors_cyan.png) | ![Fuchsia](.github/images/vdbt_preview_sensors_fuchsia.png) | ![Silver](.github/images/vdbt_preview_sensors_silver.png) |\n\n| Indigo | Orange | Red |\n| :-: | :-: | :-: |\n| ![Indigo](.github/images/vdbt_preview_sensors_indigo.png) | ![Orange](.github/images/vdbt_preview_sensors_orange.png) | ![Red](.github/images/vdbt_preview_sensors_red.png) |\n\n## ✨ Installation\n\n### Prerequisites: Enable themes and install card-mod\n\n1. Install `card-mod` via [HACS](https://hacs.xyz/) or per the instructions on its [GitHub page](https://github.com/thomasloven/lovelace-card-mod \"card-mod\").\n\n2. Add the following to your `configuration.yaml` file if not present (HA restart required):\n\n```yaml\nfrontend:\n  themes: !include_dir_merge_named themes\n```\n\n### Download Theme\n\n#### HACS (Recommended)\n\n1. Add this URL as a **Custom Repository** in HACS. [https://github.com/PlayFaster/very-dark-black-ha-theme](https://github.com/PlayFaster/very-dark-black-ha-theme)\n   - Open HACS in Home Assistant\n   - Click **Custom repositories** (⋮ menu)\n   - Add repository URL and Type: `Theme`\n2. Search for \"Very Dark Black Theme\" and click **Download**\n3. Run the `frontend.reload_themes` action (Restart Home Assistant if `configuration.yaml` changes were made).\n\n#### Manual Installation\n\n1. Under the Home Assistant `config` folder, create a new folder named `themes`.\n2. Copy the theme YAML file into it.\n3. Run the `frontend.reload_themes` action (Restart Home Assistant if `configuration.yaml` changes were made).\n\n### Apply Theme\n\n- Go to your [Profile General](https://my.home-assistant.io/redirect/profile) tab (bottom left of screen) and change Theme under Browser Settings.\n\n### Automate Theme Changes\n\nYou can use a Home Assistant automation to change the theme at startup, or based on any other time or condition you wish.\n\n**Important:** In the [Profile General](https://my.home-assistant.io/redirect/profile) screen, you **must** keep **\"Use default theme\"** selected under the Theme settings. If you manually select a specific theme in your profile, the automation will not be able to override it.\n\nExample automation to set the theme at startup:\n\n```yaml\nalias: Set (Default) Theme at Startup\ndescription: \u003e-\n  This automation allows you to set or change the default theme at Home Assistant Startup, provided you keep the Default Theme selected.\n\n\ntriggers:\n  - trigger: homeassistant\n    event: start\nconditions: []\nactions:\n  - action: frontend.set_theme\n    data:\n      name: Black with Orange\n      name_dark: Black with Orange\nmode: single\n```\n\n## 🛠️ Development\n\nFor technical details on the YAML standards, icon logic, and Shoelace tokens used in this theme, see the [Development Reference](docs/theme_dev_reference.md).\n\n## 📝 Maintenance Status\n\nThis is a **personal project**. Support and updates are provided on a **\"best-effort\"** basis only. While I use this theme daily and aim to keep it functional with the latest Home Assistant releases, I cannot guarantee immediate fixes for issues or compatibility with all releases.\n\n## 🤝 Acknowledgements \u0026 Thanks\n\n- Inspired by these excellent themes - thank you!\n  - [`Frosted Glass`](https://github.com/wessamlauf/homeassistant-frosted-glass-themes) themes of @wessamlauf\n  - [`Graphite`](https://github.com/TilmanGriesel/graphite) themes of @TilmanGriesel\n- Made possible by @thomasloven and the [`card-mod`](https://github.com/thomasloven/lovelace-card-mod) contributors.\n- This project was developed with the assistance of AI to ensure code quality and adherence to best practices.\n\n## 📄 License [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\nThis project is licensed under the terms of the MIT License. For more details, see the [license](LICENSE) document.\n\n---\n\n**Questions or Issues?** Visit the [GitHub repository](https://github.com/PlayFaster/very-dark-black-ha-theme).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplayfaster%2Fvery-dark-black-ha-theme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fplayfaster%2Fvery-dark-black-ha-theme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fplayfaster%2Fvery-dark-black-ha-theme/lists"}