🎙 Poslední aktualizace článku 10.9.2022. Pokud najdete nějaké rozdíly v aktuálním stavu, dejte vědět v komentářích, díky.
Hass.io repozitář addonů obsahuje převážně aplikace běžící samostatně – např. MQTT, Grafana, Node-Red atp.
Naproti tomu HACS repozitář obsahuje addony přímo pro Home Assistant vytvořené komunitou okolo Home Assistanta a které ještě z různých důvodu nebyly přídány přímo do instalace Home Assistanta. Jedná se jednak o další obykle speciálnější integrace, ale také o spustu nových prvků pro UI rozhraní Lovelace.
V tomto článku se podíváme jak HACS nainstalovat a nakonfigurovat.
Instalace
Ukážeme si dva způsoby instalace. Jeden více automatický a druhý více manuální. Pokud neuspějete s prvním pak můžete zkusit druhý, který je více historický.
1. Pomocí instalačního skriptu
V závilosti na typu instalace HomeAssistanta bude postup drobně odlišný, ale kroky budou vždy stejné:
- Připojit se do terminálu HomeAssistanta – a to buď pomocí SSH a nebo v případě Dockeru pomocí příkazu
docker exec -it homeassistant bash - Stažení a spuštění instalačního skriptu – v příkazové řádce napíšeme
wget -O - https://get.hacs.xyz | bash -
2. Manuální stažením z webu
Nejprve si z GitHub repozitáře si stáhneme poslední vydanou verzi ve formě zip archívu – hacs.zip.
Obsah archívu pak zkopírujeme do složky <config_dir>/custom_components/hacs. Adresář custom_components ještě nemusí existovat a tak ho založíme.
💡 <config_dir> obyvkle (v případě Hass.io) odpovídá adresáři config, kde najdeme hlavní konfigurační soubor Home Assistanta configuration.yaml.
Archív by měl vypadat nějak takto:
Jakmile máme HACS v Homeassistantovi nakopírovaný (buď skriptem nebo manuálně) je potřeba HomeAssistant restartovat a vrheneme se na další krok.
Přidání Integrace (konfigurace)
V Home Assistantovi klikneme na Nastavení / Integrace a oranžové tlačítko + vpravo dole. V seznamu si pak najdeme integraci s názvem HACS na kterou klikneme:
Po kliknutí na položku HACS se nám objeví dialog s několika konfirmaci – myslím, že je tam zejména po tom kdy došlo k security problému s HACS.
Je potřeba tedy vše odsouhlasit pomocí zatržení položek a dáme Odeslat.
Není budeme muset jít na stránku Githubu prostřednictvím nabízeného odkazu, kam zadáme vygenerovaný kód na autorizaci.
Zřejmě si budete muset vytvořit Github účet, což by mělo být ale na pár kliknutí.
A konečně HACS authorizujeme:
Vrátíme se na stránku s HomeAssistentem kde už bychom měli vidět potvrzení úspěšného přidání a dáme tak pouze Dokončit.
.. a nová položka se objeví v Integracích (menu Nastavení, Integrace)
V levém menu Home Assistanta už bychom nyní měli vidět novou položku HACS (někdy Community, nejsem si úplně jistý proč to může být jiné).
Po prvotním startu bude poměrně dlouho trvat než se všechny jednotlivé položky natáhnou.
Instalace balíčku
V části Integrations a Plugins najdeme jednotlivé dostupné balíčky. V seznamu si najdeme balíček, který si chceme nainstalovat a po kliknutí se nám zobrazí stručné informace s možností instalace a návštěvy originálního Git repozitáře. Pro instalaci klikneme na Install a chvíli počkáme.
Aktualizace
Aktualizace nainstalovaných balíčků i samotného jádra HACS probíhají velice podobně jako v případě Hass.io, tj. na základní obrazovce budeme informování v případě existující aktualizace, kterou můžeme provést přímo přes webové rozhraní.
Příklad aktualizace samotného jádra HACS, kdy aktualizaci spustíme pomocí tlačítka UPDATE. V některých případech bude vyžadován po aktualizaci restart samotného Home Asistanta.
Tím jsme vyčerpali všechny základní funkce HACS a v některém dalším článku vám sepíšu seznam addonů, které mě zaujaly a které používám. Pokud už HACS používáte budu rád když se podělíte o své oblíbené kousky již nyní.
Kompletní série o HomeAsistantovi obsahuje následující články:
- 1. část – Instalace HomeAsisstent
- 2. část –
Integrace Sonoff s firmware Sonoff-Tasmota - 3. část –
Integrace Homekit - 4. část –
Integrace Sonoff s firmware Sonoff-Tasmota – 2 část - 5. část –
Integrace s Wemos D1 asenzory teploty - 6. část –
Integrace Sonoff s firmware ESPHome - 7. část –
Integrace Sonoff POW s firmware ESPHome - 8. část –
Integrace LED Magic Home s firmware ESPHome - 9. část –
Integrace Xiaomi Mijia a Aqara - 10. část – Integrace vlastní Zigbee gateway
- 11. část – Vzdálený přístup do Hass.io z Internetu
- 12. část – zobrazení senzorových data pomocí InfluxDB a Grafany
- 13. část – Hass.io Add-ony, které používám
- 14. část – Integrace Xiaomi Mi Flora
- 15. část – Integrace Withings (Nokia)
- 16. část – náhrada SQLite databází MySQL
- 17. část – HACS Add-ony – instalace a konfigurace
- 18. část – Integrace Sonoff s firmware eWeLink
- 19. část – nová integrace Sonoff pro HA
- 20. část – měření spotřeby
- 21. část – automatické zálohy a obnovení ze zálohy
- 22. část – napojení hlasového asistenta Amazon Alexa
- 23. část – automatické zálohy na síťový sdílení disk (Samba)
- 24. část – Bluetooth zařízení a ESPHome proxy
- 25. část – nefunkční aktualizace HomeAssistanta
- 26. část – integrace SwitchBot produktů
- 27. část – integrace fotovoltaiky Growatt
LG SmartThinQ Applicances – ovládání klimatizace LG
Z2M – IKEA controllers – ovládání ikea led žárovky ikea tlačítkem
Rozchodil jste v HA LG SmartThinQ Applicances – ovládání klimatizace LG?
Ano, Wideq s parametry -c CZ -l cs-CZ (pro ceskou lokalizaci) odkazal na web stranku LG s prihlasenim. Po prihlaseni presmerovano na jinou adresu, v niz uz byl napsan potrebny token.
Za mě něco co umí dělat pravidelné zálohy (SnapHost) a umí odeslat na FTP nebo Samba atd.. A něco na „pěkné“ grafy 🙂 Jinak pokud by byl zájem mám doma rozběháno Sonoff RF Bridge pro ovládání bezdrátových vypínačů a LED pásku.
Na zálohy používám Hass.io add-on Hass.io Google Drive Backup https://github.com/sabeechen/hassio-google-drive-backup
Ten však není od HACS, ale je to hass.io addon.
Děkuji za tip. Už to běhá 🙂
Tak na toto som sa chystal uz dlhu dobu, ale ako som prebehol tento navod, tak som to hned aj rovno spravil a parada! Dakujem 🙂
Supr, to rád slyším 🙂 Je to jeden z důvodu proč tohle píšu. Abych jednak to nehledal znovu, až to bude zase potřebovat a taky, abych tou investigaci sdílel i s ostatními 🙂
Z HACS addonů používám integraci Garbage Collection pro „sledování“ vývozu popelnice, separovaného odpadu a taky mám nastavené termíny přistavení kontejneru na velkoobjemový odpad.
A dále plugin Lovelace Swipe Navigation pro přesun mezi kartami swipováním na mobilních zařízeních.
Já node-red https://github.com/zachowj/hass-node-red pro jednodušší propojení nodered <=> HA
Tohle je zajímavé. Co tě vedlo k instalaci tohoto addonu namísto toho co je v Hass.io – addon-node-red, který to vypadá má stejnou integraci v sobě taktéž?
Node-red jsem měl historicky dřív a tudíž jsem ho nechtěl/nepotřeboval instalovat přes Hass.io
Yep, pak je to jasné. Díky za upřesnění.
Jirko, doplň prosím ještě to, že po restartu HA je potřeba ještě vyprázdnit CACHE prohížeče, jinak se tam HACS nemusí objevit.
Clear your browser cache
Before HACS can show up in the list you need to clear your browser cache.
Zrovna jsem to instaloval a nemohl jsem přijít na to, proč tam HACS nemám a nemám a nemám. 🙂
Kdybych četl tyto komentáře a ne pouze postup z článku, ušetřil bych si 2 hodiny nervů! Prosím autora, aby pro další čtenáře doplnil nutnost „tvrdého“ reloadu prohlížeče (např.přes CTRL+F5) po nakopírování souborů na disk a restartu HA, protože jinak se HACS opravdu neobjevuje ve vyhledávacím seznamu při přidání nové integrace! (jedu na Opeře). Pomohl mi až originální postup autorů z hacs.xyz, kde na to výslovně upozorňují. Komentář Martina jsem našel až teď, zjevně nejsme sami, kdo má stejný problém.
Tak přiznám se, že původní komentář mi nějak utekl a tohoto problému jsem si nevšiml. Doplním a jsem rád, že se to pokrylo v komentářích.
Ja zatim pouzivam SamsungTV Tizen Component pro ovladani TV od Samsungu a DewPoint Sensor Calculator pro senzor vypocitavajici rosny bod.
Dobrý den,
zkouším pŕidat HACS do nove instalace HA, ale HA mi vůbec moźnost přidání integrace HACS nenabízí. Pouze v logu je info, že tato komponenta může mít problém se stabilitou a měla by být vypnuta.
Ahoj,
pokouším se jako úplný nováček nainstaloval jsem HA dle zdejších návodů a teďse snažím rozhodit jednu zásuvku Sonoff co tady mám abych si to ošahal a vyzkoušel a narazil jsem na :
„Obsah archívu pak zkopírujeme do složky /custom_components/hacs. Adresář custom_components ještě nemusí existovat a tak ho založíme.“
Jak se k té složce dostanu? musím dát kartu do čtečky, nebo to jde i jinak. Na kartě mám dva oddíly, jeden nečitelný a jeden maly. 🙁
Mrkni na díl 2 – odstavec Samba Share. Pak se na HA dostaneš přes síť. Pokud používáš nějaký antivir s firewallem, tak Ti to může blokovat.
Ahoj,
pokouším se o instalaci HACS, ale v kroku vložení tokenu z GitHub, se mi nezobrazí formulářové okno. Je tam místo toho tohle:
Open https://github.com/login/device and paste this key to authorize HACS: \n\n53D6-F5F6\n\n When you have done that click ‚submit‘
Dělá to prohlížeč Chrome i Firefox, dokonce i HA aplikace v mobilu. Setkali jste se někdo s touto chybou? Používám verzi HACS 1.8.0
Přehlédl jsem někde něco? Nepodařilo se mi k tomu nic vygooglit. Díky moc
Jejda, to jsem se předvedl…
Asi jsem byl zmaten ze čtení návodu, čekal jsem něco jiného a nečetl přesně,co mi HACS píše. Možná za to můžou i ty \n\n, které jsem vyhodnotil jako nenačtené formulářové pole…
Dnes jsem si to přečetl znovu a vše je jasné. Otevřel jsem odkaz, zadal autorizační kód (ten mezi \n\n) a „Congratulations, you’re all set! Your device is now connected.“
Návod není špatný, bohužel je rozdíl ve verzích a také HW na kterým HA jede. Prvně jsem zkusil synology NAS, tam jsem HACS rozchodil, bohužel ve VMBOX ani na RasbberyPi HACS jenom přidává doplněk a nic.. pokaždé se HA chová jinak, ale jinak díky za vaše objasnění na vašem webu.
Jak se Vám podařilo rozchodit HACS na Synology? Mně se pořád nedaří. Naopak na mini PC s VMBOX jede bez problémů. Díky za info
bohuzel v posledni verzi se zaseknu v sekci konfigurace, jiz nenabizi integraci hacs
Máte na mysli, že pokud jdete do nastavení a záložky Integrace a dáte přidat Integraci tak tam vůbec nevidíte HACS položku? Já jsem kouknul raději a pořád ji tam mám. A nebo jste na jiném místě/kroku? Pro jistotu jsem si HACS odebral a tuto celou část v článku zaktualizoval, jelikož se poměrně hodně už změnila.
Prosím o radu, jak pri nastaveni integrace HACS zadat personal github token. Nenabízí se to nikde…
Pri vytvareni nove integrace se objevi 8 místný kod, ktery mam pote potvrdit v OAUTH formuláři GitHubu.
Pokud ho potvrdim, aplikace se autorizuje a zda se být vse v pořádku.
Ale brzy s timto tokenem prekrocim limit na githubu a pote se mi u modulu v Home Assistantovi ukáže error:
„..HACS je deaktivován (Ratelimited)
GitHub API calls are ratelimited, this will clear in less than 1 hour…“
Pry je to snad problém tohoto tokenu a mel bych ho nahradit tim osobním, ktery jsme si vygeneroval sám v Githubu (developer sekce). Ale kam ho uložit, kde ho zadat ???
Nejaky konfig file na Raspberry?
diky..M
Hmm, je pravda, že tahle část se poměrně hodně změnila od té doby co jsem článek psal a tak jsem pro jistotu článek pro tuhle část aktualizoval. Nicméně mám za to, že můj HACS už ten personal token nepoužívá, resp. když se podívám do tokenů na Githubu tak je použitý naposledy před půl rokem. Máte v tom formuláři po zadání kódu víceméně stejnou verzi jako já mám v článku teď v sekci „A konečně HACS authorizujeme:“? Tedy, že jste tam přihlášený? Nezkoušel jsem jestli to přihlášení je povinné a napadá mě že pokud ne tak by možná ten limit bez přihlášení mohl být jiný.