Dokumentation
Hier findest du eine Übersicht über die wichtigsten Bereiche der Webseite – inklusive Login und Funktionen für Kamerabesitzer.
1. Überblick
AllSkyKamera ist ein gemeinschaftliches Netzwerk aus AllSky-Kameras, Keogrammen und Sensorik. Ziel ist es, den Nachthimmel langfristig zu beobachten, zu dokumentieren und die Daten offen zugänglich zu machen.
2. Öffentliche Bereiche
Viele Inhalte auf AllSkyKamera sind ohne Login frei zugänglich. So kannst du sofort Live-Himmelsbilder ansehen, durch Archive stöbern und dich über das Netzwerk informieren.
Was finde ich ohne Login?
- Startseite mit Übersicht aller Kameras und deren Status.
- Einzelne Kameraseiten mit Livebild und Archiv.
- Keogramme, Timelapse-Videos und Startrails (je nach Kamera/Standort).
- Karte, Netzwerk-Infos und Unterstützer-Seite.
Kameraseiten: Livebild, Archiv & Daten
Jede Kamera hat eine eigene Detailseite. Dort siehst du je nach Ausstattung und Upload-Status Livebilder, Archive und Auswertungen.
- Aktuelles Livebild (image.jpg)
- Tages-/Datumsarchiv mit Bildern
- Langzeitansichten wie Startrails (falls vorhanden)
- Keogramme (auch Langzeit, je nach Setup)
- Timelapse-Videos (täglich/saisonal/jährlich)
- Sensorwerte (z. B. Temperatur, SQM), wenn verfügbar
2.1 Kameras & Kameraseiten
Kameras sind das Herz des Netzwerks. Auf der Startseite siehst du eine Übersicht (Kacheln). Jede Kamera hat außerdem eine Detailseite mit Livebild, Standortinfos und Datenprodukten.
A) Kamera-Kachel auf der Startseite
Die Kachel gibt dir einen schnellen Überblick: Livebild, Standortname, Kamera-ID, Status und direkte Links.
- Livebild-Vorschau (wird regelmäßig aktualisiert).
- Standortname und Kamera-ID (ASKxxx).
- Online/Offline-Status.
- Level/XP (Gamification-Element der Community).
- Buttons: Kameraseite, Sensorseite und ggf. Steckbrief.
B) Detailseite einer Kamera
Die Detailseite bündelt alles, was zu einer Kamera gehört: Livebild, Kartenposition, Livewerte und Links zu Unterseiten.
- Kartenansicht mit Marker und Status.
- Standortdaten (Name, Koordinaten, ggf. Kontakt/Website).
- Share-Buttons (z. B. Link kopieren / Social).
- Systemstatus (Online, Speicher, Uptime, Temperatur etc.).
- Sensorspalte (BME280, DS18B20, SQM etc. – je nach Hardware).
- Direktlinks: Sensorwerte anzeigen, Steckbrief öffnen.
C) Letzte Dateien & Datenprodukte
Viele Kameras erzeugen automatisch zusätzliche Produkte, die auf der Detailseite bzw. in Unterseiten erreichbar sind.
- Letztes Video (Timelapse).
- Letztes Keogramm.
- Letzte Startrails.
- Langzeit-Produkte wie Jahreszeitenvideo oder Longterm-Keogramm (falls aktiviert).
D) Highlights
Highlights sind eine kuratierte Sammlung besonderer Ereignisse (z. B. Aurora, Sternhimmel, besondere Startrails) und machen das Netzwerk auch für Besucher spannend.
2.2 Sensor-Seite
Auf der Sensor-Seite findest du Livewerte und Messreihen der Kamera. Welche Werte sichtbar sind, hängt von der verbauten Hardware ab (z. B. Temperatur, Luftfeuchtigkeit, SQM-Himmelshelligkeit).
- Temperaturen (Pi, Gehäuse, Außen – je nach Sensor).
- Luftfeuchtigkeit und Luftdruck (z. B. BME280).
- Systemdaten wie Uptime oder Speicher (je nach Kamera).
- Himmelshelligkeit (SQM / TSL2591 – wenn vorhanden).
- Zusatzwerte wie Kp-Index oder Wetterdaten (falls eingebunden).
- Grafana-Links oder Detailseiten (wenn freigeschaltet).
Nicht jede Kamera hat die gleiche Sensorik. Fehlende Blöcke bedeuten meist: Hardware nicht vorhanden oder Daten werden (noch) nicht übertragen.
2.3 Steckbrief-Seite
Die Steckbrief-Seite ist eine öffentliche Profilseite zur Kamera: Sie zeigt Infos zum Standort, zum Setup, zur Community und (optional) Bilder und Links. Sie existiert nur, wenn der Kamerabesitzer den Steckbrief im User-Profil aktiviert und Inhalte gepflegt hat.
- Details zur Kamera (Name, Standort, Kontakt, Koordinaten).
- Textbereich „Über uns“ / Beschreibung des Standorts.
- Kamera-Setup (Hardware, Sensoren, Dome, Gehäuse etc.).
- Discord-/Signal-Infos (optional, wenn gepflegt).
- Bildergalerie (optional).
- Links (Website, MakerWorld, TinkerCAD usw.).
Wenn kein Steckbrief aktiv ist, erscheint der Button „Steckbrief“ nicht. Die Seite ist bewusst optional, damit Kamerabesitzer selbst entscheiden, welche Informationen öffentlich angezeigt werden.
Wenn du eine Kamera betreibst, lohnt sich ein Login: Damit kannst du dein Profil, den Steckbrief und Community-Funktionen verwalten.
3. Special-Seiten
Hier dokumentieren wir spezielle Übersichts- und Detailseiten, die zusätzliche Inhalte und Filter bieten – unabhängig davon, ob man eingeloggt ist.
Auf den Kameraseiten gibt es einen Block „Detailseiten“. Darüber gelangst du direkt zu speziellen Listen und Übersichten.
- Ruft die Sensor-Seite der Kamera auf.
- Alle Videos anzeigen: Liste der Timelapse-Videos.
- Alle Keogramme anzeigen: Keogramm-Archiv.
- Alle Startrails anzeigen: Startrail-Archiv.
- Grafana-Panel öffnen: weiterführende Dashboards/Charts (wenn verfügbar).
Alle Videos anzeigen
Diese Seite zeigt alle Timelapse-Videos einer Kamera in einer Kalenderansicht. Du kannst den Zeitraum einschränken und schnell zu einzelnen Tagen springen.
Zeitraumfilter
- Wähle „Von Monat“ und „Bis Monat“.
- Mit „Anwenden“ lädst du den gewünschten Zeitraum.
- „Zurücksetzen“ setzt den Filter wieder zurück.
Kalenderansicht
- Jeder Tag ist eine Kachel – sobald ein Video vorhanden ist, erscheint eine Vorschau.
- Unter den Tageskacheln gibt es Direktbuttons (z. B. Keogramm / Startrail), falls diese Produkte am Tag existieren.
- Mit „Zurück zur Kamera“ kommst du jederzeit zurück auf die Kamera-Detailseite.
Wenn an einem Tag keine Vorschau sichtbar ist, existiert für diesen Tag entweder kein Video oder es wurde noch nicht erzeugt/hochgeladen.
Alle Keogramme anzeigen
Diese Seite zeigt die Keogramme einer Kamera in einer Kalenderansicht. Ein Keogramm ist eine kompakte Darstellung des Himmels über die Zeit und eignet sich besonders, um Wolken, Aufhellungen oder Ereignisse schnell zu erkennen.
Zeitraumfilter
- Wähle „Von Monat“ und „Bis Monat“.
- Mit „Anwenden“ lädst du den gewünschten Zeitraum.
- „Zurücksetzen“ setzt den Filter wieder zurück.
Kalenderansicht
- Jeder Tag ist eine Kachel – wenn ein Keogramm existiert, wird eine Vorschau angezeigt.
- Über die Buttons pro Tag kannst du direkt zur Video- oder Startrail-Ansicht springen (falls vorhanden).
- Mit „Zurück zur Kamera“ kommst du zurück auf die Kamera-Detailseite.
Keogramme sind besonders hilfreich, um die Nachtqualität zu vergleichen: klare Nächte zeigen oft gleichmäßige Strukturen, während Wolken oder Dunst deutliche Muster erzeugen.
Alle Startrails anzeigen
Diese Seite zeigt die Startrails einer Kamera in einer Kalenderansicht. Startrails sind Sternspurenbilder, die aus vielen Einzelaufnahmen einer Nacht zusammengesetzt werden und die scheinbare Bewegung der Sterne sichtbar machen.
Zeitraumfilter
- Wähle „Von Monat“ und „Bis Monat“.
- Mit „Anwenden“ lädst du den gewünschten Zeitraum.
- „Zurücksetzen“ setzt den Filter wieder zurück.
Kalenderansicht
- Jeder Tag ist eine Kachel – wenn ein Startrail existiert, wird eine Vorschau angezeigt.
- Über die Buttons pro Tag kannst du direkt zur Video- oder Keogramm-Ansicht springen (falls vorhanden).
- Mit „Back to camera / Zurück zur Kamera“ kommst du zurück auf die Kamera-Detailseite.
Startrails funktionieren besonders gut in klaren Nächten. Wolken, Tau oder starke Lichtverschmutzung können das Ergebnis deutlich beeinflussen.
Grafana-Panel öffnen
Grafana bietet weiterführende Dashboards und Diagramme für Status- und Sensordaten. Der Link führt auf einen externen Grafana-Server (nicht direkt auf allskykamera.space).
Was sehe ich dort?
- Status der Kamera (Online/Offline) und Laufzeit/Uptime.
- Systemwerte wie Speicherbelegung und freie Kapazität.
- Temperaturkurven (z. B. Raspberry Pi, BME280, DS18B20, Kamera) – je nach Sensorik.
- Weitere Panels wie Kp-Index oder Upload-Status – abhängig vom Dashboard.
Grafana liegt auf einem separaten Server/Host. Je nach Konfiguration kann der Zugriff öffentlich sein oder eine Anmeldung erfordern. Beim Öffnen verlässt du die Webseite allskykamera.space.
Mitmachen & Secret-Key beantragen
Um eine eigene AllSkyKamera in das Netzwerk einzubinden, benötigst du einen persönlichen Secret-Key. Dieser Key ermöglicht die sichere Zuordnung deiner Kamera zum AllSkyKamera-Netzwerk.
Secret-Key beantragen
Über das Formular auf der Mitmach-Seite können Kamerabesitzer einen Secret-Key beantragen.
- Name und E-Mail-Adresse des Kamerabetreibers.
- Standort der Kamera (z. B. Stadt oder Region).
- Optional ein Link zur Kamera oder Webseite.
- Zusätzliche Hinweise oder Anmerkungen.
Nach dem Absenden des Formulars wird keine automatische E-Mail verschickt. Der Antrag wird zunächst gespeichert und manuell geprüft. Die Rückmeldung und der Secret-Key werden anschließend persönlich per E-Mail von gottie@web.de versendet.
Login für Kamerabesitzer
Der Login-Bereich ist für Kamerabesitzer im AllSkyKamera-Netzwerk. Nach dem Login kannst du kamerabezogene Funktionen verwalten (z. B. Steckbrief, Community-Infos und Badges).
Jeder Kamerabesitzer erhält seinen Login persönlich von Stefan. Es gibt keine automatische Registrierung oder Account-Erstellung auf der Webseite.
So funktioniert der Login
- Öffne die Login-Seite.
- Gib Benutzername und Passwort ein.
- Nach erfolgreichem Login wirst du in dein Benutzerprofil weitergeleitet.
User-Profil für Kamerabesitzer
Nach dem Login gelangst du in deinen persönlichen Bereich. Dort kannst du kamerabezogene Einstellungen verwalten und optionale Inhalte wie den Steckbrief pflegen.
Details & Datengröße
Dieser Bereich zeigt eine Übersicht zur Kamera sowie eine Zusammenfassung der gespeicherten Datenmengen (z. B. Videos, Keogramme, Startrails).
- Kamera-ID (ASKxxx) und Name.
- Standortname und Koordinaten.
- Status (z. B. online).
- Schnelllinks zur Kamera- und Sensor-Seite.
- Anzahl Dateien pro Produkttyp (Videos, Keogramme, Startrails, Images, SQM).
- Gesamtgröße pro Produkttyp.
- Gesamtvolumen (Summe aller Daten).
Steckbrief (öffentliches Kameraprofil)
Im Steckbrief kannst du deine Kamera und den Standort vorstellen. Der Steckbrief wird auf der Webseite nur dann öffentlich angezeigt, wenn du ihn aktivierst und Inhalte pflegst.
Du entscheidest, welche Informationen öffentlich sichtbar sind. Trage nur Inhalte ein, die du bewusst veröffentlichen möchtest (z. B. keine privaten Adressen).
Steckbrief aktivieren
- Aktiviere den Schalter „Steckbrief aktivieren“, um den Steckbrief öffentlich sichtbar zu machen.
- Mit „Zum Steckbrief“ kannst du die öffentliche Ansicht direkt prüfen.
- Ohne Aktivierung wird der Steckbrief nicht angezeigt und der Button „Steckbrief“ erscheint auf der Kamera-Kachel/Seite nicht.
Welche Inhalte kann ich pflegen?
- Kamera-Details im Steckbrief (Name, Standort, Koordinaten etc.).
- „Über mich/uns“: Freitext zur Kamera, zum Standort oder zur Motivation.
- Kamera-Setup: Hardware, Dome, Heizung, Sensoren (als Liste).
- Bilder: bis zu mehrere Bilder zur Kamera/Installation (optional).
- Links: Website, LinkedIn, GitHub, MakerWorld, TinkerCAD, AstroBin usw.
- „Sonstiges“: weitere URLs oder Hinweise (z. B. Mastodon, Discord-Handle).
- Community-Status: Discord/Signal Mitgliedschaft (optional).
- Nicknames/Usernames: nur falls du sie öffentlich zeigen möchtest.
Vergiss nicht zu speichern: Änderungen werden erst nach „Speichern“ übernommen. Je nach Inhalt kann die Darstellung auf der öffentlichen Steckbrief-Seite leicht abweichen.
Passwort ändern
Hier kannst du dein Login-Passwort ändern. Dafür benötigst du dein aktuelles Passwort.
So änderst du dein Passwort
- Gib dein aktuelles Passwort ein.
- Gib das neue Passwort ein und bestätige es.
- Klicke auf „Speichern“.
Wähle ein starkes Passwort (lang, einzigartig, keine Wiederverwendung). Wenn du dein Passwort vergessen hast, melde dich bei Stefan, damit ein neues Passwort vergeben werden kann.
Dateien & Pfade
In diesem Bereich findest du die direkten URLs zu den aktuellen Bildern und Videos deiner AllSkyKamera. Diese Pfade kannst du verwenden, um Inhalte deiner Kamera auf deiner eigenen Webseite einzubinden.
Was wird hier angezeigt?
- Direkte Pfade zu aktuellen Bildern (z. B. SQM, Keogramm, Startrails).
- Direkte Pfade zu aktuellen Videos (z. B. Nacht-Timelapse, Tagesvideo).
- Alle URLs verweisen immer auf die jeweils neuesten verfügbaren Dateien.
Typische Nutzung
- Einbindung von Bildern oder Videos per <img> oder <video> auf der eigenen Webseite.
- Anzeige aktueller Kamera-Daten ohne eigene Server-Logik oder Dateiverwaltung.
- Verwendung in Webseiten, Blogs oder Projektseiten rund um die eigene AllSkyKamera.
Die hier angezeigten Pfade sind bewusst abstrahiert und greifen über einen Proxy auf die aktuellen Dateien zu. Interne Serverstrukturen oder Zugangsdaten werden nicht offengelegt.
Interne Sensoren
Hier siehst du die internen Sensoren deiner Kamera, die direkt auf dem Raspberry Pi ausgelesen werden. Welche Sensoren verfügbar sind, hängt von deiner Hardware und der config.json auf der Kamera ab.
So funktioniert es
- Die Aktivierung/Deaktivierung der Sensoren erfolgt über das setup-Skript auf der Kamera.
- Die Tabelle zeigt dir, welche Sensoren aktiv sind und ob sie grundsätzlich verfügbar sind.
- Mit „Auf Kamera-Seite anzeigen“ steuerst du, welche aktiven Sensoren öffentlich auf kamera.php bzw. sensor.php dargestellt werden.
Die Webseite kann Sensoren nicht aktivieren, wenn sie in der config.json deaktiviert sind oder hardwareseitig fehlen. In diesem Fall werden sie hier nur zur Information angezeigt.
Externe Sensoren (API)
Über die AllSkyKamera API kannst du externe Sensoren und Messgeräte (z. B. Wetterstationen oder eigene Sensorprojekte) mit deiner Kamera verbinden. Die Daten werden serverseitig gespeichert und später auf der Sensor-Seite angezeigt.
So funktioniert es
- Externe Sensoren senden ihre Messwerte per API an den AllSkyKamera-Server.
- Die Daten werden in der InfluxDB gespeichert und deiner Kamera zugeordnet.
- Sobald erste Daten eingegangen sind, werden hier zusätzliche Konfigurationsoptionen freigeschaltet.
Externe Sensoren können ausschließlich mit einem gültigen Secret-Key Daten an den Server senden. Ohne diesen Schlüssel werden keine Messwerte angenommen oder gespeichert.
Highlights & Monatsvorschau
Hier kannst du besondere Keogramme, Startrails und Videos als Highlights markieren. Diese Highlights werden anschließend auf deiner öffentlichen Kamera-Seite angezeigt.
Highlights setzen und entfernen
- Im Bereich „Bisherige Highlights“ siehst du alle aktuell gesetzten Highlights.
- Du kannst einzelne Highlights über die Checkbox „Highlight deaktivieren“ wieder ausblenden.
- Im Bereich „Monatsübersicht & neue Highlights“ wählst du Monat und Typ (z. B. Keogramm) und klickst „Anzeigen“.
- Markiere ein Element als Highlight und wähle (falls vorhanden) eine passende Kategorie.
Beim Deaktivieren werden Dateien nicht gelöscht. Ein Highlight wird nur aus der Anzeige entfernt und kann später jederzeit wieder aktiviert werden.
Daten auswählen / Aktionen
In diesem Bereich kannst du mehrere Dateien auswählen, gesammelt herunterladen oder (falls nötig) löschen. Das ist ein Verwaltungsbereich für Kamerabesitzer.
Gelöschte Dateien sind nicht mehr verfügbar. Das Löschen kann die XP deiner Kamera beeinflussen und kann dazu führen, dass automatisch erzeugte Produkte (z. B. Tagesvideos) bei der nächsten Berechnung anders aussehen oder neu gerendert werden.
So nutzt du den Bereich
- Wähle Monat und Typ (z. B. Keogramme, Videos, Startrails) und klicke „Anzeigen“.
- Markiere einzelne Dateien oder nutze „Select all“, um mehrere Dateien auszuwählen.
- Mit „Download selected“ kannst du die ausgewählten Dateien gesammelt herunterladen.
- Mit „Delete selected“ entfernst du die ausgewählten Dateien dauerhaft.
Nutze das Löschen nur, wenn es wirklich nötig ist (z. B. offensichtliche Fehlbilder, Testdaten oder doppelte Uploads). Für „normale“ Wolken- oder Wetterphasen sollten Daten in der Regel erhalten bleiben.
Services des AllSkyKamera-Netzwerks
Das AllSkyKamera-Netzwerk bietet weit mehr als das reine Anzeigen von Himmelsbildern. Kamerabetreiber profitieren von einer Vielzahl technischer, organisatorischer und gemeinschaftlicher Services.
Client-seitige Services (Kamera)
Für alle Kameras im Netzwerk steht eine zentrale, offene Python-Bibliothek zur Verfügung.
- Upload von Bildern, Videos und Metadaten
- Einheitliches Sensor-Handling (intern & extern)
- Kalibrations- und Testskripte (z. B. SQM / TSL2591)
- Diagnose- und Hilfsskripte für den Kamerabetrieb
Projekt auf GitHub: github.com/gottie29/AllSkyKamera
Server-seitige Services
Die Server-Infrastruktur des Netzwerks übernimmt Speicherung, Verarbeitung und Aufbereitung der Kameradaten.
- API für externe Sensoren (mit Secret-Key)
- Automatische Erstellung von Keogrammen
- Langzeit-Keogramme (Monatsübersichten)
- Startrails aus Nachtaufnahmen
- Automatische Tages-, Monats- und Jahresvideos
Öffentliche Darstellung & Einbindung
Alle Kameras erhalten eine eigene öffentliche Kamera- und Sensorseite.
- Öffentliche Kamera- & Sensorseiten
- Kartenansicht des Netzwerks
- Highlights zur Hervorhebung besonderer Ereignisse
- Einfache Einbindung von Bildern & Videos in die eigene Webseite
Community & Netzwerk
Das AllSkyKamera-Netzwerk ist ein gemeinschaftliches Projekt.
- Austausch über Hardware, Sensorik & Kalibration
- Gemeinsame Weiterentwicklung von Software & Konzepten
- Offizielle Member-Badges für Kamerabetreiber
Viele dieser Services laufen vollautomatisch im Hintergrund und erfordern keine zusätzliche Konfiguration durch die Kamerabetreiber.