Zum Inhalt

Scrypted auf Home Assistant OS für Apple Home einrichten

Veröffentlicht am 29. August 2026 · Geschätzte Lesezeit: 9 Minuten

Scrypted nimmt den lokalen Stream einer RTSP- oder ONVIF-Kamera entgegen und stellt ihn für Apple Home bereit. Dadurch lassen sich viele vorhandene IP-Kameras schneller in Apple Home öffnen und – bei passender Kamera sowie erfüllten Apple-Voraussetzungen – mit HomeKit Secure Video verwenden. Plane für Installation und die erste Kamera etwa 45 bis 60 Minuten ein.[6][7]

Voraussetzungen

  • Home Assistant OS mit Administratorzugriff und einem aktuellen vollständigen Backup
  • Eine lokale IP-Kamera mit RTSP oder ONVIF, H.264-Stream und erreichbarer Verwaltungsoberfläche
  • Ein eigener Kamerabenutzer, die lokale Kamera-IP und die tatsächlich verwendeten Ports
  • Für HomeKit Secure Video: iPhone oder iPad, Apple Home, iCloud+ sowie ein eingerichteter Home-Hub

1. Kompatibilität, Ressourcen und Rückweg prüfen

Diese Anleitung verwendet die Scrypted-App innerhalb von Home Assistant OS. Die offizielle Scrypted-Übersicht unterstützt diesen Installationsweg, empfiehlt Home Assistant OS wegen der begrenzten Speichermöglichkeiten jedoch nicht für Scrypted NVR. Die reine Weitergabe einer kleinen Zahl von Kameras an Apple Home ist von einer dauerhaften NVR-Aufzeichnung zu unterscheiden.[1]

Öffne Einstellungen → System → Backups, erstelle ein vollständiges Backup und lade eine Kopie auf einen anderen Rechner oder ein NAS herunter.[10] Prüfe außerdem unter Einstellungen → System → Hardware, ob genügend freier Speicher und Arbeitsspeicher vorhanden sind.[10]

Für HomeKit Secure Video verlangt Apple ein iCloud+-Abonnement und einen eingerichteten Home-Hub. Scrypted nennt dafür einen HomePod oder Apple TV. Eine funktionierende Live-Ansicht allein garantiert daher noch keine Aufzeichnung.[6][8]

Warning

Beginne mit genau einer Kamera. Transcodierung und softwarebasierte Bewegungserkennung können CPU und Arbeitsspeicher stark belasten. Wird Home Assistant instabil, stoppe zuerst die Scrypted-App und stelle nicht sofort das gesamte Backup wieder her.

2. Kamera sicher vorbereiten

Vergib in der Kamera einen langen, einzigartigen Zugang nur für Scrypted.[5] Die aktuelle Scrypted-Dokumentation weist darauf hin, dass Kamera-Autokonfiguration und Bewegungsereignisse häufig Administratorrechte benötigen.[5][7] Verwende dieses Konto deshalb ausschließlich im Heimnetz und nicht für den täglichen Zugriff.[5]

Stelle in der Kamera-Verwaltung Folgendes ein:

  • Aktiviere ONVIF, wenn die Kamera es anbietet.[5]
  • Aktiviere Hauptstream und Substream.[5]
  • Verwende für beide Streams möglichst H.264, nicht H.265 oder herstellerspezifische Varianten wie H.264+.[5]
  • Aktiviere einen Bewegungsmelder und begrenze seine Zone auf den wichtigen Bildbereich.[5]
  • Verwende ein langes alphanumerisches Passwort, falls Sonderzeichen bei RTSP oder ONVIF nachweislich Anmeldefehler verursachen.[5]

Scrypted empfiehlt H.264 für HomeKit und warnt vor höherer Last und Verzögerung durch H.265-Transcodierung. Für RTSP-Kameras sind Haupt- und Substream wichtig, damit die Bewegungserkennung nicht unnötig den hochauflösenden Stream analysiert.[5][7]

Danger

Öffne RTSP-, ONVIF- oder Scrypted-Ports niemals per Portweiterleitung ins Internet. Schreibe Zugangsdaten nicht in Screenshots, Supportbeiträge oder eine RTSP-URL. Für Fernzugriff verwendest du Apple Home oder ein abgesichertes VPN.

