Sentinel CCTV

Grave todas as câmaras, 24 horas por dia.
Leve o suficiente para um mini-PC.

O Sentinel é um gravador de vídeo gratuito e open source para câmaras IP. Grava todas as câmaras sem parar, marca o movimento numa linha temporal e liga-se ao Home Assistant. Corre numa imagem Docker de 350 MB e não precisa de acelerador de IA.

Instalar GitHub

Versão 0.1.0, em fase inicial. Licença MIT.

A página da linha temporal a reproduzir uma câmara da entrada da garagem, com a barra de gravação de seis horas e as marcas de movimento por baixo.
As capturas mostram câmaras de demonstração, não uma casa real. A interface do Sentinel está em inglês.
A página de eventos: eventos de movimento de várias câmaras, cada um com uma imagem, agrupados por dia.

Encontrar o que aconteceu

O movimento é detetado no vídeo de baixa resolução de cada câmara e guardado como evento, com uma imagem. A página de eventos agrupa-os por dia, por isso é fácil encontrar uma entrega à porta ou um carro à entrada.

Na linha temporal, basta tocar num evento para ver a gravação a partir desse momento.

A página de armazenamento: uso do disco, ritmo de gravação, clips guardados e espaço ocupado por cada câmara.

Saber quanto tempo o disco aguenta

O Sentinel mostra quanto espaço ocupa cada câmara e quantos dias de gravação cabem no disco. Escolhe quanto tempo guardar as gravações e quanto espaço deixar livre.

Os clips que guardar ficam até os apagar, mesmo quando as gravações antigas são limpas automaticamente.

A página de câmaras: lista de câmaras com imagem, detalhes do vídeo e um interruptor de gravação para cada uma.

Todas as câmaras numa página

As câmaras adicionam-se procurando na rede por ONVIF ou escrevendo o endereço RTSP. Cada câmara tem o seu interruptor de gravação, e os controlos para rodar e inclinar aparecem nas câmaras que os suportam.

O Sentinel abre uma só ligação a cada câmara e partilha-a entre a gravação, a deteção de movimento e o vídeo em direto. O vídeo é guardado tal como a câmara o envia, sem ser recodificado.

Funciona com o Home Assistant

A integração acrescenta cada câmara ao Home Assistant com uma imagem, um sensor de movimento e um interruptor de gravação, para usar em automações.

Fala com um servidor Sentinel e não grava nada sozinha, por isso instale primeiro o servidor.

  1. No Sentinel, crie um token em Settings → API tokens.
  2. No Home Assistant, abra HACS → ⋮ → Custom repositories e adicione este repositório como Integration:
https://github.com/jencarnacao19/sentinel-cctv
  1. Instale o Sentinel CCTV, reinicie o Home Assistant, adicione-o em Definições → Dispositivos e serviços e cole o token.

Guia do Home Assistant (em inglês)

Instalar

É preciso um computador Linux com Docker, na mesma rede que as câmaras. Uma VM ou um LXC no Proxmox serve. Há imagens para amd64 e arm64.

mkdir sentinel && cd sentinel
curl -fsSLO https://raw.githubusercontent.com/jencarnacao19/sentinel-cctv/main/compose.yml
mkdir recordings && sudo chown 1000:1000 recordings
docker compose up -d

Depois, abra http://<ip-do-servidor>:8090 no browser e crie a conta de administrador. O comando hostname -I no servidor mostra o endereço.

A compilação a partir do código e as notas para Proxmox estão no README (em inglês).

Comparado com o Frigate

O Frigate também é gratuito e open source, e é a melhor escolha para quem quer deteção de objetos com IA. Distingue uma pessoa de um gato e recomenda um acelerador, como um Coral ou um Hailo, para o fazer.

O Sentinel só deteta movimento. Em troca, não precisa de acelerador, e a imagem Docker tem cerca de 350 MB, contra cerca de 2,2 GB do Frigate.

Valores de outubro de 2026: Sentinel 0.1.0 e Frigate 0.18.2, imagens amd64 comprimidas. O Sentinel não tem ligação ao Frigate.

O que ainda não faz

  • A gravação é contínua ou está desligada. Gravar só com movimento, ou por horário, está planeado.
  • No Home Assistant, a câmara mostra imagens fixas. O vídeo em direto passa na página do próprio Sentinel.
  • Não há deteção de objetos, por isso sombras, chuva e faróis também contam como movimento. As zonas a ignorar ajudam nas áreas piores.
  • A versão 0.1.0 é software jovem. Teste-o com as suas câmaras antes de confiar nele.