1 Einleitung 8
2 Schnellstart 19
3 Benutzeroberäche (GUI) 26
4 Kommandozeilen Programm (CLI) 86
camera
status
recording
recording-config
storage
settings
license
ptz
image
update
maintenance
daemon
5 CloudlessCam Player / CloudlessCam Web Player 120
6 CloudlessCam API Server 140
7 Tipps und Tricks 156
8 Häug gestellte Fragen (FAQ) 165
9 Technische Informationen 176
10 Kongurationsdateien und andere Anwendungsdaten 190
11 Referenzen 210
1.1 Was ist CloudlessCam?
1.1.1 Funktionsübersicht
Kameraverwaltung:
Aufnahmen:
Speicherziele:
Live-Überwachung:
Wiedergabe:
Desktop Player:
Web Player:
PTZ-Steuerung:
Hintergrundbetrieb:
1.1.2 Unterstützte Sicherheitskameras und Video-Streams
ONVIF
Achtung: Es ist hier jedoch anzumerken, dass CloudlessCam nicht ONVIF zerti-
ziert ist und daher nicht garantieren kann, dass alle Aspekte des ONVIF Protokolls
vollständig und richtig implementiert sind, weshalb es zu Inkompatibilitäten kom-
men kann.
RTSP
Weitere Protokolle
Audio
Hinweise zur Kompatibilität
1.1.3 Unterstützte Speicher
Direkt unterstützte Speicher
Dateisystem:
\\Server\Freigabe
WebDAV:
SFTP:
FTP:
S3-kompatibel:
Backblaze:
OneDrive:
Dropbox:
Google Drive:
Indirekt unterstützte Speicher
1.1.4 Empfehlungen zum Betrieb der Software
Netzwerk
(Wobei CloudlessCam die neue IP-Adresse bei Änderung
automatisch nach kurzer Zeit ermitteln sollte.)
(Zusätzlich schützt sie eine
kabelgebunde Verbindung gegen Deauth-Wi-Attacken oder Wi-Störsendern.)
Performance
Speicher
(Bspw. nur 100 GiB für einen
Netzwerkordner. Wenn der Speicher voll läuft werden so viele der ältesten
Dateien gelöscht bis genug Speicher für die neuen Aufnahmen frei ist.)
Sicherheit
Dauerbetrieb
1.2 Installation
1.2.1 Vorbereitung und erster Start
Netzwerk:
1.2.2 CloudlessCam Release-Pakete
Windows-Pakete
Installationsprogramm (Admin): CloudlessCam-Setup.exe
C:\Program Files\
CloudlessCam
Installationsprogramm (Benutzer): CloudlessCam-User-Setup.exe
Ohne Installation / Portable: CloudlessCam-win-x64.zip
Linux-Pakete
CloudlessCam-linux-x64.zip
CloudlessCam-linux-arm64.zip
macOS-Pakete
App-Bundle: CloudlessCam-osx-x64-app.tar.zip
Portable: CloudlessCam-osx-x64.zip
1.2.3 Windows
Installationsprogramm
ZIP-Datei
CloudlessCamGUI.exe
1.2.4 Linux
Installation
unzip CloudlessCam-linux-x64.zip
tar -xf CloudlessCam-linux-x64.tar
chmod +x CloudlessCamGUI
./CloudlessCamGUI
Raspberry Pi
1.2.5 macOS
App-Bundle
CloudlessCam-osx-x64-app.tar.zip
CloudlessCam.app /Applications
/Applications
ZIP-Datei
Quarantäne-Attribut entfernen
# Ins Programme-Verzeichnis wechseln
cd /Applications
# App von der Quarantäne befreien
xattr -dr com.apple.quarantine "CloudlessCam.app"
1.3 Lizenzierung
1.3.1 Online-Aktivierung
FREE
1.3.2 Oine-Aktivierung
.prelicensed
.fulllicensed
1.3.3 Lizenznutzung und Datenschutz
1.3.4 CLI-Unterstützung
license status
license list
license activate
license usage
license offline-requestlicense offline-generate license offline-import
2.1 Voraussetzungen
2.2 Erster Start
2.2.1 Schritt 1: Erste Einrichtung
2.2.2 Schritt 2: Kamera hinzufügen
Automatische Erkennung (empfohlen)
RTSP-Fund
/stream1
/ch=1&subtype=0
Manuell hinzufügen
rtsp://192.168.
1.100:554/stream1
2.2.3 Schritt 3: Verbindung testen
2.2.4 Schritt 4: Aufnahme-Konguration erstellen
Video
Audio
Bild
Segmentlänge
Videoqualität
Audio aufnehmen
Zeitplan
Auewahrungsdauer
Maximaler Speicherplatz
2.2.5 Schritt 5: Speicherort einrichten
Lokaler Speicher
C:\CloudlessCam\
Recordings /home/user/CloudlessCam
Netzwerkspeicher (SFTP, FTP, WebDAV)
Cloud-Speicher
2.2.6 Schritt 6: Aufnahmen prüfen
2.3 Hintergrundbetrieb (Admins und Power-User)
2.3.1 Vorgehensweise
2.4 CloudlessCam Player (Aufnahmen ansehen)
2.4.1 Schritt 1: Player starten
2.4.2 Schritt 2: Speicherorte kongurieren
Import aus CloudlessCam
.config
Manuell hinzufügen
2.4.3 Schritt 3: Aufnahmen laden
2.4.4 Schritt 4: Aufnahmen wiedergeben
2.5 Wenn etwas nicht klappt
2.5.1 Die automatische Suche ndet keine Kameras
2.5.2 Kein Bild oder ruckelnde Wiedergabe
2.5.3 Es werden keine Aufnahmen erstellt
2.5.4 Probleme mit Updates oder Lizenz
2.5.5 Diagnose und Support
3.1 Programmfenster
3.1.1 Titelleiste
FREE
Elemente der Titelleiste
Sprachauswahl:
eme-Umschaltung:
Hell:
Dunkel:
Fenstersteuerung:
Vollbild:
Immer im Vordergrund:
Minimieren:
Maximieren / Wiederherstellen:
Schließen:
Verhalten beim Minimieren
Plattformspezische Unterschiede
3.1.2 Menüleiste
Kopereich
Seitennavigation
Übersicht:
Kameras:
Aufnahmen:
PTZ-Steuerung:
Videowand:
Ereignisprotokoll:
Dateiübertragungen:
Software-Lizenz:
Software-Updates:
Einstellungen:
Fußbereich
3.1.3 Tray-Symbol, Benachrichtigungen, Mehrfachstart- sowie Taskleisten-
Verhalten
Tray-Symbol
Verfügbare Aktionen:
Doppelklick auf das Symbol:
Rechtsklick auf das Symbol:
– Fenster anzeigen:
– Programm beenden:
Startverhalten
Start minimiert aktiviert und Immer in der Taskleiste aktiviert:
Start minimiert aktiviert und Immer in der Taskleiste deaktiviert:
Minimierverhalten
Benachrichtigungen
Mehrfachstart
3.2 Programmseiten
3.2.1 Übersicht
Hinweisleisten
Update-Hinweis:
Autostart-Hinweis:
Pacemaker-Hinweis:
Gerätestatistiken
Gesamt:
Online:
Oine:
Unbekannt:
Online-Anteil:
Speicherstatistiken
Temporärer Ordner:
Ziel-Speicher:
Gesamt:
Dateistatistiken
Aufgenommen pro Stunde:
Übertragen pro Stunde:
System- und Kongurationsstatistiken
Betriebszeit:
Aufnahmekongurationen:
Ziel-Speicher:
Restream aktiviert:
Letzte Ereignisse
Typ:
Datum:
Name:
Text:
Dateiübertragungen
Aktualisierung
3.2.2 Kameras
Werkzeugleiste
Gerät hinzufügen:
Ordner erstellen:
Alle Vorschaubilder aktualisieren:
Alle ausklappen:
Alle einklappen:
Alle Aufnahmekongurationen aktivieren:
Alle Aufnahmekongurationen deaktivieren:
Zoom-Regler:
Hierarchische Baumansicht
1. Ordner (Gerätegruppen):
2. Geräte (Kameras):
3. Aufnahmekongurationen:
4. Ziel-Speicher:
Drag & Drop
Aktionen für Ordner
Aktionen für Geräte
Live-Stream anzeigen:
Vorschaubild aktualisieren:
Name ändern:
Geräteeinstellungen önen:
Standard-Stream ändern:
Aufnahmekonguration hinzufügen:
Aktionen für Aufnahmekongurationen
Aktivieren/Deaktivieren:
Name ändern:
Aufnahme-Einstellungen:
Kamera-Bildeinstellungen:
Ziel-Speicher hinzufügen:
Temporären Ordner önen:
Aktionen für Ziel-Speicher
Aktivieren/Deaktivieren:
Name ändern:
Speicher-Einstellungen:
Vorschaubilder
3.2.3 Aufnahmen
Kalender
Videoplayer
Wiedergabesteuerung:
Automatische Fortsetzung:
Timeline
Navigation in der Timeline:
Zoom:
Verschieben:
Export
Aktuelle Aufnahme exportieren:
Aufnahmebereich exportieren:
Verschlüsselte Aufnahmen
3.2.4 PTZ-Steuerung
Voraussetzungen
Kameraauswahl
Dropdown-Menü:
Aktualisieren:
Statusanzeige
Grüner Punkt:
Roter Punkt:
Statusmeldung:
Weitere Optionen
PTZ-Backend:
Horizontal/Vertikal invertieren:
Bewegungsskalierung:
Diagonale Bewegung emulieren:
Maximale Emulationsschritte:
Optionale PTZ-Befehlsemulation:
Standard-PTZ-Befehle nutzen:
Schrittbewegungen mit kontinuierlichen Bewegungen emulieren:
Kontinuierliche Bewegungen mit Schrittbewegungen emulieren:
Live-Video
Unterseiten
Manuelle Steuerung:
Kontinuierliche Bewegung:
Schrittbewegung:
Absolute Bewegung:
Gespeicherte Positionen:
Neue Position speichern:
Position anfahren:
Position umbenennen:
Position löschen:
Aktions-Sequenzen:
Sequenz hinzufügen:
Aktivieren/Deaktivieren:
Täglich um:
Intervall:
Schleife:
Zu einer gespeicherten Position fahren:
Aktuelle Position speichern:
Relative Bewegung:
Absolute Bewegung:
Zur Startposition:
Warten:
Fokus:
Bewegungs-Log:
PTZ-Fähigkeitstests:
Alle PTZ-Backends testen:
Fortschrittsanzeige:
Matrix pro PTZ-Backend:
Spalteninhalte:
3.2.5 Videowand
Steuerungsleiste
Aktualisieren:
Automatische Wiedergabe:
Layout-Schaltächen:
Layout-Optionen
1 Spalte:
2 Spalten:
3 Spalten:
4 Spalten:
Kamera-Kacheln
Titel:
Wiedergabe-Schaltäche:
Live-Video:
Automatische Wiedergabe
Performance-Hinweise
3.2.6 Ereignisprotokoll
Tabellenstruktur
Typ:
Datum:
Ereignisname:
Ereignistext:
Sortierung
Filterung
Ereignistypen
Ereignisprotokoll bereinigen
Automatische Bereinigung
Löschintervall:
Maximale Einträge:
3.2.7 Dateiübertragungen
Übersichtsinformationen
Ausstehende Übertragungen:
Gesamtgröße:
Übertragungsgeschwindigkeit:
Übertragungsliste
Dateiname:
Kamera:
Ziel-Speicher:
Status:
Fortschritt:
Geschwindigkeit:
Filteroptionen
Kamera:
Aufnahmekonguration:
Ziel-Speicher:
Status:
Suche:
Abgeschlossene Übertragungen
Aktualisierung
Typische Anwendungsfälle
3.2.8 Software-Lizenz
Lizenz aktivieren
Lizenzschlüssel:
Lizenz aktivieren:
Statusanzeige:
Aktive Lizenzen
Kostenlose Lizenz:
Gekaufte Lizenzen:
Abgelaufene Lizenzen:
Entfernen:
FREE
Zusätzliche Optionen
Rechnername:
Keine Gerätenamen teilen:
Oine-Aktivierung
.prelicensed
.fulllicensed
Lizenznutzung
Lizenz:
Computer:
Aufnahmen:
Aktualisierung
Lizenzslot-Verhalten
3.2.9 Software-Updates
Installierte Version
Verfügbare Version
Versionsnummer:
Prüfen/Aktualisieren:
Online-Changelog:
Update-Kanal
Release:
Test:
Benachrichtigungen
Update durchführen
3.2.10 Einstellungen
Benutzeroberäche
Sprache:
eme-Modus:
UI-Skalierung:
Start minimiert:
Splash-Screen anzeigen:
Immer in der Taskleiste:
Vorschaubild-Aktualisierungsintervall:
Identikatoren anzeigen:
System
Startmodus:
GUI:
Hintergrund:
Beides:
Desktop-Verknüpfung:
Ereignisprotokoll löschen nach X Tagen:
Maximale Ereignisprotokoll-Einträge:
Aufnahme-Metadaten-Archiv löschen nach X Tagen:
Alle FFmpeg-Prozesse beim Start beenden:
Alle go2rtc-Prozesse beim Start beenden:
Debug-Modus:
Arbeitsverzeichnis önen:
Installationsverzeichnis önen:
Netzwerksuche
ONVIF-Discovery aktiviert:
RTSP-Discovery aktiviert:
Automatische IP-Änderungsprüfung:
IP-Prüfungsintervall:
Aufnahme
Wiederverbindungsintervall:
Maximale aufeinanderfolgende Fehler:
Direktverbindung bei Restream-Fehler erlauben:
Automatischer Aufnahme-Neustart:
Automatisches Neustartintervall:
Ziel-Speicher
Maximale gleichzeitige globale Übertragungen:
Maximale gleichzeitige Übertragungen pro Speicher:
Ziel-Speicher Timeout:
Ziel-Speicher Fehlerschwelle:
Ziel-Speicher Fehler-Abkühlzeit:
Automatischer Dateisynchronisations-Neustart:
Dateisynchronisation Stillstands-Timeout:
Geschwindigkeitslimit für Übertragungen:
Maximale Temp-Verzeichnisgröße:
Temp-Ordner bereinigen:
Kongurationsdatei
Kongurationspasswort:
Automatisches Speicherintervall:
Backup-Verwaltung:
3.3 Dialog-Fenster
3.3.1 Sprachauswahl
Önen des Dialogs
Auswahl und Anwendung
Schaltächen
OK:
Abbrechen:
3.3.2 Dokumentation / Support
Dokumentation
Online-Dokumentation:
Lokale Dokumentation:
Support
Als ZIP speichern:
Datenschutzhinweis
3.3.3 Rechtliche Hinweise
3.3.4 Gerät hinzufügen (Übersicht)
Automatische Suche
Ergebnisliste
Protokolltyp:
Hersteller:
Modell:
IP:Port:
MAC-Adresse:
Filter für bekannte Geräte
Aktualisieren
Manuell hinzufügen
rtsp://IP:Port/stream
Weiter zum Kongurieren
Schaltächen
OK:
Abbrechen:
3.3.5 Automatisch gefundenes Gerät hinzufügen (ONVIF)
Geräteinformationen
Zugangsdaten
Benutzername:
Passwort:
Standard-Zugangsdaten automatisch ausprobieren
camera guess-credentials
Verbindung herstellen
Stream-Auswahl
Streamname:
URL:
Auösung:
Bildrate:
Bestätigung
Fehlerbehebung
Falsche Zugangsdaten:
ONVIF deaktiviert:
Port blockiert:
Timeout:
Keine Streams erkannt:
Schaltächen
OK:
Abbrechen:
3.3.6 RTSP-gefundenes Gerät hinzufügen
Geräteinformationen
RTSP-URL kongurieren
/stream1/ch=1&subtype=0
URL-Format:
rtsp://{{USERNAME}}:{{PASSWORD}}@IP:PORT/stream-pfad
Zugangsdaten
Hilfe zur URL
Validierung
Typische Fehler
Falscher Pfad:
Port blockiert:
Nur eine Sitzung:
Falsche Zugangsdaten:
Schaltächen
OK:
Abbrechen:
3.3.7 Gerät manuell hinzufügen
Verwendung
URL eingeben
RTSP: rtsp://IP:554/stream
HTTP/HTTPS: http://IP/video.mjpeg
HLS: http://IP/stream.m3u8
DASH: http://IP/manifest.mpd
RTP: rtp://IP:5000
SRT: srt://IP:9000
Zugangsdaten
Benutzername:
Passwort:
Validierung
Ergebnis
Schaltächen
OK:
Abbrechen:
3.3.8 Kamera-Modell suchen
Zweck
Vorgehensweise
Typische Quellen
URL-Platzhalter
3.3.9 Geräteeinstellungen
Netzwerkeinstellungen
IP-Adresse:
Port:
MAC-Adresse:
Restream-Konguration
Restream verwenden:
Restream-Port:
Status:
Auswirkungen beim Anwenden
Fehlerfälle
Ungültige IP-Adresse:
Port bereits belegt:
Verbindung fehlgeschlagen:
Schaltächen
Anwenden:
Abbrechen:
3.3.10 Stream-Auswahl
Zweck
Stream-Liste
Streamname:
URL:
Auösung:
Bildrate:
Schaltächen
OK:
Abbrechen:
3.3.11 Live-Stream
Zweck
Bedienelemente
Wiedergabesteuerung:
Play/Pause:
Lautstärke:
Technische Hinweise
Ressourcenverbrauch:
Fehlerbehebung
Kein Bild:
Codec nicht unterstützt:
Bildstörungen:
3.3.12 Aufnahme-Typ auswählen
Verfügbare Aufnahmetypen
Video:
Einzelbild (Snapshot):
Audio:
Auswahl
Schaltächen
OK:
Abbrechen:
3.3.13 Aufnahme-Einstellungen
Struktur
Oben:
Unten:
Grundlegende Logik
alle
Verfügbare Einstellungstypen
Wochentag und Uhrzeit:
Nur alle X Sekunden:
Nur für bestimmten Zeitraum behalten:
Audio aufnehmen:
Bilder pro Sekunde:
Segmentlänge:
Maximaler Gesamtspeicher:
Video-Codec:
Video-Qualität:
Audio-Codec:
Bildformat:
Benutzerdeniertes Wasserzeichen:
Zeitstempel:
Dateiname anpassen:
Dateiverschlüsselung:
.encrypted7z.7z
Warnung:
Codec-Kompatibilität
Auswirkungen beim Anwenden
Schaltächen
Anwenden:
Abbrechen:
3.3.14 Kamera-Bildeinstellungen
Verfügbare Einstellungen
Helligkeit:
Kontrast:
Sättigung:
Schärfe:
Weißabgleich:
Belichtung:
Infrarotlicht:
Anwendung
Schaltächen
Anwenden:
Abbrechen:
3.3.15 Ziel-Speicher-Typ auswählen
Verfügbare Speichertypen
Lokales Dateisystem:
SFTP:
WebDAV:
S3-kompatibel:
Backblaze B2:
Dropbox:
OneDrive:
Google Drive:
Auswahl
Schaltächen
OK:
Abbrechen:
3.3.16 Ziel-Speicher-Einstellungen
Unterstützte Speichertypen
Lokales Dateisystem:
Zielordner:
Ordner önen:
SFTP (SSH File Transfer Protocol):
Host:
Port:
Benutzername:
Passwort:
Remote-Pfad:
Verbindung testen:
WebDAV:
URL:
Benutzername:
Passwort:
Remote-Pfad:
Verbindung testen:
S3-kompatibler Speicher:
Service-URL/Endpoint:
Bucket:
Ordnerpfad:
Access Key:
Secret Key:
Path Style erzwingen:
Verbindung testen:
Backblaze B2:
Region:
Key ID:
Application Key:
Bucket:
Ordnerpfad:
Authentizieren:
Zugangsdaten löschen:
Verbindung testen:
Dropbox:
Authentizieren:
Ordnerpfad:
Zugangsdaten löschen:
Verbindung testen:
OneDrive:
Authentizieren:
Ordnername:
Zugangsdaten löschen:
Verbindung testen:
Google Drive:
Authentizieren:
Ordnername:
Zugangsdaten löschen:
Verbindung testen:
Verbindungstest
Typische Fehler
Authentizierung abgelaufen:
Pfad nicht gefunden:
Zertikatsfehler:
Ratenbegrenzung:
Keine Schreibberechtigung:
Schaltächen
Anwenden:
Abbrechen:
3.3.17 Update-Download
Anzeige
Ablauf
Abbrechen
Fehlerfälle
4.1 Überblick
Headless-Betrieb:
Automatisierung:
Monitoring:
Wartung:
CloudlessCamCLI <Kategorie> <Aktion> [Optionen]
4.2 Installation und Aufruf
CloudlessCamCLI.exe CloudlessCamCLI
CloudlessCamCLI --help
CloudlessCamCLI camera --help
CloudlessCamCLI camera list
%APPDATA%\CloudlessCam
~/.config/CloudlessCam
4.3 Ausgabeformate und globale Optionen
--format
table
json
csv
--no-color --no-colours
--help
4.4 Kommando-Kategorien
Kategorie Beschreibung
4.5 Daemon und Pacemaker
CloudlessCamCLI daemon start
CloudlessCamCLI daemon stop
CloudlessCamCLI daemon restart
CloudlessCamCLI daemon status
CloudlessCamCLI daemon logs
4.6 Aufrueispiele
4.6.1 Windows
# Alle Kameras auflisten
CloudlessCamCLI.exe camera list
# Kamera per RTSP-URL hinzufuegen
CloudlessCamCLI.exe camera add --name "Eingang" --url "rtsp://192.168.178.27/stream1"
# Kameras per Netzwerk-Discovery suchen (interaktiv)
CloudlessCamCLI.exe camera add --name "Neue Kamera" --discover --interactive
# Systemuebersicht anzeigen
CloudlessCamCLI.exe status overview
# Kamerastatus als JSON exportieren
CloudlessCamCLI.exe status cameras --format json --output cameras.json
# Daemon starten
CloudlessCamCLI.exe daemon start
pause
4.6.2 Linux und MacOS
# Alle Kameras auflisten
./CloudlessCamCLI camera list
# Kamera per RTSP-URL hinzufuegen
./CloudlessCamCLI camera add --name "Garten" --url "rtsp://192.168.178.32/stream1"
# Aufnahmen eines Tages anzeigen
./CloudlessCamCLI recording list --date 2026-01-15 --format table
# Speicherstatus anzeigen
./CloudlessCamCLI status storage --show-usage
# Daemon im Hintergrund starten
./CloudlessCamCLI daemon start
4.7 Kommando-Referenz
4.7.1 camera – Kameraverwaltung
camera
camera list
--status --detailed
Option Beschreibung Standard
-f|--format table|json|csvtable
-v|--verbose
-s|--status
-d|--detailed
-g|--group-id
-o|--output
Beispiel 1: Einfache Auistung aller Kameras
CloudlessCamCLI camera list
+--------------------------------------+-------------+--------+--------------------------------+
| GUID | Name | Typ | URL |
+--------------------------------------+-------------+--------+--------------------------------+
| a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Eingang | ONVIF | rtsp://192.168.178.27/stream1 |
| b2c3d4e5-f6a7-8901-bcde-f23456789012 | Garten | RTSP | rtsp://192.168.178.32/live |
| c3d4e5f6-a7b8-9012-cdef-345678901234 | Wohnzimmer | ONVIF | rtsp://192.168.178.25/stream1 |
+--------------------------------------+-------------+--------+--------------------------------+
Beispiel 2: Kameras mit Verbindungsstatus anzeigen
CloudlessCamCLI camera list --status
+--------------------------------------+-------------+--------+----------+
| GUID | Name | Typ | Status |
+--------------------------------------+-------------+--------+----------+
| a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Eingang | ONVIF | Online |
| b2c3d4e5-f6a7-8901-bcde-f23456789012 | Garten | RTSP | Online |
| c3d4e5f6-a7b8-9012-cdef-345678901234 | Wohnzimmer | ONVIF | Offline |
+--------------------------------------+-------------+--------+----------+
Beispiel 3: Kameraliste als JSON exportieren
CloudlessCamCLI camera list --format json --output cameras.json
cameras.json
Beispiel 4: Detaillierte Informationen einer Gerätegruppe
CloudlessCamCLI camera list --group-id "außenbereich" --detailed --verbose
camera add
--url --discover
--name
Option Beschreibung Erforderlich
-n|--name
-u|--url --discover
-d|--discover --url
--username
--password
-t|--timeout
-i|--interactive
Beispiel 1: Kamera mit bekannter RTSP-URL hinzufügen
CloudlessCamCLI camera add --name "Eingang" --url "rtsp://192.168.178.27/stream1"
Kamera 'Eingang' erfolgreich hinzugefuegt.
GUID: a1b2c3d4-e5f6-7890-abcd-ef1234567890
Beispiel 2: Kamera mit Authentizierung hinzufügen
CloudlessCamCLI camera add --name "Garten" \
--url "rtsp://192.168.178.32/live" \
--username admin \
--password "MeinSicheresPasswort123"
CloudlessCamCLI camera add --name "Garten" \
--url "rtsp://admin:MeinPasswort@192.168.178.32/live"
Beispiel 3: Kamera per Netzwerk-Discovery suchen (interaktiv)
CloudlessCamCLI camera add --name "Neue Kamera" --discover --interactive
Suche nach Kameras im Netzwerk...
Gefundene Kameras:
[1] Hikvision DS-2CD2143G0-I (192.168.178.40)
[2] Reolink RLC-510A (192.168.178.41)
[3] Dahua IPC-HDW2431T-AS (192.168.178.42)
Waehlen Sie eine Kamera (1-3):
Beispiel 4: Netzwerk-Discovery mit erhöhtem Timeout
CloudlessCamCLI camera add --name "Werkstatt" --discover --timeout 60
camera modify
camera list
Option Beschreibung Erforderlich
<CAMERA-GUID>
-n|--name
-u|--username
-p|--password
--url
--force
Beispiel 1: Kameranamen ändern
CloudlessCamCLI camera modify a1b2c3d4-e5f6-7890-abcd-ef1234567890 --name "Haupteingang"
Kamera 'Eingang' wird geaendert:
Name: Eingang -> Haupteingang
Aenderung durchfuehren? [j/n]: j
Kamera erfolgreich aktualisiert.
Beispiel 2: Zugangsdaten aktualisieren
CloudlessCamCLI camera modify a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--username admin \
--password "NeuesPasswort456"
Beispiel 3: RTSP-URL ändern (ohne Bestätigung)
--force
CloudlessCamCLI camera modify a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--url "rtsp://192.168.178.27/stream2" \
--force
Beispiel 4: Mehrere Eigenschaften gleichzeitig ändern
CloudlessCamCLI camera modify a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--name "Eingang HD" \
--url "rtsp://192.168.178.27/stream1_hd" \
--username admin \
--password "secret123" \
--force
camera remove
Option Beschreibung Erforderlich
<CAMERA-GUID>
--force
--remove-recordings
Beispiel 1: Kamera mit Bestätigung entfernen
CloudlessCamCLI camera remove a1b2c3d4-e5f6-7890-abcd-ef1234567890
Kamera 'Eingang' wird entfernt.
WARNUNG: Diese Kamera hat 2 aktive Aufnahme-Konfigurationen.
Moechten Sie fortfahren? [j/n]: j
Kamera erfolgreich entfernt.
Beispiel 2: Kamera und Aufnahmen ohne Rückfrage entfernen
CloudlessCamCLI camera remove a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--force \
--remove-recordings
Kamera 'Eingang' entfernt.
2 Aufnahme-Konfigurationen entfernt.
Hinweis:
camera guess-credentials
Option Beschreibung Standard
--ip
--port 80
--timeout 10
-f|--format table|json|csvtable
-o|--output
Beispiel 1: Zugangsdaten einer Kamera ermitteln
CloudlessCamCLI camera guess-credentials --ip 192.168.178.27
+------------+----------+
| Username | Password |
+------------+----------+
| admin | admin |
+------------+----------+
Beispiel 2: Kamera mit benutzerdeniertem Port und Timeout
CloudlessCamCLI camera guess-credentials --ip 192.168.178.27 \
--port 8080 --timeout 5
Beispiel 3: Ergebnis als JSON ausgeben
CloudlessCamCLI camera guess-credentials --ip 192.168.178.27 \
--format json
{
"username": "admin",
"password": "admin"
}
4.7.2 status – Statusübersicht
status
status overview
Option Beschreibung Standard
-f|--format table|jsontable
-r|--refresh
-o|--output
Beispiel 1: Systemübersicht anzeigen
CloudlessCamCLI status overview
CloudlessCam Systemuebersicht
=============================
Daemon-Status: Laeuft (PID: 12345)
Laufzeit: 3 Tage, 14:23:45
Kameras: 4 konfiguriert
Online: 3
Offline: 1
Aufnahmen heute: 847 Dateien (12.4 GiB)
Aufnahmen gesamt: 28,943 Dateien (412.7 GiB)
Speicher:
NAS-Backup: 78% belegt (1.2 TiB / 1.5 TiB)
Lokal SSD: 45% belegt (225 GiB / 500 GiB)
Beispiel 2: Kontinuierliches Monitoring mit automatischer Aktualisierung
CloudlessCamCLI status overview --refresh 5
Strg+C
Beispiel 3: Status für Monitoring-System exportieren
CloudlessCamCLI status overview --format json --output /var/monitoring/cloudlescam.json
status cameras
Option Beschreibung Standard
-f|--format table|json|csvtable
-d|--detailed
-g|--group
-o|--output
--online-only
--offline-only
Beispiel 1: Kamerastatus mit Details anzeigen
CloudlessCamCLI status cameras --detailed
+--------------------------------------+-----------+--------+----------+------------+-----------+
| GUID | Name | Typ | Status | Aufloesung | Bitrate |
+--------------------------------------+-----------+--------+----------+------------+-----------+
| a1b2c3d4-e5f6-7890-abcd-ef1234567890 | Eingang | ONVIF | Online | 1920x1080 | 4096 kbps |
| b2c3d4e5-f6a7-8901-bcde-f23456789012 | Garten | RTSP | Online | 2560x1440 | 6144 kbps |
| c3d4e5f6-a7b8-9012-cdef-345678901234 | Wohnzimmer| ONVIF | Offline | -- | -- |
+--------------------------------------+-----------+--------+----------+------------+-----------+
Beispiel 2: Nur oine-Kameras für Alerting
CloudlessCamCLI status cameras --offline-only --format json
Beispiel 3: Kamerastatus als CSV für Reporting
CloudlessCamCLI status cameras --format csv --output kamerastatus.csv
--online-only --offline-only
status storage
Option Beschreibung Standard
-f|--format table|json|csvtable
--show-usage
--show-recordings
--type filesystem|webdav|sftp|ftp
-o|--output
Beispiel 1: Speicherstatus mit Nutzungsdetails
CloudlessCamCLI status storage --show-usage
+--------------------------------------+------------+------------+----------+-----------+---------+
| GUID | Name | Typ | Status | Belegt | Frei |
+--------------------------------------+------------+------------+----------+-----------+---------+
| d4e5f6a7-b8c9-0123-def4-567890123456 | NAS-Backup | webdav | Aktiv | 1.2 TiB | 300 GiB |
| e5f6a7b8-c9d0-1234-ef56-789012345678 | Lokal SSD | filesystem | Aktiv | 225 GiB | 275 GiB |
| f6a7b8c9-d0e1-2345-f678-901234567890 | SFTP Cloud | sftp | Inaktiv | -- | -- |
+--------------------------------------+------------+------------+----------+-----------+---------+
Beispiel 2: Speicher mit Aufnahme-Anzahl
CloudlessCamCLI status storage --show-usage --show-recordings
Beispiel 3: Nur WebDAV-Speicher anzeigen
CloudlessCamCLI status storage --type webdav --format json
4.7.3 recording – Aufnahmen verwalten
recording
recording list
Option Beschreibung Standard
-f|--format table|json|csvtable
-c|--camera
-d|--date YYYY-MM-DD
-l|--limit
-t|--type video|audio|image
-o|--output
Beispiel 1: Alle Aufnahmen der letzten Aktivitäten
CloudlessCamCLI recording list
+--------------------------------------------+-------------+------------+----------+----------+
| Dateiname | Kamera | Datum | Typ | Groesse |
+--------------------------------------------+-------------+------------+----------+----------+
| Eingang_2026-01-31_14-30-00.mp4 | Eingang | 2026-01-31 | video | 245 MiB |
| Eingang_2026-01-31_14-00-00.mp4 | Eingang | 2026-01-31 | video | 238 MiB |
| Garten_2026-01-31_13-30-00.mp4 | Garten | 2026-01-31 | video | 312 MiB |
| Eingang_2026-01-31_13-15-22.jpg | Eingang | 2026-01-31 | image | 2.1 MiB |
+--------------------------------------------+-------------+------------+----------+----------+
Zeige 4 von 847 Aufnahmen (verwenden Sie --limit fuer mehr)
Beispiel 2: Aufnahmen einer Kamera an einem bestimmten Tag
CloudlessCamCLI recording list \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--date 2026-01-15 \
--limit 200
Beispiel 3: Nur Schnappschüsse als JSON exportieren
CloudlessCamCLI recording list --type image --format json --output snapshots.json
Beispiel 4: Alle Videoaufnahmen des heutigen Tages
CloudlessCamCLI recording list --type video --date 2026-01-31 --limit 500
recording timeline
Option Beschreibung Standard
<camera-id>
-d|--date YYYY-MM-DD
--hours
--interval
--show-gaps
-f|--format table|json|csvtable
-o|--output
Beispiel 1: Timeline für den heutigen Tag
CloudlessCamCLI recording timeline a1b2c3d4-e5f6-7890-abcd-ef1234567890
Timeline fuer Kamera 'Eingang' am 2026-01-31
============================================
00:00 [################] 100%
01:00 [################] 100%
02:00 [################] 100%
...
12:00 [########--------] 50% <-- Luecke erkannt
13:00 [################] 100%
14:00 [############----] 75%
Beispiel 2: Detaillierte Timeline mit 15-Minuten-Intervall
CloudlessCamCLI recording timeline a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--date 2026-01-15 \
--interval 15 \
--show-gaps
Beispiel 3: Nur die letzten 6 Stunden anzeigen
CloudlessCamCLI recording timeline a1b2c3d4-e5f6-7890-abcd-ef1234567890 --hours 6
recording calendar
Option Beschreibung Standard
<camera-id>
-m|--month YYYY-MM
--show-counts
-f|--format table|json|csvtable
-o|--output
Beispiel 1: Kalender für den aktuellen Monat
CloudlessCamCLI recording calendar a1b2c3d4-e5f6-7890-abcd-ef1234567890
Aufnahmekalender fuer 'Eingang' - Januar 2026
=============================================
Mo Di Mi Do Fr Sa So
1* 2* 3* 4* 5*
6* 7* 8* 9* 10* 11* 12*
13* 14* 15* 16* 17* 18* 19*
20* 21* 22* 23* 24* 25* 26*
27* 28* 29* 30* 31
* = Aufnahmen vorhanden
Beispiel 2: Kalender mit Aufnahme-Anzahl pro Tag
CloudlessCamCLI recording calendar a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--month 2026-01 \
--show-counts
recording export
Option Beschreibung Standard
<recording-filename>
-o|--output
-f|--format mp4|avi|mkvmp4
-q|--quality high|medium|low|verylowmedium
--start HH:MM:SS
--duration
--overwrite
high
medium
low
verylow
Beispiel 1: Einfacher Export in MP4
CloudlessCamCLI recording export Eingang_2026-01-15_12-00-00.mp4 \
--output /home/user/export/eingang_export.mp4
Beispiel 2: Ausschnitt exportieren (60 Sekunden ab Minute 5)
CloudlessCamCLI recording export Eingang_2026-01-15_12-00-00.mp4 \
--output clip.mp4 \
--start 00:05:00 \
--duration 60
Beispiel 3: Export in AVI mit hoher Qualität
CloudlessCamCLI recording export video.mp4 \
--output video.avi \
--format avi \
--quality high \
--overwrite
4.7.4 recording-config – Aufnahme-Kongurationen verwalten
recording-config
recording-config list
Option Beschreibung Standard
-c|--camera
--enabled-only
-v|--verbose
-f|--format table|json|csvtable
-o|--output
Beispiel 1: Alle Aufnahme-Kongurationen anzeigen
CloudlessCamCLI recording-config list
+--------------------------------------+----------------+-----------+--------+---------+---------+
| GUID | Name | Kamera | Typ | Status | Qualität|
+--------------------------------------+----------------+-----------+--------+---------+---------+
| d1e2f3a4-b5c6-7890-def1-234567890123 | Hauptaufnahme | Eingang | video | Aktiv | high |
| e2f3a4b5-c6d7-8901-ef23-456789012345 | Schnappschuesse| Eingang | image | Aktiv | medium |
| f3a4b5c6-d7e8-9012-f345-678901234567 | Garten Video | Garten | video | Inaktiv | medium |
+--------------------------------------+----------------+-----------+--------+---------+---------+
Beispiel 2: Nur aktive Kongurationen einer Kamera
CloudlessCamCLI recording-config list \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--enabled-only \
--verbose
recording-config create
Option Beschreibung Erforderlich
-c|--camera
-n|--name
-t|--type video|image|audiovideo
-s|--stream
--enable
--quality high|medium|low|verylowmedium
Beispiel 1: Video-Aufnahme erstellen und aktivieren
CloudlessCamCLI recording-config create \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--name "Hauptaufnahme" \
--type video \
--quality high \
--enable
Aufnahme-Konfiguration 'Hauptaufnahme' erstellt.
GUID: d1e2f3a4-b5c6-7890-def1-234567890123
Status: Aktiviert
Beispiel 2: Schnappschuss-Konguration erstellen
CloudlessCamCLI recording-config create \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--name "Schnappschuesse alle 5 Minuten" \
--type image \
--enable
Beispiel 3: Aufnahme mit spezischem Stream
CloudlessCamCLI recording-config create \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--name "Substream Aufnahme" \
--stream "substream" \
--quality low
recording-config modify
Option Beschreibung Erforderlich
<GUID>
-n|--name
--enable
--disable
-t|--type video|image|audio
-q|--quality
--force
--enable --disable
Beispiel 1: Konguration aktivieren
CloudlessCamCLI recording-config modify d1e2f3a4-b5c6-7890-def1-234567890123 --enable
Beispiel 2: Qualität erhöhen und umbenennen
CloudlessCamCLI recording-config modify d1e2f3a4-b5c6-7890-def1-234567890123 \
--name "Hauptaufnahme HD" \
--quality high \
--force
Beispiel 3: Aufnahme temporär deaktivieren
CloudlessCamCLI recording-config modify d1e2f3a4-b5c6-7890-def1-234567890123 --disable
recording-config remove
Option Beschreibung Erforderlich
<GUID>
--force
Beispiel: Konguration ohne Rückfrage entfernen
CloudlessCamCLI recording-config remove d1e2f3a4-b5c6-7890-def1-234567890123 --force
4.7.5 storage – Speicherverwaltung
storage
storage list
Option Beschreibung Standard
-f|--format table|json|csvtable
-t|--type filesystem|webdav|sftp|ftp
--enabled-only
-v|--verbose
-o|--output
Beispiel 1: Alle Speicher anzeigen
CloudlessCamCLI storage list
+--------------------------------------+----------------+------------+---------+
| GUID | Name | Typ | Status |
+--------------------------------------+----------------+------------+---------+
| d4e5f6a7-b8c9-0123-def4-567890123456 | NAS-Backup | webdav | Aktiv |
| e5f6a7b8-c9d0-1234-ef56-789012345678 | Lokal SSD | filesystem | Aktiv |
| f6a7b8c9-d0e1-2345-f678-901234567890 | SFTP Cloud | sftp | Inaktiv |
+--------------------------------------+----------------+------------+---------+
Beispiel 2: Nur WebDAV-Speicher mit Details
CloudlessCamCLI storage list --type webdav --verbose
storage add
Option Beschreibung Erforderlich
-n|--name
-t|--type filesystem|webdav|sftp|ftp
-p|--path
-h|--host
--port
-u|--username
--password
--enable
--test-connection true
Beispiel 1: Lokales Verzeichnis als Speicher
CloudlessCamCLI storage add \
--name "Lokaler Speicher" \
--type filesystem \
--path "/mnt/recordings" \
--enable
CloudlessCamCLI storage add --name "Lokale SSD" --type filesystem --path "D:\Recordings" --enable
Beispiel 2: WebDAV-Speicher (Nextcloud)
CloudlessCamCLI storage add \
--name "Nextcloud Aufnahmen" \
--type webdav \
--host "nextcloud.example.com" \
--path "/remote.php/dav/files/admin/Recordings" \
--username admin \
--password "GeheimesPasswort123" \
--enable
Beispiel 3: SFTP-Server
CloudlessCamCLI storage add \
--name "Backup Server" \
--type sftp \
--host backup.example.com \
--port 22 \
--path "/home/cloudlescam/recordings" \
--username cloudlescam \
--password "sshpassword"
Beispiel 4: FTP-Server mit nicht-standardmäßigem Port
CloudlessCamCLI storage add \
--name "FTP Archiv" \
--type ftp \
--host ftp.example.com \
--port 2121 \
--path "/videos/security" \
--username ftpuser \
--password "ftppassword" \
--enable
storage modify
Option Beschreibung Erforderlich
<GUID>
-n|--name
-p|--path
-h|--host
--port
-u|--username
--password
--enable
--disable
--force
Beispiel 1: Speicher umbenennen
CloudlessCamCLI storage modify d4e5f6a7-b8c9-0123-def4-567890123456 \
--name "NAS Hauptspeicher"
Beispiel 2: Zugangsdaten aktualisieren
CloudlessCamCLI storage modify d4e5f6a7-b8c9-0123-def4-567890123456 \
--username neuerbenutzer \
--password "neuesPasswort" \
--force
Beispiel 3: Speicher aktivieren und Pfad ändern
CloudlessCamCLI storage modify f6a7b8c9-d0e1-2345-f678-901234567890 \
--path "/neuer/speicher/pfad" \
--enable
storage remove
Option Beschreibung Erforderlich
<GUID>
--force
--remove-from-recordings
Beispiel 1: Speicher mit Bestätigung entfernen
CloudlessCamCLI storage remove d4e5f6a7-b8c9-0123-def4-567890123456
Speicher 'NAS-Backup' wird entfernt.
WARNUNG: Dieser Speicher wird von 3 Aufnahme-Konfigurationen verwendet.
Moechten Sie fortfahren? [j/n]:
Beispiel 2: Vollständige Entfernung ohne Rückfrage
CloudlessCamCLI storage remove d4e5f6a7-b8c9-0123-def4-567890123456 \
--force \
--remove-from-recordings
Hinweis:
4.7.6 settings – Einstellungsverwaltung
settings
settings list
Option Beschreibung Standard
-c|--category ui|network|recording|system|allall
-k|--key
-v|--verbose
-f|--format table|json|csvtable
-o|--output
Beispiel 1: Alle Einstellungen anzeigen
CloudlessCamCLI settings list
+----------------+------------------+----------------------+
| Kategorie | Schluessel | Wert |
+----------------+------------------+----------------------+
| Core | Debug | false |
| Core | LogLevel | Warning |
| UI | ThemeMode | Dark |
| UI | Language | de-DE |
| Network | Timeout | 30 |
| Recording | DefaultQuality | medium |
+----------------+------------------+----------------------+
Beispiel 2: Nur UI-Einstellungen anzeigen
CloudlessCamCLI settings list --category ui --verbose
Beispiel 3: Einzelne Einstellung abfragen
CloudlessCamCLI settings list --key Core.Debug
Beispiel 4: Einstellungen als JSON exportieren
CloudlessCamCLI settings list --format json --output settings.json
settings set
Einzelne Einstellung
Batch-Modus
Aus Datei
Option Beschreibung Standard
<key> Section.Key
<value>
-s|--section General
-b|--batch key=value
-f|--from-file
--merge
--validate
--confirm
Beispiel 1: Einzelne Einstellung ändern
CloudlessCamCLI settings set Core.Debug true
Einstellung geaendert:
Core.Debug: false -> true
Beispiel 2: Design-eme ändern
CloudlessCamCLI settings set UI.ThemeMode Dark
Beispiel 3: Mehrere Einstellungen im Batch-Modus
CloudlessCamCLI settings set --batch \
"Core.Debug=false" \
"UI.ThemeMode=Dark" \
"Network.Timeout=60"
Beispiel 4: Einstellungen aus Backup-Datei importieren
CloudlessCamCLI settings set --from-file backup_settings.ini --merge
--merge
settings backup
settings restore
Option Beschreibung Erforderlich
-o|--output
--compress
Beispiel 1: Einfaches Backup
CloudlessCamCLI settings backup --output settings_backup.ini
Einstellungen gesichert nach: settings_backup.ini
Anzahl Einstellungen: 47
Dateigroesse: 2.3 KiB
Beispiel 2: Komprimiertes Backup mit Datum
CloudlessCamCLI settings backup --output "C:\Backup\CloudlessCam\settings_2026-01-31.ini" --compress
settings restore
Option Beschreibung Erforderlich
<backup-file>
--force
Beispiel 1: Einstellungen mit Bestätigung wiederherstellen
CloudlessCamCLI settings restore settings_backup.ini
Einstellungen werden aus 'settings_backup.ini' wiederhergestellt.
WARNUNG: Alle aktuellen Einstellungen werden ueberschrieben.
Moechten Sie fortfahren? [j/n]: j
47 Einstellungen wiederhergestellt.
Bitte starten Sie den Daemon neu, damit die Aenderungen wirksam werden.
Beispiel 2: Wiederherstellung ohne Rückfrage (für Skripte)
CloudlessCamCLI settings restore settings_backup.ini --force
CloudlessCamCLI daemon restart
4.7.7 license – Lizenzverwaltung
license
Kostenlose Lizenz
FREE
license list FREE
license status
Beispiel:
CloudlessCamCLI license status
Lizenzstatus
============
Lizenzen: 2 aktiv
Kamera-Slots: 8 / 11 verwendet
Lizenztyp: Standard
Ablaufdatum: Unbegrenzt
Aktive Lizenzen:
XXXX-XXXX-XXXX-XXXX-1 5 Kameras Aktiviert am: 2025-06-15
XXXX-XXXX-XXXX-XXXX-1 5 Kameras Aktiviert am: 2025-12-01
license list
FREE
Option Beschreibung Standard
-f|--format table|json|csvtable
-o|--output
Beispiel:
CloudlessCamCLI license list
license activate
Option Beschreibung Erforderlich
-k|--key XXXX-XXXX-XXXX-XXXX-N
Beispiel:
CloudlessCamCLI license activate --key XXXX-XXXX-XXXX-XXXX-1
Lizenz wird aktiviert...
Verbindung zum Lizenzserver hergestellt.
Lizenz erfolgreich aktiviert!
Typ: Standard
Kameras: 5
Gültig bis: Unbegrenzt
license usage
Option Beschreibung Standard
-f|--format table|json|csvtable
-o|--output
--license
--local
Beispiel:
CloudlessCamCLI license usage
Lizenznutzung
=============
+------------------+-------------+------------------+
| Computer | Kameras | Letzte Aktivität |
+------------------+-------------+------------------+
| Büro Server | 4 | 2026-01-31 14:30 |
| Home System | 2 | 2026-01-31 10:15 |
| Außenstelle | 2 | 2026-01-30 23:45 |
+------------------+-------------+------------------+
Gesamt: 8 / 11 Kameras verwendet
license set-computer-name
Option Beschreibung Erforderlich
-n|--name
Beispiel:
CloudlessCamCLI license set-computer-name --name "Büro Server"
Oine-Aktivierung
Schritt 1:
CloudlessCamCLI license offline-request \
--output CloudlessCam.prelicensed \
--computer-name "Produktionsserver"
CloudlessCam.prelicensed
Schritt 2:
CloudlessCamCLI license offline-generate \
--key XXXX-XXXX-XXXX-XXXX-1 \
--request CloudlessCam.prelicensed \
--output CloudlessCam.fulllicensed
Verbindung zum Lizenzserver hergestellt.
Aktivierungsdatei erfolgreich generiert: CloudlessCam.fulllicensed
Bitte übertragen Sie diese Datei auf das Offline-System.
Schritt 3:
CloudlessCamCLI license offline-import --file CloudlessCam.fulllicensed
Lizenz erfolgreich importiert!
Typ: Standard
Kameras: 5
Computer: Produktionsserver
Befehl Beschreibung
license offline-request
license offline-generate
license offline-import
4.7.8 ptz – PTZ-Steuerung
ptz
ptz control
Option Beschreibung Standard
<action> movehomepresetcapabilitiestest-capabilitiessettings
-c|--camera
-d|--direction left|right|up|down|up-left|up-right|down-left|down-right|zoom-in|zoom-out|stop
-s|--speed
-p|--preset
-f|--format table|json|csv capabilitiespresettest-capabilities settings table
--backend SharpOnvif|OnvifCore|MictlanixOnvif|QuickNVOnvif|XiaoFengOnvif
--invert-horizontal --no-invert-horizontal
--invert-vertical --no-invert-vertical
--movement-scaling
--enable-diagonal-emulation --disable-diagonal-emulation
--max-diagonal-moves
--command-emulation-mode standard|step-via-continuous|continuous-via-step
capabilities
test-capabilities
settings
move
home
preset --preset --preset
Beispiel 1: PTZ-Fähigkeiten abfragen
CloudlessCamCLI ptz control capabilities --camera a1b2c3d4-e5f6-7890-abcd-ef1234567890
PTZ Capabilities - Eingang
==========================
Capability Supported Details
PTZ Yes Available
Pan Yes Available
Tilt Yes Available
Zoom Yes Available
Presets Yes 8 available
Beispiel 2: PTZ-Fähigkeitstests über alle PTZ-Backends ausführen
CloudlessCamCLI ptz control test-capabilities \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890
Cont
ContDiagRelRelDiagAbsAbsDiagZoomNightVision TestedAtUtc
PTZ Capability Test Matrix - Eingang
====================================
PTZ-Backend Cont ContDiag Rel RelDiag Abs AbsDiag Zoom NightVision TestedAtUtc
SharpOnvif Yes Yes Yes Yes Yes No Yes No 2026-03-05T11:33:10.421Z
OnvifCore Yes No Yes No No No Yes No 2026-03-05T11:34:02.904Z
N/A
Beispiel 3: Kamera nach links bewegen
CloudlessCamCLI ptz control move \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--direction left \
--speed 30
CloudlessCamCLI ptz control move \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--direction stop
Beispiel 4: Kamera ein Stück heranzoomen
CloudlessCamCLI ptz control move \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--direction zoom-in \
--speed 60
Beispiel 5: Zur Ausgangsposition fahren
CloudlessCamCLI ptz control home --camera a1b2c3d4-e5f6-7890-abcd-ef1234567890
Beispiel 6: Presets auisten
CloudlessCamCLI ptz control preset --camera a1b2c3d4-e5f6-7890-abcd-ef1234567890
+--------+------------------+
| Token | Name |
+--------+------------------+
| 1 | Eingang |
| 2 | Parkplatz |
| 3 | Garage |
+--------+------------------+
Beispiel 7: Zu einem Preset fahren
CloudlessCamCLI ptz control preset \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--preset "Parkplatz"
Beispiel 8: PTZ-Fähigkeitstests als JSON für Skripte
CloudlessCamCLI ptz control test-capabilities \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--format json
supports_continuoussupports_continuous_diagonal
supports_relativesupports_relative_diagonalsupports_absolutesupports_absolute_diagonal
supports_zoom supports_night_vision
Beispiel 9: Aktuelle PTZ-Zusatzoptionen anzeigen
CloudlessCamCLI ptz control settings \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890
Beispiel 10: PTZ-Zusatzoptionen setzen
CloudlessCamCLI ptz control settings \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--backend OnvifCore \
--invert-horizontal \
--movement-scaling 0.01 \
--enable-diagonal-emulation \
--max-diagonal-moves 8 \
--command-emulation-mode step-via-continuous
4.7.9 image – Bildeinstellungen
image
image settings
Option Beschreibung Standard
<action> list set
-c|--camera
-b|--brightness
--contrast
--saturation
--hue
--watermark-path
--watermark-size
--watermark-x
--watermark-y
--watermark-opacity
-f|--format table|json|csvtable
-o|--output
Helligkeit
Kontrast
Sättigung
Farbton
Wasserzeichen
Beispiel 1: Bildeinstellungen aller Kameras anzeigen
CloudlessCamCLI image settings list
+-----------+------------+----------+------------+------+
| Kamera | Helligkeit | Kontrast | Saettigung | Hue |
+-----------+------------+----------+------------+------+
| Eingang | 0 | 0 | 0 | 0 |
| Garten | 10 | 5 | 0 | 0 |
| Wohnzimmer| -5 | 0 | -10 | 0 |
+-----------+------------+----------+------------+------+
Beispiel 2: Helligkeit einer Kamera erhöhen
CloudlessCamCLI image settings set \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--brightness 15
Beispiel 3: Mehrere Bildeinstellungen gleichzeitig anpassen
CloudlessCamCLI image settings set \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--brightness 10 \
--contrast 5 \
--saturation -5
Beispiel 4: Wasserzeichen hinzufügen
CloudlessCamCLI image settings set \
--camera a1b2c3d4-e5f6-7890-abcd-ef1234567890 \
--watermark-path /pfad/zum/logo.png \
--watermark-size 50 \
--watermark-x 90 \
--watermark-y 10 \
--watermark-opacity 70
4.7.10 update – Aktualisierungen
update
update check
Option Beschreibung Standard
--format table|jsontable
--output
--check-pre-release
--channel release|test
--silent
Beispiel 1: Nach Updates suchen
CloudlessCamCLI update check
Update verfuegbar!
Aktuelle Version: 2026.01.15.1200
Neue Version: 2026.01.31.0800
Aenderungen: https://cloudlescam.de/changelog
Zum Installieren: CloudlessCamCLI update install
Beispiel 2: Stille Prüfung für Skripte
CloudlessCamCLI update check --silent
--silent
Beispiel 3: Testversionen prüfen
CloudlessCamCLI update check --check-pre-release --channel test
update install
Option Beschreibung Standard
--version
--pre-release
--channel release|test
--force
--download-only
Beispiel 1: Neuestes Update installieren
CloudlessCamCLI update install
Update wird heruntergeladen...
Version: 2026.01.31.0800
Größe: 45.2 MiB
[####################] 100%
Update-Installationsprogramm wurde gestartet.
Bitte bestätigen Sie gegebenenfalls die Administratorabfrage und warten Sie,
bis das Update-Installationsprogramm den Abschluss meldet.
Beispiel 2: Bestimmte Version installieren
CloudlessCamCLI update install --version 2026.01.15.1200
Beispiel 3: Update nur herunterladen (für spätere Installation)
CloudlessCamCLI update install --download-only
update channel show
Beispiel:
CloudlessCamCLI update channel show
Aktueller Update-Kanal: release
update channel set
Option Beschreibung Erforderlich
<channel> release test
release
test
Beispiel: Auf Testkanal wechseln
CloudlessCamCLI update channel set test
Update-Kanal geaendert: release -> test
WARNUNG: Der Testkanal kann instabile Versionen enthalten.
4.7.11 maintenance – Wartung
maintenance
maintenance clean
Beispiel:
CloudlessCamCLI maintenance clean
Bereinigung wird durchgefuehrt...
Temporaere Dateien: 23 Dateien entfernt (145 MiB)
Cache-Daten: 12 Dateien entfernt (34 MiB)
Verwaiste Dateien: 3 Dateien entfernt (8 MiB)
Insgesamt freigegeben: 187 MiB
Hinweis:
CloudlessCamCLI daemon stop
CloudlessCamCLI maintenance clean
CloudlessCamCLI daemon start
4.7.12 daemon – Hintergrunddienst
daemon
Option Beschreibung Standard
<action> start|stop|restart|status|logs
-c|--config
start
stop
restart
status
logs
Beispiel 1: Daemon starten
CloudlessCamCLI daemon start
Daemon wird gestartet...
Daemon erfolgreich gestartet (PID: 12345)
Beispiel 2: Daemon-Status prüfen
CloudlessCamCLI daemon status
Daemon-Status: Laeuft
PID: 12345
Laufzeit: 3 Tage, 14:23:45
Speicher: 245 MiB
Kameras: 4 aktiv
Aufnahmen: 3 aktive Streams
Daemon-Status: Gestoppt
Beispiel 3: Logs anzeigen
CloudlessCamCLI daemon logs
[2026-01-31 14:30:00] INFO Aufnahme gestartet: Eingang
[2026-01-31 14:30:01] INFO Aufnahme gestartet: Garten
[2026-01-31 14:30:15] WARN Kamera 'Wohnzimmer' nicht erreichbar
[2026-01-31 14:30:45] INFO Verbindung zu 'Wohnzimmer' wiederhergestellt
[2026-01-31 15:00:00] INFO Aufnahme geschlossen: Eingang_2026-01-31_14-30-00.mp4
Beispiel 4: Daemon neu starten nach Kongurationsänderungen
CloudlessCamCLI daemon restart
Beispiel 5: Daemon mit alternativer Konguration starten
CloudlessCamCLI daemon start --config /etc/cloudlescam/production.json
Hinweis:
CloudlessCam Player Cloudless-
Cam Web Player
5.1 Überblick
5.1.1 CloudlessCam Player (Desktop)
Wiedergabe am Arbeitsplatz:
Schnelle Prüfung von Archiven:
Export und Weitergabe:
Kontroll-Client für entfernte Speicher:
5.1.2 CloudlessCam Web Player (Webserver)
Heimnetzwerk:
Leitstand oder Kiosk-Modus:
Fernzugri im LAN oder VPN:
5.1.3 Zielgruppe
5.2 CloudlessCam Player (Desktop)
5.2.1 Konguration und Datenräume
Kongurationsdatei:
Dateiname: Player.CloudlessCam.json Default.CloudlessCam.
json
Speicherort:
%appdata%\CloudlessCam\
Backups: Player_
5.2.2 Ziel-Speicher und Synchronisation
Synchronisation:
Metadaten laden:
Neue Dateien erkennen:
Deduplizierung:
Index aktualisieren:
Anmerkungen:
5.2.3 Wiedergabe und Timeline
Auswahlmodell:
Tag auswählen:
Zeitsegment wählen:
Aufnahmen navigieren:
Export-Möglichkeiten:
5.2.4 Verschlüsselung
Passwort-Eingabe:
Unterstützte Verschlüsselungsformate:
.encrypted7z.7z:
Entschlüsselung:
7z x -p<PASSWORT> <DATEI.encrypted7z.7z>
Fehlerfälle:
Falsches Passwort:
Teilweise verschlüsselte Datenbestände:
5.2.5 Bedienung
Navigation und Aktionsbereiche
Tabs in der Seitenleiste:
Ziel-Speicher (Storages):
Einstellungen (Settings):
Aktionsleiste auf der Storages-Seite:
Speicher hinzufügen:
Speicher aktualisieren:
Import aus CloudlessCam-Datei:
Aktualisierung auf der Player-Seite:
Aktualisierungsfeld über dem Videobereich:
Titelleiste:
Design umschalten:
Sprache ändern:
Ziel-Speicher verwalten
Angezeigte Informationen:
Name:
Gerätename:
Aktiviert-Status:
Verfügbare Aktionen:
Aktualisieren:
Name ändern:
Bearbeiten:
Entfernen:
Aktivieren/Deaktivieren:
Aufnahmen ansehen und exportieren
Datum auswählen:
Timeline:
Videoplayer:
Wiedergabe/Pause:
Zeitleiste:
Geschwindigkeit:
Lautstärke:
Zeitanzeige:
Export:
Aktuelle Aufnahme exportieren:
Zeitbereich exportieren:
Einstellungen
Benutzeroberäche:
UI-Skalierung:
Automatische Speicher-Aktualisierung:
Kongurationspasswort:
Passwort setzen:
Passwort entfernen:
Backup-Verwaltung:
Backup-Liste:
Backup laden:
Desktop-Verknüpfung:
5.2.6 Import aus CloudlessCam
Vorgehensweise:
Default.
CloudlessCam.json
Was wird importiert:
Was wird nicht importiert:
Duplikat-Erkennung:
Sicherheitshinweis:
5.2.7 Fehlerbehebung (Desktop)
Keine Aufnahmen sichtbar
Ziel-Speicher aktiviert:
Aktualisierung durchgeführt:
Korrekter Pfad:
Berechtigungen:
Verschlüsselung:
Wiedergabe schlägt fehl
Beschädigte Datei:
Netzwerk-Timeout:
Verschlüsselungspasswort:
%appdata%\CloudlessCam\CloudlessCam.log.
xml
5.3 CloudlessCam Web Player (Webserver)
Player.CloudlessCam.
json
5.3.1 Sicherheit
Authentizierung
CloudlessCamWebPlayer.appsettings.json
WebPlayer:Authentication:Mode
HttpOnlySecure SameSite=Strict
HTTPS-Verschlüsselung
CloudlessCamWebPlayer.pfx
Stream-Token
Empfehlungen für den Netzwerkbetrieb
Nicht ungeschützt ins Internet freigeben:
Firewall-Regeln:
Reverse Proxy:
Protokollierung
5.3.2 Start, Port und Zugri
Starten des Web Players
CloudlessCamWebPlayerServer.exe
https://localhost:7141
https://0.0.0.0:7141
https://192.168.
178.100:7141
Firewall-Konguration
Windows:
Linux: ufw iptables
sudo ufw allow 7141/tcp
macOS:
pfctl
Betrieb als Dienst
Windows: Web_Player_TaskScheduler_
Install.ps1
powershell -ExecutionPolicy Bypass -File .\Web_Player_TaskScheduler_Install.ps1
powershell -ExecutionPolicy Bypass -File .\Web_Player_TaskScheduler_Deinstall.ps1
Linux:
macOS:
5.3.3 Konguration
CloudlessCamWebPlayer.
appsettings.json
Speicherort der Kongurationsdatei
Betriebssystem Pfad
%APPDATA%\CloudlessCam\CloudlessCamWebPlayer.appsettings.json
~/.config/CloudlessCam/CloudlessCamWebPlayer.appsettings.json
~/Library/Application Support/CloudlessCam/CloudlessCamWebPlayer.appsettings.json
Hosting-Einstellungen
WebPlayer:Hosting
ListenUrls:
https://localhost:7141;https://0.0.0.0:7141
CerticatePath:
CerticatePassword:
Umgebungsvariable Entsprechende Einstellung
CLOUDLESSCAM_WEBPLAYER_LISTEN_URLS
CLOUDLESSCAM_WEBPLAYER_CERTIFICATE_PATH
CLOUDLESSCAM_WEBPLAYER_CERTIFICATE_PASSWORD
Authentizierung
WebPlayer:Authentication
Mode: Password
OAuth
PasswordHash:
Password:
Password
SessionLifetime:
RememberCookieLifetime:
StreamTokenLifetime:
OAuth WebPlayer:Authentication:OAuth
Authority MetadataAddress:
ClientId:
ClientSecret:
DisplayName:
CallbackPath:
/signin-oidc
RequireHttpsMetadata:
Scopes: openidprofile
email
Umgebungsvariable Entsprechende Einstellung
CLOUDLESSCAM_WEBPLAYER_AUTH_MODE
CLOUDLESSCAM_WEBPLAYER_PASSWORD
CLOUDLESSCAM_WEBPLAYER_PASSWORD_HASH
CLOUDLESSCAM_WEBPLAYER_SESSION_LIFETIME
CLOUDLESSCAM_WEBPLAYER_REMEMBER_COOKIE_LIFETIME
CLOUDLESSCAM_WEBPLAYER_STREAM_TOKEN_LIFETIME
CLOUDLESSCAM_WEBPLAYER_OAUTH_AUTHORITY
CLOUDLESSCAM_WEBPLAYER_OAUTH_METADATA_ADDRESS
CLOUDLESSCAM_WEBPLAYER_OAUTH_CLIENT_ID
CLOUDLESSCAM_WEBPLAYER_OAUTH_CLIENT_SECRET
CLOUDLESSCAM_WEBPLAYER_OAUTH_DISPLAY_NAME
CLOUDLESSCAM_WEBPLAYER_OAUTH_SCOPES
Wichtig: ChangeThisPasswordNow
Player-Konguration
Player.CloudlessCam.json
WebPlayer:ConfigurationPassword
CLOUDLESSCAM_PLAYER_CONFIG_PASSWORD
Beispielkonguration
{
"WebPlayer": {
"Hosting": {
"ListenUrls":"https://0.0.0.0:7141",
"CertificatePath":"CloudlessCamWebPlayer.pfx",
"CertificatePassword":""
},
"Authentication": {
"Mode":"Password",
"Password":"IhrSicheresPasswort",
"SessionLifetime":"08:00:00"
}
}
}
Beispielkonguration für OAuth
{
"WebPlayer": {
"Authentication": {
"Mode":"OAuth",
"OAuth": {
"Authority":"https://login.example.com/realms/cloudlesscam",
"ClientId":"cloudlesscam-webplayer",
"ClientSecret":"IhrClientSecret",
"DisplayName":"Firmenkonto"
}
}
}
}
5.3.4 Login und Oberäche
Anmeldung
Password
OAuth
WebPlayer:Authentication:SessionLifetime
CLOUDLESSCAM_WEBPLAYER_SESSION_LIFETIME
WebPlayer:Authentication:RememberCookieLifetime
CLOUDLESSCAM_WEBPLAYER_REMEMBER_COOKIE_LIFETIME
Hauptoberäche
Player (/player):
Storages (/storages):
Settings (/settings):
Aktualisierung (Refresh)
/storages
/player
/settings
Suchen und Filtern
Ziel-Speicher:
Datum:
Medientyp:
Textsuche:
5.3.5 Ziel-Speicher verwalten
Speicher-Übersicht
Speicher hinzufügen
Cloud-Dienste:
Klassische Backend-Typen:
5.3.6 Konguration importieren
Import-Vorgang
.CloudlessCam.json
Importierte Inhalte
Duplikate werden übersprungen:
Neue Speicher werden hinzugefügt:
5.3.7 Wiedergabe und Formate
Wiedergabe-Quellen
Unterstützte Formate
Video-Formate:
Audio-Formate:
Automatische Format-Konvertierung
Temp/WebPlayer/Transcoded
MaximumTempDirectorySize
Range-Streaming
Download-Option
5.3.8 Fehlerbehebung (Webserver)
Browser zeigt Zertikatswarnung
Ursache:
Lösung:
Anmeldung funktioniert nicht
Mögliche Ursachen:
AuthorityMetadataAddress ClientId
Lösung: WebPlayer:Authentication:Password
PasswordHash WebPlayer:Authentication:OAuth
Keine Aufnahmen sichtbar
Mögliche Ursachen:
Player.CloudlessCam.json
Lösung:
Wiedergabe ruckelt oder ist langsam
Mögliche Ursachen:
Lösung:
Zugri von anderen Geräten nicht möglich
Mögliche Ursachen:
localhost
Lösung: ListenUrls 0.0.0.0
5.4 Support kontaktieren
%appdata%\CloudlessCam\CloudlessCam.log.xml
6.1 Überblick
6.1.1 Zweck
Automatisierung:
Integration in Fremdsysteme:
Remote-Administration:
Headless-Betrieb:
6.1.2 Abgrenzung zu anderen CloudlessCam-Programmen
Programm Schwerpunkt
CloudlessCam
CloudlessCamCLI
CloudlessCam Web Player
CloudlessCam API Server
6.1.3 Arbeitsweise
Configuration.CloudlessCam
6.2 Installation und Aufruf
6.2.1 Starten des API Servers
CloudlessCamAPIServer.exe
CloudlessCamAPIServer
CloudlessCamAPIServer.
appsettings.json
6.2.2 Standard-URL
https://localhost:7142
6.2.3 Netzwerkzugri aktivieren
ListenUrls
https://0.0.0.0:7142
https://192.168.178.100:7142
Windows
Linux
ufw
sudo ufw allow 7142/tcp
6.2.4 Swagger und OpenAPI
Swagger UI: /swagger
OpenAPI JSON: /openapi/v1.json
MCP-Endpunkt: /mcp
Startseite: / /swagger
6.3 Sicherheit und Authentizierung
6.3.1 HTTPS-Verschlüsselung
Hinweise
6.3.2 Authentizierungsmodi
Password:
OAuth:
ApiServer:Authentication:Mode
Password-Modus
POST /api/auth/token
OAuth-Modus
Authority MetadataAddress
/mcp
/.well-known/oauth-protected-resource/
mcp
Grobe Scopes und feingranulare Permissions
Grobe Zugangsschranken: SwaggerScopes McpScopes
Feingranulare Permissions:
status.readcameras.write
recordings.export ptz.control PermissionScopes
AdminScopes
PermissionScopes
scope scp
EndpointOverrides
EndpointOverrides
PermissionScopes
/api/ptz/devices/{deviceId:guid}/move
/api
6.3.3 Empfehlungen zur Authentizierung
PasswordHash Password
SigningKey
6.3.4 Anmeldung über Swagger
POST /api/auth/token
6.4 Konguration
6.4.1 Speicherort der Kongurationsdatei
CloudlessCamAPIServer.
appsettings.json
Betriebssystem Pfad
%APPDATA%\CloudlessCam\CloudlessCamAPIServer.appsettings.json
~/.config/CloudlessCam/CloudlessCamAPIServer.appsettings.json
~/Library/Application Support/CloudlessCam/CloudlessCamAPIServer.appsettings.json
Configuration.
CloudlessCam
6.4.2 Wichtige Hosting-Einstellungen
ApiServer:Hosting
ListenUrls:
CerticatePath:
CerticatePassword:
6.4.3 Wichtige Authentizierungs-Einstellungen
ApiServer:Authentication
Mode: Password OAuth
PasswordHash:
Password:
SigningKey:
TokenLifetime:
StreamTokenLifetime:
Wichtig
ChangeThisPasswordNow
PasswordHash
6.4.4 OAuth-Einstellungen
Authority MetadataAddress
Audience
Issuer
SwaggerScopes
McpScopes
AdminScopes
PermissionScopes
EndpointOverrides
Beispiel: Read-, Operator- und Admin-Modell
{
"ApiServer": {
"Authentication": {
"Mode":"OAuth",
"OAuth": {
"Authority":"https://id.example.com/realms/cloudlesscam",
"Audience":"cloudlesscam-api",
"SwaggerScopes": [ "cloudlesscam.api" ],
"McpScopes":["cloudlesscam.mcp" ],
"AdminScopes": [ "cloudlesscam.admin" ],
"PermissionScopes": {
"status.read":["cloudlesscam.read" ],
"cameras.read":["cloudlesscam.read" ],
"cameras.write": [ "cloudlesscam.operator" ],
"recordings.read":["cloudlesscam.read" ],
"recordings.stream": [ "cloudlesscam.read" ],
"recordings.export": [ "cloudlesscam.export","cloudlesscam.operator" ],
"ptz.read": [ "cloudlesscam.read" ],
"ptz.control":["cloudlesscam.ptz","cloudlesscam.operator" ],
"settings.read": [ "cloudlesscam.read" ],
"settings.write": [ "cloudlesscam.admin" ],
"updates.install":["cloudlesscam.admin" ]
},
"EndpointOverrides": [
{
"Methods":["POST" ],
"Path":"/api/ptz/devices/{deviceId:guid}/move",
"Scopes": [ "customer.camera-yard.ptz" ]
}
]
}
}
}
}
SwaggerScopesMcpScopesAdminScopes PermissionScopes
EndpointOverrides
6.4.5 Umgebungsvariablen
Umgebungsvariable Entsprechende Einstellung
CLOUDLESSCAM_APISERVER_AUTH_MODE
CLOUDLESSCAM_APISERVER_PASSWORD
CLOUDLESSCAM_APISERVER_PASSWORD_HASH
CLOUDLESSCAM_APISERVER_OAUTH_SWAGGER_SCOPES
CLOUDLESSCAM_APISERVER_OAUTH_MCP_SCOPES
CLOUDLESSCAM_APISERVER_OAUTH_ADMIN_SCOPES
CLOUDLESSCAM_APISERVER_LISTEN_URLS
CLOUDLESSCAM_APISERVER_CERTIFICATE_PATH
CLOUDLESSCAM_APISERVER_CERTIFICATE_PASSWORD
CLOUDLESSCAM_APISERVER_CONFIG_PASSWORD
PermissionScopes EndpointOverrides
6.5 API-Bereiche
6.5.1 Wichtige API-Bereiche
/api/status
/api/settings
/api/cameras
/api/recording-configurations
/api/image-settings
/api/recordings
/api/storages
/api/storages/oauth
/api/ptz
/api/event-log
/api/licenses
/api/updates
/api/transfer-queue
6.5.2 KI-Assistenten-Anbindung (MCP)
/mcp
Typische Anwendungsbeispiele
Einrichtung
https://<host>:7142/mcp
Verfügbare Funktionen
Bereich Funktionen
Vorbereitete Aufgaben (Prompts)
Prompt Beschreibung
system_review
camera_setup
camera_setup_by_id camera_setup
recording_investigation
Medien und Downloads
6.5.3 Kurzzeit-Links für Medien und Downloads
recordings.export
support.download image-settings.read
6.6 Cloud-Speicher mit OAuth
Redirect-Flow:
Manual-Code-Flow:
Device-Code-Flow:
CallbackUrl
6.7 Betrieb als Dienst
6.7.1 Windows
API_Server_TaskScheduler_Install.ps1
API_Server_TaskScheduler_Deinstall.ps1
6.7.2 Linux
API_Server_systemd_Daemon_Install.sh
API_Server_systemd_Daemon_Deinstall.sh
6.7.3 Reverse Proxy
6.8 Zusammenspiel mit GUI, CLI und Pacemaker
Wichtige Punkte
6.9 Beispielkonguration
{
"ApiServer": {
"Hosting": {
"ListenUrls":"https://localhost:7142",
"CertificatePath":"",
"CertificatePassword":""
},
"Authentication": {
"Mode":"Password",
"Password":"ChangeThisPasswordNow",
"Issuer":"CloudlessCamAPIServer",
"Audience":"CloudlessCamClients",
"OAuth": {
"Authority":"",
"MetadataAddress":"",
"Audience":"",
"SwaggerScopes": [],
"McpScopes": [],
"AdminScopes": [],
"PermissionScopes": {},
"EndpointOverrides": []
}
}
}
}
6.10 Aufrueispiel
# Token anfordern
curl -k https://localhost:7142/api/auth/token \
-H "Content-Type: application/json" \
-d '{"password":"ChangeThisPasswordNow"}'
# Mit Bearer-Token den Status abrufen
curl -k https://localhost:7142/api/status \
-H "Authorization: Bearer <TOKEN>"
6.11 Fehlerbehebung
401 Unauthorized
Mögliche Ursachen:
Lösung:
/.well-known/oauth-protected-resource/
mcp
403 Forbidden im OAuth-Modus
Mögliche Ursachen:
SwaggerScopes
McpScopes
PermissionScopes
EndpointOverrides
PermissionScopes
AdminScopes
Lösung:
scope scp
API startet, bleibt aber gesperrt
Ursache: Configuration.CloudlessCam
Lösung: ApiServer:ConfigurationPassword
CLOUDLESSCAM_APISERVER_CONFIG_PASSWORD
Zugri von anderen Geräten funktioniert nicht
Mögliche Ursachen:
ListenUrls localhost
Lösung: ListenUrls
OAuth-Callbacks für Cloud-Speicher schlagen fehl
Mögliche Ursachen:
Lösung:
7.1 Performance
Substream statt Hauptstream verwenden
Empfehlung:
Videowand optimieren
Empfehlung:
Aufnahme-Parameter anpassen
Empfehlung:
Video-Codec:
Videoqualität:
Segmentlänge:
Bildrate:
Diagnose bei Ruckeln oder Aussetzern
Checkliste zur Diagnose:
7.2 Restream und Stream-Sharing
Wann sollten Sie Restream aktivieren?
Typische Symptome ohne Restream:
Lösung:
Hinweise zur Sicherheit
Fehlerbehebung bei Restream-Problemen
7.3 Ziel-Speicher und Dateiübertragung
Dateiübertragungs-Geschwindigkeit begrenzen
Konguration:
Richtwerte:
Speicherbedarf abschätzen
Faustformel:
Auewahrungsstrategien
Nach Datum:
Nach Speicherplatz:
Verhalten bei Verbindungsunterbrechungen
Hinweise zu Netzwerk-Speichern
7.4 Temp-Verzeichnis und Wartung
Maximale Größe des Temp-Verzeichnisses kongurieren
Konguration:
Empfehlung:
Manuelle Bereinigung
cloudlesscam maintenance clean
Kongurations-Backups
Ereignisprotokoll-Auewahrung
Empfehlung:
7.5 Netzwerk und Zuverlässigkeit
Feste IP-Adressen verwenden
Empfehlung:
Kabelgebundene Verbindungen bevorzugen
Empfehlung:
VLAN und Firewall-Konguration
Hinweise:
Zeitsynchronisation
Empfehlung:
7.6 Sicherheit und Datenschutz
Sichere Passwörter verwenden
Empfehlung:
Kongurationsverschlüsselung
Hinweise:
Anonymisierung bei Support-Anfragen
Zu anonymisierende Daten:
Zugri auf Aufnahmen beschränken
Empfehlung:
8.1 Installation und Start
Wo nde ich den Arbeitsordner von CloudlessCam?
Windows: %APPDATA%\CloudlessCam\ C:\Users\<Benutzername>
\AppData\Roaming\CloudlessCam\
Linux: ~/.config/CloudlessCam/
macOS: ~/Library/Application Support/CloudlessCam/
Configuration.ini
CloudlessCam.log.xml
CloudlessCamEventLog.json
Temp/
Warum stoppt die GUI beim Start einen laufenden CLI-Daemon?
Ressourcenschonung:
Konsistenz:
Prozesskoordination:
ffmpeg go2rtc
Wie deinstalliere ich CloudlessCam vollständig?
Windows (Installationsprogramm)
Windows (Portable) / Linux / macOS
8.2 Kameras, Discovery und Streams
Warum wird meine Kamera nicht automatisch gefunden?
ONVIF aktiviert:
Gleiches Subnetz:
Firewall/VLAN:
Welche Stream-URL muss ich bei „Manuell hinzufügen” verwenden?
rtsp://<Benutzername>:<Passwort>@<IP-Adresse>:<Port>/<Pfad>
Hikvision: rtsp://admin:passwort@192.168.1.100:554/Streaming/Channels/101
.../102
Dahua: rtsp://admin:passwort@192.168.1.100:554/cam/realmonitor?channel=1&subtype=0
subtype=1
Reolink: rtsp://admin:passwort@192.168.1.100:554/h264Preview_01_main
Generisch: /live/stream1/profile1 /H264/ch1/main/av_stream
Was ist der Unterschied zwischen Hauptstream und Substream?
Hauptstream (Main Stream):
Substream:
Warum ändert sich die IP-Adresse meiner Kamera?
DHCP-Reservierung:
Feste IP-Adresse:
8.3 Wiedergabe, Videowand und Performance
Die Live-Ansicht ruckelt oder zeigt kein Bild. Was kann ich tun?
Anzahl der Kameras reduzieren:
Netzwerkverbindung:
Was ist Restream und wann sollte ich es aktivieren?
go2rtc
rtsp://127.0.0.1:<Port>/restream
Warum beendet CloudlessCam FFmpeg- oder go2rtc-Prozesse?
ffmpeg go2rtc
8.4 Aufnahmen und Export
Wo werden meine Aufnahmen gespeichert?
Temporärer Speicher:
<Arbeitsordner>/Temp/
Ziel-Speicher:
Warum werden keine neuen Aufnahmen erstellt?
Aufnahmekonguration aktiviert:
Speicherort zugewiesen:
Zeitplan:
Lizenz:
Verbindungsprobleme:
Warum fehlen Segmente in der Timeline?
Kamera oine:
Übertragungsverzögerung:
Speicherfehler:
Temp-Verzeichnis voll:
Wann bleibt der Video-Codec „Copy” wirklich ohne Neucodierung?
8.5 Ziel-Speicher und Synchronisation
Warum werden keine Aufnahmen im Ziel-Speicher sichtbar?
Speicherort aktiviert:
Übertragungsintervall:
Zugangsdaten:
Pfadrechte:
Welche typischen Fehler treten bei SFTP/WebDAV auf?
Problem Lösung
Was passiert, wenn das Temp-Verzeichnis voll ist?
8.6 Konguration, Verschlüsselung und Migration
Wie funktioniert die Kongurationsverschlüsselung?
Algorithmus:
Schlüsselableitung:
Zusätzlicher Schutz:
Wie migriere ich CloudlessCam auf einen neuen Rechner?
Einstellungen →Konguration ex-
portieren
Einstellungen →Konguration im-
portieren
Was tun bei vergessenem Kongurationspasswort?
8.7 CloudlessCam Player
Wie importiere ich Speicherorte aus CloudlessCam in den Player?
Warum zeigt der Player keine Aufnahmen an?
Synchronisierung:
Datumslter:
Speicherort erreichbar:
8.8 Updates
Warum ist die Schaltäche „Update jetzt” ausgegraut?
Was passiert beim Update-Vorgang?
Prüfung:
Download:
Validierung:
Installation:
Neustart:
Wie wechsle ich den Update-Kanal?
release:
test:
Einstellungen →Updates →Update-Kanal
8.9 Lizenzierung
Was bedeutet die kostenlose Lizenz?
FREE FREE
Wie aktiviere ich eine Lizenz online?
Einstellungen →Lizenz
Wie aktiviere ich eine Lizenz oine?
Einstellungen →Lizenz →Oine-
Aktivierung
8.10 CLI, Daemon und Pacemaker
Wie starte ich CloudlessCam im Hintergrund?
cloudlesscam daemon start
Welche CLI-Befehle sind für Monitoring wichtig?
Befehl Beschreibung
status overview
status cameras
status storage
daemon status
daemon logs
cloudlesscam status overview --output json
Warum läuft der Daemon nicht oder startet doppelt?
GUI läuft:
Single-Instance-Schutz:
Rechte:
Logdateien: CloudlessCam.log.xml
8.11 Support, Logs und Datenschutz
Wie exportiere ich Logs für den Support?
Hilfe →Support
Welche Dateien sind für die Fehlersuche relevant?
Datei Inhalt
CloudlessCam.log.xml
CloudlessCamEventLog.json
Configuration.ini
Welche Daten sollte ich vor dem Teilen anonymisieren?
C:\Users\
IhrName\...
9.1 Komponenten und Prozesse
9.1.1 Übersicht der Programme
9.1.2 Betriebsmodi
Desktop-Modus (GUI)
Programm Beschreibung
CloudlessCam
CloudlessCamCLI
CloudlessCamPacemaker
CloudlessCam Player
CloudlessCam Web Player
CloudlessCamUpdate
Hintergrund-Modus (Daemon)
Kombinierter Betrieb
9.1.3 Prozess-Koordination
GUI startet:
GUI beendet:
Pacemaker aktiv:
Single-Instance-Schutz:
9.1.4 Speicherorte
Windows: %APPDATA%\CloudlessCam\
Linux: ~/.config/CloudlessCam/
macOS: ~/Library/Application Support/CloudlessCam/
Configuration.ini
CloudlessCam.log.xml
CloudlessCamEventLog.json
ffmpeg go2rtc
9.2 Protokolle, Discovery und Medienpipeline
9.2.1 ONVIF – Kameraerkennung und -steuerung
Automatische Kameraerkennung (Discovery)
Protokoll:
Multicast-Adresse:
Funktionsweise:
Voraussetzungen für erfolgreiche Erkennung
Kamerasteuerung über ONVIF
9.2.2 RTSP – Videostreaming
Ports
Standardport:
Alternativer Port:
Authentizierung
Typische Stream-Pfade
/Streaming/Channels/101
/cam/realmonitor?channel=1
/live/profile1/H264/ch1/main/av_stream
Hinweis zu wechselnden IP-Adressen
9.2.3 Restream – Optimierte Streamverteilung
Funktionsweise
go2rtc
Vorteile
Entlastung der Kamera:
Bessere Kompatibilität:
Konguration
rtsp://127.0.0.1:<Port>/restream
9.2.4 Externe Tools
Tool Verwendung
go2rtc
FFmpeg
7-Zip
Hinweis zum Video-Codec „Copy”
9.2.5 Wiedergabe
Häuge Wiedergabeprobleme
Schwarzes Bild:
Ruckelnde Wiedergabe:
Kein Ton:
9.3 CloudlessCam Pacemaker Hintergrunddienst
9.3.1 Zweck und Funktion
9.3.2 Funktionsweise
nicht
9.3.3 Kommandozeilenoptionen
9.3.4 Autostart einrichten
Option Kurzform Beschreibung
--waiting-time -w
--startup-delay -s
--redirect-output -r
--no-redirect-output
--help -h
Windows
Einstellungen →Pacemaker
HKEY_CURRENT_USER\SOFTWARE\Microsoft\Windows\CurrentVersion\Run
Linux
~/.config/autostart/cloudlesscam-pacemaker.desktop
macOS
~/Library/LaunchAgents/com.CloudlessCam.pacemaker.plist
9.3.5 Verhalten unter Windows
9.3.6 Zusammenspiel mit GUI und CLI
GUI wird gestartet:
GUI wird beendet:
Manueller Daemon-Stopp:
9.3.7 Fehlerbehebung
Der CLI-Daemon startet nicht
Antivirenprogramme
9.4 Logging, Diagnosen und Support
9.4.1 Logdateien
Datei Beschreibung
CloudlessCam.log.xml
CloudlessCamEventLog.json
9.4.2 Log-Rotation
Maximale Größe:
Bei Überschreitung:
Archivformat: CloudlessCam.log.xml.YYYYMMDD_HHmm.zip
Speicherort der Archive:
9.4.3 Debug-Modus
Configuration.ini
Debug=true
9.4.4 Support-Export
Hilfe →Support
Hinweis zur Anonymisierung
9.4.5 Häuge Fehlerbilder
Stream-Timeouts
Authentizierungsfehler
Speicher-Übertragungsfehler
9.5 Sicherheit und Datenschutz
9.5.1 Speicherung von Zugangsdaten
Empfehlungen
9.5.2 Kongurations-Passwort
Einstellungen →Sicherheit
Kongurations-Passwort
9.5.3 Verschlüsselung von Aufnahmen
.encrypted7z.7z
9.5.4 Netzwerk-Sicherheit
Empfehlungen
Separates VLAN:
Firewall:
Kein Internet-Zugang:
VPN:
9.5.5 Sensible Daten in Logs
9.6 Versionierung und Updates
9.6.1 Update-Kanäle
Kanal Beschreibung
release
test
9.6.2 Update-Ablauf
Prüfung:
Download:
Validierung:
Installation:
Neustart:
Verhalten bei laufendem Daemon
9.6.3 Manuelles Update
CloudlessCamUpdate
9.6.4 Update-Tool Parameter
CloudlessCamUpdate
Parameter Beschreibung
<pfad>
--startAfterFinish CLI GUI
--NoPacemakerRestart
--keepOpen
9.7 Zusatztools und Notfall-Werkzeuge
9.7.1 CloudlessCam Web Player – Web-basierter Player
Funktionen
HTTPS und Zertikate
CloudlessCamWebPlayer.pfx
Authentizierung
Ports und Netzwerk
Standardport:
Lokaler Zugri: https://localhost:7141
LAN-Zugri: https://<IP-Adresse>:7141
Formatkonvertierung
Speicherort des Cache
<Temp>/WebPlayer/Transcoded/
MaximumTempDirectorySize
Das WorkingDirectory
WorkingDirectory
Windows: %APPDATA%\CloudlessCam
macOS: ~/Library/Application Support/CloudlessCam
Linux: ~/.config/CloudlessCam
Zugri durch verschiedene Prozesse
10.1 Ordnerstruktur im WorkingDirectory
10.1.1 Backups-Ordner
Backups/
Configuration.JJJJ-MM-TT_HH-mm-ss.CloudlessCam
Configuration.JJJJ-MM-TT_HH-mm-ss.CloudlessCamPlayer
Configuration.2026-02-18_14-15-42.CloudlessCamConfiguration.
2026-02-16_11-23-42.CloudlessCamPlayer
Letzte 60 Minuten:
Aktueller Tag:
Letzte 30 Tage:
Älter als 30 Tage:
10.1.2 Temp-Ordner
Temp/
10.1.3 Protokolldateien
CloudlessCam.log.xml
CloudlessCam.log.xml.zip
CloudlessCamEventLog.json
10.2 Lokale Programmeinstellungen
Configuration.ini
10.2.1 Inhalt der Conguration.ini
[CloudlessCam]
Benutzeroberäche und Darstellung
Einstellung Typ Standard Beschreibung
Automatische Speicherung
Einstellung Typ Standard Beschreibung
Netzwerk und Geräteerkennung
Einstellung Typ Standard Beschreibung
Zielspeicher und Übertragung
Einstellung Typ Standard Beschreibung
Aufnahme und Restream
Einstellung Typ Standard Beschreibung
Ereignisprotokoll und Bereinigung
Einstellung Typ Standard Beschreibung
Updates und Debugging
Einstellung Typ Standard Beschreibung
Prozess- und Systemsteuerung
Einstellung Typ Standard Beschreibung
Sicherheit und Lizenz
Einstellung Typ Standard Beschreibung
Dashboard und Übersicht
Einstellung Typ Standard Beschreibung
Pfade und Dialoge
Einstellung Typ Standard Beschreibung
10.2.2 Bearbeitung der Einstellungen
cloudlesscam settings list
cloudlesscam settings set <key> <value>
cloudlesscam settings backup -o <pfad>
cloudlesscam settings restore <pfad>
10.3 Kongurationsdateien (Kameras / Aufnahmen / Speicher)
10.3.1 Dateiname und Speicherort
Hauptprogramm und CLI: Configuration.CloudlessCam
Player: Configuration.CloudlessCamPlayer
10.3.2 Inhalt der Kongurationsdatei
Gerätestruktur (NodeHierarchy)
Aufnahmekongurationen
Zielspeicher
Weitere Daten
10.3.3 Verschlüsselung
10.3.4 Automatische Sicherungen
Backups/
10.4 Web Player Konguration
10.4.1 Kongurationsdatei
CloudlessCamWebPlayer.appsettings.json
{
"WebPlayer": {
"Hosting": {
"ListenUrls":"https://0.0.0.0:7141",
"CertificatePath":"",
"CertificatePassword":""
},
"Authentication": {
"Password":"ChangeThisPasswordNow"
}
}
}
10.4.2 Ersteinrichtung
Wichtig: ChangeThisPasswordNow
10.4.3 HTTPS-Zertikat
Dateiname: CloudlessCamWebPlayer.pfx
Speicherort:
Gültigkeit:
Schlüsselstärke:
CerticatePath
CerticatePassword
10.4.4 Authentizierung
Klartext-Passwort (nur für Tests)
WebPlayer:Authentication:Password
Passwort-Hash (empfohlen für Produktion)
WebPlayer:Authentication:PasswordHash
10.4.5 Sitzungseinstellungen
SessionLifetime
StreamTokenLifetime
10.4.6 Umgebungsvariablen
CLOUDLESSCAM_WEBPLAYER_LISTEN_URLS
CLOUDLESSCAM_WEBPLAYER_PASSWORD_HASH
CLOUDLESSCAM_WEBPLAYER_PASSWORD
CLOUDLESSCAM_WEBPLAYER_CERTIFICATE_PATH
CLOUDLESSCAM_WEBPLAYER_CERTIFICATE_PASSWORD
CLOUDLESSCAM_WEBPLAYER_URL
10.4.7 Player-Kongurationspasswort
Configuration.CloudlessCamPlayer
10.5 Metadaten auf Zielspeichern
10.5.1 Zweck
CloudlessCamMetadata.json
10.5.2 Inhalt
DeviceIdentier
RecordingCongurationIdentier
FileName
CreatedAtUtc
UpdatedAtUtc
SizeBytes
DurationSeconds
FileHash
10.5.3 Aktualisierung
10.5.4 Nur-Lesen-Modus im Player
10.5.5 Fehlerfälle
10.6 Backups und Wiederherstellung
10.6.1 Automatische Sicherungen
Backups/ Configuration.
JJJJ-MM-TT_HH-mm-ss.CloudlessCam Configuration.JJJJ-MM-TT_HH-mm-ss.
CloudlessCamPlayer
10.6.2 Manuelle Sicherungen
Configuration.CloudlessCam
10.6.3 Wiederherstellung über die Benutzeroberäche
10.6.4 Wiederherstellung über die Kommandozeile
cloudlesscam settings backup -o <pfad>
cloudlesscam settings restore <pfad>
--force
10.6.5 Manuelle Wiederherstellung der JSON-Konguration
Configuration.CloudlessCam
Configuration.CloudlessCam
10.6.6 Fehlerbehebung bei Sicherungen
„Backup ist verschlüsselt”
„Datei nicht lesbar”
„Fehlende Berechtigungen”
10.7 Verschlüsselung und Passwörter
10.7.1 Was wird verschlüsselt
Configuration.
CloudlessCam Configuration.CloudlessCamPlayer
Configuration.ini
10.7.2 Passwortabfrage
GUI:
Player:
CLI-Daemon:
10.8 Kongurationsmigration (Umzug auf einen neuen Rech-
ner)
10.8.1 Zu kopierende Dateien
Configuration.CloudlessCam
Configuration.ini
Backups/
Configuration.CloudlessCamPlayer
10.8.2 Vor dem Kopieren
10.8.3 Auf dem neuen Rechner
10.8.4 Nach dem Umzug prüfen
Kameras:
Aufnahmen:
Zielspeicher:
Timeline:
Protokolle:
10.8.5 Pfade anpassen
10.9 Programmlogs
10.9.1 Technisches Protokoll
CloudlessCam.log.xml
Debug-Meldungen:
Info-Meldungen:
Warn-Meldungen:
Error-Meldungen:
CloudlessCam.log.xml.zip
10.9.2 Ereignisprotokoll
CloudlessCamEventLog.json
DeleteEventLogsAfterXDays
MaxEventLogEntries
10.9.3 Support-Export