3. Offizielles Scrypted-Repository hinzufügen

Öffne Einstellungen → Apps → Install app.[10] Wähle oben rechts das Drei-Punkte-Menü, öffne Repositories und füge diese Repository-Adresse ein:[3][10]

https://github.com/koush/scrypted

Home Assistant beschreibt diesen Menüweg für Drittanbieter-Repositories. Die konkrete Repository-Adresse stammt aus der offiziellen Scrypted-Anleitung für Home Assistant OS.[3][10]

Aktualisiere die Seite, falls die neue Repository-Karte nicht sofort erscheint.[10] Installiere keine gleichnamige App aus einer unbekannten Quelle.[10]

4. Scrypted installieren und erstmals starten

Suche im App-Store nach Scrypted, öffne die App und wähle Install.[3] Aktiviere zunächst nur Start on boot beziehungsweise Beim Systemstart starten.[3] Starte die App und öffne anschließend Open Web UI oder den Scrypted-Eintrag in der Seitenleiste.[3]

Kontrolliere auf der Registerkarte Log, ob die App ohne fortlaufende Neustarts läuft. Aktiviere automatische Updates erst, nachdem die erste Kamera funktioniert und du ein neues Backup erstellt hast.

5. Eigenes Scrypted-Administratorkonto anlegen

Öffne in Scrypted Users und erstelle ein eigenes Administratorkonto mit einem einzigartigen, langen Passwort.[2][3] Verwende den automatisch erzeugten Benutzer homeassistant nicht als dein persönliches Administratorkonto.[2][3] Die offizielle Dokumentation verlangt für weitere Home-Assistant-Anbindungen ebenfalls ein separates Scrypted-Administratorkonto.[2][3]

Speichere die Zugangsdaten in einem Passwortmanager. Prüfe die Anmeldung in einem privaten Browserfenster, bevor du die aktuelle Sitzung schließt.

6. Passendes Kamera-Plugin installieren

Öffne in Scrypted Plugins und suche zuerst nach einem Plugin des Kameraherstellers. Ist keines vorhanden, probiere ONVIF und erst danach RTSP. Scrypted empfiehlt diese Reihenfolge, weil Hersteller- und ONVIF-Plugins Bewegungsereignisse und weitere Kamerafunktionen meist besser bereitstellen.[7]

Installiere für eine ONVIF-Kamera das ONVIF Plugin.[7] Öffne das Plugin und füge eine neue Kamera hinzu.[7] Halte diese Werte bereit:

Host: <kamera-ip>
Username: <kamera-benutzer>
Password: <kamera-passwort>
HTTP port override: <onvif-port>

Ersetze <kamera-ip> durch die lokale IP-Adresse oder den stabilen lokalen DNS-Namen der Kamera. Ersetze <kamera-benutzer> und <kamera-passwort> durch das ausschließlich für Scrypted angelegte Kamerakonto. Ersetze <onvif-port> durch den in der Kamera-Dokumentation angegebenen ONVIF- beziehungsweise HTTP-Port.

Trage kein ungeprüftes http://, keinen herstellerspezifischen Gerätepfad und keinen Beispielport ein. Die ältere Praxisquelle zeigt, dass Hostformat und Port je nach Hersteller abweichen; maßgeblich sind deshalb die aktuelle Kamera-Dokumentation und die tatsächlich konfigurierte Oberfläche.[4]

Unterstützt die Kamera nur RTSP, installiere stattdessen das RTSP Plugin und füge Haupt- und Substream getrennt über die Eingabefelder der Oberfläche hinzu.[7] Füge Benutzername und Passwort nicht sichtbar in eine URL ein.[5]

7. Livebild und Bewegungsereignis in Scrypted prüfen

Öffne die neu angelegte Kamera in Scrypted. Prüfe nacheinander:

  1. Das Vorschaubild wird aktualisiert.
  2. Der Hauptstream öffnet sich ohne lange Verzögerung.
  3. Der Substream ist vorhanden und korrekt zugeordnet.
  4. Ein reales Bewegungsereignis wird in Scrypted erkannt.

