Alle functies van CamRelay gebruiken in Frigate NVR

CamRelay brengt een Android-telefoon in Frigate via één enkele RTSP-URL. go2rtc, dat in Frigate is ingebouwd, neemt die stream over en deelt hem met de recorder, het live beeld en het kanaal voor tweerichtingsgesprekken.

CamRelay is een app van Banana Studio die een telefoon verandert in een IP-camera in je lokale netwerk. De app streamt H.264- of H.265-video met Opus-, G.711- of AAC-audio, heeft een webinterface, ondersteunt ONVIF en ontvangt via het RTSP-backchannel geluid terug van kijkers.

Gegevensstroom: telefoon met CamRelay → go2rtc (in Frigate) → opnemen, live beeld met geluid, tweerichtingsgesprek.

De configuratie hieronder gaat uit van Frigate 0.16. Sommige sleutels kunnen in latere versies veranderen, dus controleer de officiële Frigate-documentatie.

Functies van CamRelay in Frigate

De eerste vier functies bereiken Frigate via go2rtc. De rest stel je in de app in; die houden de stream 24/7 in de lucht.

Voordat je begint

Je hebt nodig:

• Een geïnstalleerde en draaiende Frigate-server (zie de installatiehandleiding van Frigate) in hetzelfde lokale netwerk als de telefoon.
• Een Android-telefoon met CamRelay geïnstalleerd, permanent aan de lader en met een vast IP-adres in je router.
• Op Android 17: geef CamRelay toegang tot het lokale netwerk (Android noemt dit Apparaten in de buurt). Zonder deze toestemming kan Frigate geen verbinding maken met de telefoon. Zie het artikel over CamRelay 1.0.5.

De Frigate-container moet deze poorten openzetten om alle functies van CamRelay te kunnen gebruiken:

Stap 1: CamRelay instellen

CamRelay volgt de taal van de telefoon; de namen van de instellingen hieronder zijn de Nederlandse. Let op: het openen van Instellingen stopt de stream. Zodra CamRelay draait, kun je instellingen via de webinterface wijzigen zonder de stream te stoppen.

1.1 RTSP-poort

Het onderdeel Serverpoorten toont de RTSP-streamingspoort (standaard 1935) en de Webinterface-poort (standaard 8888). De standaardwaarden zijn prima.

1.2 Video

1. Kies onder Cameraselectie de camera die je wilt gebruiken (de achtercamera geeft meestal een beter beeld).
2. Open de instellingen van die camera en kies Resolutie, Framesnelheid (FPS) en Video-bitrate. Welke resoluties en framesnelheden beschikbaar zijn, hangt af van de camera van de telefoon.
3. Kies onder Algemene video-instellingen → Video-codec de optie H.264, zodat browsers het live beeld kunnen afspelen.
4. Laat het Keyframe-interval (GOP) op 1s staan (de standaard), zodat het live beeld snel opent.

Voor bewaking is 1080p bij 15 FPS genoeg, en dat ontziet ook de Frigate-server. H.265 bespaart bandbreedte, maar Frigate moet het dan voor de browser transcoderen (zie stap 2.2).

1.3 Audio

Zet onder Audio-instellingen de optie Audio inschakelen aan. De audiocodec van de stream kies je onder Tweerichtingsgesprek → Audiocodec voor tweerichtingsgesprek. Deze ene instelling geldt zowel voor het uitgaande geluid als voor het tweerichtingsgesprek:

• G.711 ULAW: aanbevolen voor Frigate, speelt direct af in zowel MSE als WebRTC (zie stap 2.2).
• OPUS: de standaard vanaf Android 10, helderder geluid, maar speelt alleen af via WebRTC.
• G.711 ALAW: alleen als het afspeelapparaat A-law vereist.
• AAC: alleen voor afspelen; tweerichtingsgesprek vereist transcoderen.

Laat de Audiomodus voor tweerichtingsgesprek op Spraakcommunicatie staan: die heeft echo-onderdrukking, zodat een tweerichtingsgesprek niet gaat rondzingen.

1.4 Overlays, opnemen en 24/7-gebruik

