:cpha_discord_icon_yes: Como instalar o HACS (Home Assistant Community Store)

hacs

(Hugo Encarnacao) #1

ATENÇÃO: Este tutorial foi feito usando a versão 0.95.4 do HA e 0.11.1 do HACS, e pode em futuras versões sofrer algumas alterações :slight_smile:

Hoje vamos falar sobre o novo componente HACS (Home Assistant Community Store), que vem fazer basicamente o mesmo que o custom_updater mas com uma interface integrada no HA e semi-automatizado.

O que o HACS trás de novo?

O HACS é, não mais nem menos, do que um gerenciador de Custom Components e Cartões Lovelace do Home Assistant, o que vai facilitar na instalação, actualização e descoberta de novos cartões e integrações (custom_components).

O HACS pode ser encontrado no GitHub em:

Instalação do HACS

Começar por ir ao repositório (ver link acima) e fazer o download do ficheiro Source code.

1

Depois de feito o download, vamos extrair a pasta hacs que se encontra dentro da pasta custom componentes e que vai ser colocada dentro da vossa pasta custom components .

Para quem não tem a pasta custom_components, deve criar uma pasta chamada custom_components dentro da pasta config. Por fim devem reiniciar o HA.

ATENÇÂO: Quem já tinha o custom_updater vai ter de apagar totalmente a pasta custom updater e os custom cards que já tinham…`

Não se esqueçam que após fazer o setup do HACS tem de reinstalar TODOS os cartões novamente.

Configuração do HACS

O HACS recorre ao uso da API do GitHub para retirar informação do mesmo, logo tem de fazer a sua configuração.

Vão ter de ir ao GitHub Developer Settings em https://github.com/settings/tokens e gerar um novo token

Se for pedido para fazer o login, vão ter de o fazer. Seguidamente criam um nome para o token.

1

Mais abaixo vão carregar gerar em Generate Token.

1

Copiam o token.

1

De seguida abrem o configuration.yaml e inserem a seguinte entrada com o vosso token.

hacs:
  token: !secret hacs_github_access_token

No meu caso, o token está escondido no secrets.yaml :slight_smile: mas caso não usem !secret simplemente ponham lá o vosso token.

hacs:
  token: 696969696969issoqueriastuwuhjeiwjijsd

Reiniciem o HA e neste momento tudo deve estar em ordem. Após reiniciar, já deve aparecer uma nova entrada no menu do lado esquerdo do HA chamada Community.

1

E é isto, neste momento o HACS já esta todo configurado. Só precisam e ir ao link STORE para escolher e instalar os cards e components que necessitem.

1

Não se esqueçam de pôr as entradas do resources nos devidos sítios. Leiam as instruções que aparecem ao instalar pois o HACS tem boas instruções de como instalar os cartões e os componentes

Caso algum card só tenha o - url: não se esqueçam que é sempre necessário a entrada type:. As entradas podem ser de dois tipos: ou type: js ou type: module. Caso não o tenham, tem de ir ao repositório do cartão para ver qual será o seu tipo.

Espero ter ajudado,
Happy coding