Skip to content

th3jesta/ha-lcars

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Home Assistant LCARS

Star Trek LCARS theme for Home Assistant

hacs_badge

Discord Banner 2

Color codes and font choice from https://www.thelcars.com --thanks Jim Robertus!

💥BREAKING CHANGES IN 3.0💥

Version 3.0 changes header, middle, footer, and oriented-buttons such as button-lozenge and button-capped to header-left, middle-left, footer-left, button-lozenge-left, etc. I implemented this change because Home Assistant has started using classes called .header, .footer, etc. and it was causing conflicts in styles and breaking some parts of the UI. Given that these class names were created in the first iteration of HA-LCARS, before there were other-oriented classes like -right and -contained, it seemed responsible to update the convention to be consistent with the rest of the theme styles and ensure compatibility with future HA updates. I know this will take some time to update your dashboards, and I apologize for the inconvenience, but it is necessary at this point. If you have insanely complicated dashboards, I recommend copying your whole-dashboard yaml into a tool like VSCode and using its advanced find/replace capabilities to update the dashboards. Full list of changed classes:

  • header to header-left
  • middle to middle-left
  • footer to footer-left
  • button-lozenge to button-lozenge-left
  • button-bullet to button-bullet-left
  • button-capped to button-capped-left

Examples

Dashboard

image

Edit modes

image

Mobile view

Included themes

LCARS Themes Classic, Lower Decks, Romulus, Cardassia, Kronos, Nemesis (and more!).

Preamble

I am most definitely not a real web developer, and fumbled my way into the initial release with the help of Stack Exchange and various blogs on CSS techniques. My main goal was and still is to keep this theme 100% CSS/JS with no extra assets required besides the font. I'm positive there are better ways to implement anything and everything I've done thus far, so PRs are welcome. I will continue to improve things as I learn and add more comments to my CSS so that you can know what things do and maybe tell me how it can be better if you know. I have tested this theme with most of the out-of-the-box cards that ship with Home Assistant, and some available in HACS like the Mail and Packages card. However, I'm sure there are some that could still be terribly broken. Simply create an issue and I will address it.

Installation instructions

Prerequisites

I. Enable themes and install card-mod

  1. Install card-mod per the instructions on its GitHub page.

  2. Make sure in your configuration.yaml file you have the following:

frontend:
  javascript_version: latest
  themes: !include_dir_merge_named themes
  extra_module_url:
    - /local/community/lovelace-card-mod/card-mod.js #or wherever you ended up putting card-mod.js
  1. Under the Home Assistant Config folder, create a new folder named themes.
  2. Restart Home assistant to apply the changes.

II. Add the font and JavaScript file

This theme requires you to add both the Antonio font and lcars.js file as resources to your lovelace configuration.

Navigate to Settings → Dashboards → 3-dot menu → Resources and add the following new Resources:

  1. https://fonts.googleapis.com/css2?family=Antonio:wght@400;700&display=swap and select 'stylesheet'
  2. https://cdn.jsdelivr.net/gh/th3jesta/ha-lcars@js-main/lcars.js and select javascript
-OR-

If you don't trust someone's random JavaScript hosted on a CDN (I get it), you can download the lcars.js file directly from GitHub, audit it yourself, and place it in your <home-assistant-directory>/www/community/; this will need to be done with every HA-LCARS update. Do not add /local/community/lcars.js to extra_module_url; it will not work there.

IF YOU USE CLOUDFLARE IN FRONT OF YOUR SITE: Purge your site cache in CloudFlare (Purge Cache under Quick Actions) anytime you update the local file or if you are using the JSDelivr link and a new version of HA-LCARS is released. This needs to happen whether you are using the JSDelivr link or putting it in your www folder. Unless you tell it not to, CloudFlare caches anything in your site that it can.

III. Set up the clock

In order for the clock to work, you need to set up the Time & Date integration by adding the following to your configuration.yaml:

sensor:
  - platform: time_date
    display_options:
      - 'time'
      - 'date'
      - 'date_time'
      - 'date_time_utc'
      - 'date_time_iso'
      - 'time_date'
      - 'time_utc'

More info: https://www.home-assistant.io/integrations/time_date/

IV. Create the entities

This theme has two controls for sound and textures that require creating simple toggle entities. Create them by going to Settings > Devices & Services > Helpers and create two of type Toggle named as below:

  • LCARS Sound (entity id should be input_boolean.lcars_sound)
  • LCARS Texture (entity id should be input_boolean.lcars_texture)
  • LCARS Vertical (entity id should be input_number.lcars_vertical)
    • Min value: 26
    • Max value: 60
  • LCARS Horizontal (entity id should be input_number.lcars_horizontal)
    • Min value: 6
    • Max value: 60
image

These entities can be controlled directly from viewing the entity, or you can even add buttons to your dashboard to control them, just like any other entity.

Install the theme

Install via HACS by searching "LCARS" or download the latest release and extract and drop the lcars folder into your themes folder.

Enable theme

