Jeedom Status

Jeedom is a third party tool for Jeedom (Home assistant).

It shows the Jeedom global status in the status bars in the global status bar of the operating systems.

You can download the binary directly from the release page. It's available for Mac and Linux. Windows binary works but not yet integrated.

Prerequisites

To use jeedom-status, you have to get :

• Your user hash key. Go into Jeedom web interface, then click on Tools -> Preferences -> Security -> User Hash.
• The URL of your jeedom like (replace "jeedom" with the name or IP of Jeedom endpoint): http://jeedom

Icons (fonts glyphs)

Jeedom Status supports 4 types of visual aspects:

• Text (default)
• Jeedom icons
• Nerd fonts icons
• Emojicons

To support Nerd icons, you need to install Nerd fonts: https://github.com/ryanoasis/nerd-fonts

To have the Jeedom icons, you need to install those custom fonts on your operating system:

• https://github.com/jeedom/core/raw/V4-stable/core/css/icon/jeedom/fonts/jeedom.ttf
• https://github.com/jeedom/core/raw/V4-stable/core/css/icon/jeedomapp/fonts/jeedomapp.ttf
• https://github.com/jeedom/core/raw/V4-stable/core/css/icon/nature/fonts/nature.ttf

Installation and usage

Mac OS X

The simplest way to install jeedom-status is to run this command from the Terminal application (will install brew, bitbar and jeedom-status):

bash <(curl -Ls https://deimosfr.github.io/jeedom-status)

And answers questions (as described in the prerequisites section):

--> Enter Jeedom API URL (ex: http://YOUR-JEEDOM-URL):
http://192.168.0.2

--> Enter Jeedom User Hash Key
XXXXXXXXXXXX

Finally, the last steps are:

• Open the bitbar application and define a folder to store plugins.
• Move the "jeedom-status.1m.sh" plugin file from your Downloads folder to the bitbar plugins folder you've just defined.

You're done, click on the Bitbar and "refresh all". You'll see your Jeedom global status appearing.

Linux - i3 and i3blocks/i3status-rust

On Linux, you can download directly the binary. On Arch Linux, you can install via the AUR package:

yay jeedom-status

i3blocks

Here is an example with i3blocks for i3wm. Add this in your i3blocks.conf:

[jeedom]
command=~/.config/i3/i3blocks_bin/jeedom_status -k xxx -u http://jeedom --style nerd
markup=pango
interval=60

i3status-rust

Here is an example of a configuration for i3status-rust:

[[block]]
block = "custom"
command = ''' jeedom-status -k xxx -u http://jeedom -s jeedom -b i3-status-rust --ignore-battery-warning '''
format = "$text.pango-str()"
hide_when_empty = true
interval = 60

fonts and i3

If you want to use jeedom fonts, copy them into ~/.local/share/fonts/ and run:

fc-cache

In i3 config, you'll have to set the fonts in the correct order inside the bar block, like:

bar {
        status_command i3blocks -c ~/.config/i3/i3blocks.conf
        font xft:Jeedom, Jeedomapp, Nature, Hack Nerd Font, FontAwesome 10
        position top 
        tray_output "eDP1"
        colors {
            separator #ffffff
        }
}

FAQ

How to upgrade jeedom-status?

On Mac, you can use:

brew upgrade jeedom-status

For Linux, download the latest version and replace the binary.