• Video-overlay: toon de datum en tijd, een cameranaam (Cameranaam; laat leeg om de apparaatnaam te gebruiken), het IP-adres, batterij en temperatuur, GPS-coördinaten of een snelheidsmeter. Overlays worden in de video zelf getekend, dus ze verschijnen ook in de opnames van Frigate. Ze staan standaard allemaal uit.
• Opname-instellingen: zet Opnemen inschakelen aan voor een reservekopie op de telefoon. MP4-bestanden komen in Movies/CamRelay, opgesplitst volgens Duur opnamesegment (minuten). Wanneer Max. opslag (MB) is bereikt, worden de oudste bestanden verwijderd.
• Veiligheid & Automatisering: zet Automatisch starten bij opstarten apparaat aan, zodat CamRelay weer gaat streamen nadat de telefoon opnieuw is opgestart. Vanaf Android 10 heeft de app daarnaast toestemming nodig om over andere apps heen te worden weergegeven. Temperatuurveiligheid en Batterijveiligheid pauzeren de stream als de telefoon te warm wordt of de batterij bijna leeg is, en hervatten hem zodra alles weer normaal is.
• Batterijoptimalisatie: zorg dat batterijoptimalisatie voor CamRelay uit staat, zodat Android de app niet op de achtergrond stopt.

1.5 Streamen starten en de URL ophalen

Ga terug naar het hoofdscherm en tik op de afspeelknop. De balk bovenaan toont de resolutie, FPS, bitrate en gebruikte codecs. In de onderhoek staan drie adressen, elk met een kopieerknop:

• rtsp://<phone-ip>:1935/: de RTSP-URL voor Frigate.
• http://<phone-ip>:8888: de webinterface van CamRelay.
• http://<phone-ip>:8889/onvif/device_service: de ONVIF-dienst.

Bij een camera die op één plek blijft, tik je op het maan-pictogram (Scherm dimmen) om het scherm zwart te maken. Dat bespaart stroom en voorkomt inbranden bij OLED-schermen. Dubbeltik om het weer te activeren.

De voorbeelden hieronder gebruiken rtsp://192.168.1.50:1935/; vervang dit door de URL die CamRelay toont. De huidige versie van CamRelay vraagt nog niet om inloggegevens voor RTSP, dus gebruik het alleen in een netwerk dat je vertrouwt.

Binnenkort: met de volgende update van CamRelay kun je een gebruikersnaam en wachtwoord instellen om de RTSP-stream te beveiligen. Je hoeft ze dan alleen aan de URL in go2rtc toe te voegen, bijvoorbeeld rtsp://user:[email protected]:1935/.

Je kunt de stream vanaf de Frigate-server controleren met ffprobe:

ffprobe -rtsp_transport tcp rtsp://192.168.1.50:1935/

De uitvoer moet een h264-videostream en een audiostream tonen (pcm_mulaw bij G.711 ULAW, opus bij OPUS).

Stap 2: go2rtc instellen in Frigate

go2rtc in Frigate is het enige dat verbinding maakt met de telefoon. Het haalt de RTSP-stream van CamRelay één keer op en deelt die met opnemen, detectie, live beeld (MSE, WebRTC) en tweerichtingsgesprek. Frigate zelf leest van rtsp://127.0.0.1:8554/camrelay, zodat de telefoon nooit meerdere verbindingen tegelijk hoeft te bedienen. Zo blijft hij koeler en spaar je de batterij.

2.1 De stream toevoegen

Voeg een go2rtc-blok toe aan ~/frigate/config/config.yml:

go2rtc:
  streams:
    camrelay:                              # dezelfde naam als de Frigate-camera
      - rtsp://192.168.1.50:1935/          # de URL die CamRelay toont
  webrtc:
    candidates:
      - 192.168.1.100:8555   # IP van de Frigate-server
      - stun:8555

• Eén RTSP-regel is genoeg. Met G.711- of Opus-audio geeft go2rtc video en geluid rechtstreeks door aan de browser, zonder ffmpeg:-transcodering. Dezelfde RTSP-regel draagt ook het kanaal voor tweerichtingsgesprekken.
• webrtc.candidates is verplicht bij gewone Docker; zonder deze instelling werken WebRTC en de microfoon niet in het lokale netwerk. De poorten 8555 TCP/UDP zijn opengezet in "Voordat je begint".
• Heeft de stream dezelfde naam als de camera, dan gebruikt Frigate hem automatisch voor live beeld. Anders stel je live.streams in voor de camera.