Funktioniert einer dieser Punkte nicht, richte HomeKit noch nicht ein.[6] Die offizielle HomeKit-Anleitung empfiehlt ausdrücklich, zuerst die Kamerastreams in Scrypted zu prüfen; HomeKit Secure Video benötigt zusätzlich Bewegungsereignisse und passende Codecs.[6]

Beobachte während des Tests Einstellungen → System → Hardware und das Scrypted-Protokoll. Steigt die Last stark an, kontrolliere zuerst H.264, Substream-Zuordnung und Bildrate, statt weitere Kameras hinzuzufügen.

8. HomeKit-Plugin aktivieren

Öffne Plugins, installiere das HomeKit Plugin und kontrolliere danach bei der Kamera unter Extensions beziehungsweise HomeKit, ob das Plugin aktiviert ist. Ist es deaktiviert, aktiviere es und lade das HomeKit-Plugin einmal neu.[6]

Scrypted verwendet Kameras standardmäßig als einzelne HomeKit-Geräte im Accessory Mode. Dadurch besitzt jede Kamera einen eigenen QR-Code. Ändere diesen Modus für den ersten Test nicht.[6]

9. Kamera mit Apple Home koppeln

Öffne in der Scrypted-Kamera HomeKit → Pairing.[6] Dort wird der individuelle QR-Code der Kamera angezeigt.[6] Öffne auf dem iPhone oder iPad die App Home, wähle Gerät hinzufügen und scanne genau diesen Kamera-Code.[6]

Warning

Teile oder fotografiere den QR-Code und den manuellen Kopplungscode nicht. Wer den Code und Netzwerkzugriff besitzt, könnte versuchen, das Gerät einem anderen Zuhause hinzuzufügen.

Vergib in Apple Home einen eindeutigen Kameranamen und ordne die Kamera dem richtigen Raum zu.[8] Öffne danach das Livebild und prüfe, ob Bild und Ton wie erwartet ankommen.[6][8]

10. HomeKit Secure Video einschalten

Öffne in Apple Home die Kameraeinstellungen und stelle die gewünschte Zugriffsart auf Stream & Allow Recording beziehungsweise die entsprechende deutsche Option für Streaming und Aufnahme.[6] Die Scrypted-Dokumentation nennt diesen Schritt ausdrücklich für HomeKit Secure Video.[6]

Prüfe anschließend mit einer echten Bewegung vor der Kamera, ob Apple Home ein Ereignis erkennt und nach kurzer Zeit eine Aufnahme in der Zeitleiste zeigt.[6][8] Die Aufnahme entsteht nur, wenn iCloud+, Home-Hub, Bewegungsereignis und Kameraformat zusammenpassen.[5][6][8]

Info

Scrypted NVR und HomeKit Secure Video sind verschiedene Funktionen. Für die hier beschriebene Apple-Aufzeichnung musst du kein Scrypted-NVR-Abonnement einrichten und keinen dauerhaften NVR-Speicher auf Home Assistant OS konfigurieren.[1][6]

11. Backup und sicheren Rückweg abschließen

Wenn Livebild, Bewegung und Aufnahme funktionieren, erstelle ein neues vollständiges Home-Assistant-Backup. Gib ihm einen eindeutigen Namen wie Vor weiteren Scrypted-Kameras und lade es extern herunter.

Bei Problemen gehst du in dieser Reihenfolge zurück:

  1. Deaktiviere in Apple Home Stream & Allow Recording.
  2. Entferne die Kamera aus Apple Home.
  3. Deaktiviere das HomeKit-Plugin für diese Kamera.
  4. Entferne die Kamera erst danach aus dem Kamera-Plugin.
  5. Stoppe und deinstalliere die Scrypted-App, wenn du sie nicht weiterverwenden möchtest.
  6. Entferne das Scrypted-Repository nur, wenn keine Scrypted-App mehr daraus installiert ist.

Das ursprüngliche vollständige Backup bleibt der letzte Rückweg, falls die App-Installation Home Assistant beeinträchtigt hat. Eine Wiederherstellung überschreibt neuere Änderungen und sollte deshalb erst nach dem Stoppen der App und nach Prüfung des Backup-Zeitpunkts erfolgen.