Option 1: Via profile

  1. Open your Home Assistant Profile
  2. Under, Themes, select one of the new LCARS themes
  3. Call the frontend.reload_themes service.

Option 2: Setting the default backend-selected theme

In order to have this theme set automatically as the backend selected default, add the following automation to your Home Assistant:

- alias: Set Default Theme
  description: ''
  trigger:
  - event: start
    platform: homeassistant
  condition: []
  action:
  - data:
      name: LCARS Default # or whichever other theme is available, like LCARS Lower Decks
    service: frontend.set_theme

Usage instructions

Classes

The theme includes some classes that can be added to cards like this to give them special styling:

card_mod:
  class: header

The class names are only indications of what types of cards they were intended for, but the classes can be applied to any card you like. I cannot guarantee how well they will work outside of their intended uses, however.

The classes are as follows:

  1. header-left header-right header-contained header-open - top blue bar (in Default theme) meant for Markdown cards with one H1 line that will start a section
YAML Result
type: markdown
card_mod:
  class: header-left
content: '# header-left'

type: markdown
card_mod:
  class: header-right
content: '# header-right'

type: markdown
card_mod:
  class: header-contained
content: '# header-contained'

type: markdown
card_mod:
  class: header-open
content: '# header-open'
image
  1. middle-left middle-right middle-contained middle-blank - side red bar (in Default theme) meant for non-button sections below header and above footer
YAML Result
type: markdown
card_mod:
  class: middle-left
content: '# middle-left'

type: markdown
card_mod:
  class: middle-right
content: '# middle-right'

type: markdown
card_mod:
  class: middle-contained
content: '# middle-contained'
    
type: markdown
card_mod:
  class: middle-open
content: '# middle-blank'
image
  1. footer-left footer-right footer-contained footer-open - bottom gray bar (in Default theme) meant for the last card in a section
YAML Result
type: markdown
card_mod:
  class: footer-left
content: '# footer-left'

type: markdown
card_mod:
  class: footer-right
content: '# footer-right'

type: markdown
card_mod:
  class: footer-contained
content: '# footer-contained'

type: markdown
card_mod:
  class: footer-open
content: '# footer-open'
image
  1. button-small - squared off buttons intended to go in middle sections and horizontal-stacks and grids
YAML Result
type: light
entity: light.jesse_s_desk
name: Desk Lamp
card_mod:
  class: button-small
image
  1. button-large - rounded button meant to be standalone outside of header/middle/footer sections
YAML Result
show_name: true
show_icon: true
type: button
tap_action:
  action: call-service
  service: frontend.reload_themes
  data: {}
  target: {}
show_state: true
card_mod:
  class: button-large
image
  1. button-lozenge-left button-lozenge-right - pill-shaped button; only works on standard button cards; also works on button cards in a horizontal-stacks and grids up to two columns wide; more columns get glitchy and is not advised
YAML Result
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: switch.speakers
icon: mdi:speaker-multiple
card_mod:
  class: button-lozenge-left
  
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: switch.lightsaber
card_mod:
  class: button-lozenge-right
image
  1. button-bullet-left button-bullet-right - similar to the lozenge, but with a squared-off side; same column restrictions apply
YAML Result
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: light.bedroom_tree
card_mod:
  class: button-bullet-left
  
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: switch.counter_lights
card_mod:
  class: button-bullet-right
image
  1. button-capped-left button-capped-right - similar to the bullet, but capped on the round side; same column restrictions apply
YAML Result
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: light.bathroom
card_mod:
  class: button-capped-left
  
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: switch.built_in
card_mod:
  class: button-capped-right
image
  1. button-barrel-left button-barrel-right - similar to the bullet, but no rounding at all; same column restrictions apply
YAML Result
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: light.bathroom
card_mod:
  class: button-barrel-left
  
show_name: true
show_icon: true
type: button
tap_action:
  action: toggle
entity: switch.built_in
card_mod:
  class: button-barrel-right
image
  1. bar-left bar-right bar-large-left bar-large-right - standalone header-type bar; only intended for and tested with Markdown and HTML cards
YAML Result
type: markdown
content: '# bar-left'
card_mod:
  class: bar-left
  
type: markdown
content: '# bar-large-left'
card_mod:
  class: bar-large-left
  
type: markdown
content: '# bar-right'
card_mod:
  class: bar-right
  
type: markdown
content: '# bar-large-right'
card_mod:
  class: bar-large-right
image

Make your own color themes

Custom themes can be created down at the bottom of lcars.yaml. Or, search for "===THEMES", which will take you right there. To create your own theme, copy the LCARS Default section to the bottom of the file and change the lcars-ui-* and lcars-card-* variables to your liking, using the color references at the top of the file, The LCARS website, or define your own.

Tips and tricks

If you have anything to add here, create a PR with your tip and I will review it to add to this list.

  • Make use of Vertical Stack cards. Whether in this theme or any other theme, they are invaluable for keeping dashboards organized. In LCARS, a Vertical Stack card should contain a Markdown card first with the title of the group and the header class applied, then any number of middle class cards and button class single buttons or in horizontal stacks or grids, and then finally a footer class applied to the last card in the vertical stack. You can see this formation in all of the screenshots at the top of this page. Here's an example Vertical Stack card and all of its contents:
YAML Result
type: vertical-stack
cards:
  - type: markdown
    card_mod:
      class: header
    content: '# Climate'
  - type: weather-forecast
    entity: weather.home
    card_mod:
      class: middle
  - type: thermostat
    entity: climate.dining_room
    card_mod:
      class: footer
image
  • You can create a blank header or footer by creating a Markdown card and putting ## &nbsp; in the Content field, and change the size by modifying the number of #. It looks like this: image

  • If you are only applying the theme to a dashboard or a card, the font won't render on the cards. You can brute-force loading the font on a per-card basis by adding the following style to every card:

YAML Result
type: markdown
content: '# Card-level theming'
theme: LCARS Default
card_mod:
  class: header
  style: |
    ha-card > * {
      font-family: Antonio
    }
image
  • If you want to host the font yourself, such as running a Home Assistant instance in a car or on an air-gapped network, you can learn how to download the font and install it from issue #69.

  • You can switch the alignment of text in a card, such as the markdown card for header-right, by adding custom CSS per card like so:

YAML Result
card_mod:
  class: header-right
  style: |
    ha-card {
      text-align: right;
    }
image
  • You can set a button's background color to the color of the light by adding custom CSS per card like so:
YAML Result
card_mod:
  class: button-capped-right
  style: |
    ha-card {
      {% if is_state('light.terasa', 'on') %}
        {% set rgb_color = state_attr('light.terasa', 'rgb_color') %}
        background-color: rgba({{ rgb_color[0] }}, {{ rgb_color[1] }}, {{ rgb_color[2] }}, 1);
        color: black;  /* or any other logic for text color */
      {% else %}
        background-color: #dd4444;
        color: black;
      {% endif %}
    }
image

Known issues

  • 💥MARKDOWN CARDS ARE BROKEN IN CARD-MOD💥 HA-LCARS replies on a mod called card-mod, and since Home Assistant 2024.8, card-mod no longer applies classes defined in the theme to Markdown cards. HA-LCARS dashboards have typically made heavy use of Markdown cards for headers and section labels. Due to card-mod no longer being able to apply CSS classes to Markdown cards on the initial load of a page without calling a reload of the theme, I have added support in 2.3.1 for the Lovelace HTML card to the various header, middle, and footer classes, with the various bar classes to follow soon in the next update. Setup an HTML card like this:

    1. Install Lovelace HTML card
    2. Create a new "manual" card
    3. Input the following code for the card, and adjust the content and class per your needs.
      type: custom:html-card
      title: ''
      content: |
        <h1>TEST HTML CARD</h1>
      card_mod:
        class: header
      
  • Font and sidebar and header CSS styles only load when a dashboard has been loaded first. If you navigate directly to a non-dashboard page without loading a dashboard first, things will look pretty awful, though still functional. Simply load a dashboard and hit the back button. This is a quirk of the card-mod addon on which this theme relies, so it's outside my ability to fix.

  • card-mod classes do not work with Vertical Stack and Horizontal Stacks cards (though they do work with the cards they contain). This is a quirk of the card-mod addon on which this theme relies, so it's outside my ability to fix. There is, however, a hacky workaround I have identified though have opted to not include at this time. Please submit a feature request if you would like to see this included.

  • Collapsing and expanding the sidebar or zooming the interface will jack with the noise and gradient overlays. A simple refresh will set everything right again. I hope to find a way to make the pseudo elements that contain the textures to dynamically adjust with the DOM. PRs are welcome. Bug here.

  • Menu pages like Development Tools and Profile are functional, but not great. Unfortunately, there's not much I can do to address this as card-mod does not provide a method to change these pages. Issues raised for anything comepletely broken and unsuable that I may have missed are welcome, as are PRs to make to make things better.

  • Sometimes when a dashboard loads, not all CSS styles will load and all or most cards will end up looking like the button-large cards. This is more prevalent on large dashboards. Try reloading the page, and if that doesn't work, load a smaller dashboard and then go back to the offending dashboard.

Acknowledgements

  • Thanks to @JHuckins for color theming support and testing!
  • Thanks to @csanner for the new classes and additional fixes and tweaks!
  • Thanks to @Anthrazz for the bar classes!
  • Thanks to @mtezzo for the entity toggle for textures/gradients, and the Modern theme (my new favorite)!
  • Thanks to @CmdreIsaacHull for various fixes, improvements, themes, and new classes!
  • Thanks to @askpatrickw for figuring out how to self-host the font!
  • Thanks to @z3r0l1nk for light color-matching button trick!
  • Thanks to @smugleafdev for the right-justified text tip!
  • Thanks to @Routhinator (via Discord) for the right-footer fix!

Links

Discord: https://discord.gg/gGxud6Y6WJ

LCARS Resources: https://www.thelcars.com