2.2 Codecs en audio

Zet CamRelay op H.264-video. G.711 is de eenvoudigste keuze voor audio. Volgens de Frigate-documentatie speelt MSE (het standaard live beeld) AAC of PCMA/PCMU af, en WebRTC (gebruikt voor tweerichtingsgesprekken) Opus of PCMA/PCMU. Alleen G.711 werkt direct in beide.

Opus klinkt helderder dan G.711 (8 kHz, telefoonkwaliteit) als je vooral via WebRTC kijkt. Moet je H.265 gebruiken, voeg dan een regel toe voor videotranscodering en houd de RTSP-regel:

go2rtc:
  streams:
    camrelay:
      - rtsp://192.168.1.50:1935/
      - "ffmpeg:camrelay#video=h264#hardware"   # H.264-kopie voor browsers

2.3 Tweerichtingsgesprek

Tijdens het streamen is CamRelay altijd klaar om geluid te ontvangen via het RTSP-backchannel; er is geen schakelaar om aan te zetten. go2rtc opent dit kanaal via de RTSP-regel uit 2.1, zonder extra configuratie.

Om te praten open je Frigate via HTTPS op poort 8971, ga je naar het live beeld van de camera en druk je op de microfoon; Frigate schakelt zelf over naar WebRTC. Je stem klinkt uit de luidspreker van de telefoon, op het volume dat is ingesteld bij Afspeelvolume in CamRelay.

Moet een andere app ook rechtstreeks met de telefoon praten, voeg dan #backchannel=0 toe aan het einde van de RTSP-URL, zodat go2rtc het kanaal niet bezet houdt.

2.4 De camera toevoegen aan Frigate

Voeg onder het go2rtc-blok een cameras-blok toe. De camera leest de stream terug van go2rtc in plaats van verbinding te maken met de telefoon:

cameras:
  camrelay:
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/camrelay   # de go2rtc-stream uit 2.1
          input_args: preset-rtsp-restream
          roles:
            - record
            - detect   # vereist door Frigate, verder niets in te stellen
    record:
      enabled: true

CamRelay verstuurt één enkele stream (er is geen substream), dus de camera gebruikt die voor zowel opnemen als detectie.

Herstarten en controleren:

docker compose restart frigate
docker logs -f frigate

Om go2rtc apart te controleren, voeg je tijdelijk poort 1984:1984 toe aan docker-compose en open je http://<server-ip>:1984. De stream camrelay moet een RTSP-bron hebben met H264-video en PCMU/PCMA- of OPUS-audio. Verschijnt CamRelay op de startpagina van Frigate, dan ben je klaar.

Stap 3: Complete config.yml

Het bestand hieronder bevat alleen wat CamRelay nodig heeft: de go2rtc-stream, WebRTC, inloggen (voor HTTPS, nodig voor tweerichtingsgesprekken) en opnemen met geluid.

go2rtc:
  streams:
    camrelay:
      - rtsp://192.168.1.50:1935/   # de URL die CamRelay toont, H.264 + G.711 ULAW
  webrtc:
    candidates:
      - 192.168.1.100:8555   # IP van de Frigate-server
      - stun:8555

auth:
  enabled: true

cameras:
  camrelay:
    ffmpeg:
      inputs:
        - path: rtsp://127.0.0.1:8554/camrelay
          input_args: preset-rtsp-restream
          roles: [record, detect]   # detect: vereist door Frigate
    record:
      enabled: true
    live:
      streams:
        CamRelay: camrelay

version: 0.16-0

Problemen oplossen

De meeste problemen bij het toevoegen van CamRelay aan Frigate komen neer op de stream-URL, de codecs of het netwerk.

Vraag je om hulp in de GitHub Discussions van Frigate, voeg dan je configuratiebestand, het opstartlog en de ffprobe-uitvoer van de CamRelay-stream toe. Voor vragen over CamRelay tik je op Feedback in het scherm Over van de app.

Download CamRelay via Google Play

Meer nieuws, handleidingen en apps van Banana Studio vind je op xnano.net.

Bronnen: documentatie over Live View van Frigate voor go2rtc; de gebruikershandleiding van CamRelay en de vermelding in Google Play voor CamRelay.