12. Typische Fehler beheben

  • Das Scrypted-Repository erscheint nicht: Aktualisiere den Browser und kontrolliere unter Einstellungen → System → Logs das Supervisor-Protokoll. Home Assistant warnt, dass Drittanbieter-Apps nicht von Home Assistant auf Qualität oder Sicherheit garantiert werden.[10]
  • Die App startet immer wieder neu: Prüfe freien Speicher und Arbeitsspeicher. Stoppe die App und beginne nach einem stabilen Home-Assistant-Neustart nur mit einer Kamera.
  • Die Kamera wird nicht gefunden: Kontrolliere lokale IP, ONVIF-Aktivierung, Benutzerrechte und den tatsächlichen Port. Probiere nicht wahllos Ports aus.
  • ONVIF meldet einen Anmeldefehler: Prüfe, ob die Kamera ein separates ONVIF-Konto verlangt und ob Sonderzeichen im Passwort die Kamera-Implementierung stören.[5]
  • Das Livebild bleibt schwarz: Stelle Haupt- und Substream auf H.264, deaktiviere H.264+ beziehungsweise H.265 und prüfe beide Streams direkt in Scrypted.[5]
  • HomeKit zeigt keinen QR-Code: Kontrolliere, ob das HomeKit-Plugin bei der Kamera aktiviert ist, und lade das Plugin neu.[6]
  • Kopplung schlägt nach einem früheren Versuch fehl: Entferne die Kamera vollständig aus Apple Home, setze nur ihre HomeKit-Kopplung in Scrypted zurück und lade das Plugin neu. Setze nicht die gesamte Scrypted-Installation zurück.
  • Livebild funktioniert, aber es gibt keine Aufnahmen: Prüfe Bewegungsereignis in Scrypted, Home-Hub, iCloud+ und die Einstellung Stream & Allow Recording.[6][8]
  • Home Assistant wird langsam: Verwende den H.264-Substream, reduziere unnötig hohe Bildraten und vermeide softwarebasierte Bewegungserkennung auf dem Hauptstream.[5][7]

Grundlage dieser Anleitung sind die aktuellen offiziellen Seiten zur Scrypted-Installation, zur Kameravorbereitung, zum Hinzufügen einer Kamera, zu HomeKit und zur Home-Assistant-OS-App, geprüft am 29. August 2026.[1][3][5] Die Apple-Voraussetzungen wurden mit dem offiziellen HomeKit-Secure-Video-Hinweis abgeglichen.[8] Als Praxisabgleich dient der ältere Home-Assistant-Community-Beitrag; veraltete Repository-Angaben daraus wurden nicht übernommen.[4] Eine öffentlich auffindbare visuelle Ergänzung ist How to install Scrypted on Home Assistant.[9]

Sources

[1] https://docs.scrypted.app/installation.html — Install Scrypted | Scrypted Docs [2] https://docs.scrypted.app/home-assistant.html — Home Assistant | Scrypted Docs [3] https://github.com/koush/scrypted/wiki/Installation:-Home-Assistant-OS — Installation: Home Assistant OS [4] https://community.home-assistant.io/t/add-on-scrypted-homekit-secure-video/398487 — Add-on: Scrypted (Homekit Secure Video) [5] https://docs.scrypted.app/camera-preparation.html — Camera Configuration | Scrypted Docs [6] https://docs.scrypted.app/homekit.html — HomeKit | Scrypted Docs [7] https://docs.scrypted.app/add-camera.html — Add a Camera | Scrypted Docs [8] https://support.apple.com/guide/icloud/set-up-homekit-secure-video-mm7c90d21583/icloud — Set up HomeKit Secure Video on all your devices | Apple Support [9] https://www.youtube.com/watch?v=W2WI_zDkUgU — How to install Scrypted on Home Assistant [10] https://www.home-assistant.io/common-tasks/os — Common tasks - Home Assistant Operating System | Home Assistant

Fertig

Scrypted läuft jetzt als Home-Assistant-OS-App und übergibt die geprüfte Kamera an Apple Home. Die Funktionsprüfung ist bestanden, wenn Haupt- und Substream in Scrypted laufen, ein Bewegungsereignis erkannt wird, das Livebild in Apple Home öffnet und – bei aktiviertem HomeKit Secure Video – eine neue Aufnahme in der Zeitleiste erscheint.[5][6][8]