Zurück zur StartseiteDokumentation

Alles, was du wissen musst

Vollständige Anleitungen zur Installation, Konfiguration und Nutzung von Boothy für unvergessliche Events.

Einführung#

Boothy Desktop ist eine Windows-Fotobox-Anwendung im Vollbild-Kiosk-Modus. Sie steuert den gesamten Ablauf von Fotoaufnahme über Bearbeitung bis zur Ausgabe -- perfekt für Hochzeiten, Firmenevents, Geburtstage und mehr.

Boothy Desktop

Die Hauptanwendung: Kiosk-UI, Kameraaufnahme, Filter, Sticker, Druck und Sharing.

Mirror / TV-Companion

Begleitanzeige: Live-Fotogalerie und Leaderboard für TV oder zweiten Monitor.

Boothy.Web

Marketing-Website und Admin-Panel für deine Online-Präsenz.

Fuer eine voll funktionsfähige Fotobox benötigst du nur Boothy Desktop. Der Mirror/TV-Companion ist ein optionales Zweitdisplay, und Boothy.Web ist für deine Marketing-Website.

Systemanforderungen#

Boothy Desktop

KomponenteMinimumEmpfohlen
BetriebssystemWindows 10 64-bitWindows 11 64-bit
CPUDual-Core 2 GHzQuad-Core 3 GHz+
RAM4 GB8 GB
Speicher2 GB10 GB+
Laufzeit.NET 9.0 Runtime.NET 9.0 Runtime
KameraWebcam (USB)Canon/Nikon DSLR (USB)
Display1280x7201920x1080 Touch

Unterstützte Kameras

  • Canon DSLR (USB, native Verschlusssteuerung)
  • Nikon DSLR (USB, native Verschlusssteuerung)
  • Webcam / USB-Kamera (OpenCV/DirectShow)

Mirror / TV-Companion

Der Mirror/TV-Companion läuft als Web-Applikation, die von Boothy Desktop ausgeliefert wird. Er kann in jedem modernen Browser im selben lokalen Netzwerk angezeigt werden.

KomponenteAnforderung
GerätBeliebiges Gerät mit Browser (PC, Raspberry Pi, Smart TV, Tablet)
BrowserChrome 90+, Firefox 88+, Safari 14+, Edge 90+
NetzwerkGleiches lokales Netzwerk wie Boothy Desktop
Display1920x1080 empfohlen

Installation#

1. Boothy herunterladen

Lade die neueste Version von Boothy von der Download-Seite herunter. Du kannst die Software mit eingeschränkten Funktionen dauerhaft kostenlos nutzen (Freemium) oder alle Premium-Features mit einem Limit von 10 Aufnahmen im Vorfeld testen (Trial).

Zu den Downloads

2. Installation unter Windows

  1. 1Lade den BoothyDesktop-Installer (.msi-Datei) herunter.
  2. 2Führe die heruntergeladene Installationsdatei aus und folge den Anweisungen auf dem Bildschirm.
  3. 3Starte Boothy über die Verknüpfung auf dem Desktop oder das Startmenü.
  4. 4Beim ersten Start kann Windows Defender SmartScreen eine Warnung anzeigen. Klicke auf "Weitere Informationen" und dann "Trotzdem ausführen".
  5. 5Boothy zeigt einen Ladebildschirm (Lizenz prüfen, Kamera verbinden, Dienste starten) und dann öffnet sich automatisch der Einrichtungsassistent.
Die .NET 9.0-Laufzeitumgebung ist in Boothy enthalten und muss nicht separat installiert werden.

Erste Schritte#

Wenn du Boothy zum ersten Mal startest, führt dich der Einrichtungsassistent in 5 Schritten durch die Grundkonfiguration. Du kannst diese Einstellungen später jederzeit im Admin-Bereich ändern.

Einrichtungsassistent (5 Schritte)

Schritt 0: Sprachauswahl

Wähle deine bevorzugte Sprache: Deutsch oder Englisch.

Schritt 1: Admin-Passwort

Lege ein optionales Admin-Passwort fest (mindestens 4 Zeichen), um den Admin-Bereich vor Gästen zu schuetzen.

Schritt 2: Event-Branding

Gib deinen Event-Namen ein und wähle eine Schriftart (9 Optionen: Inter, Playfair Display, Bebas Neue, Dancing Script, Great Vibes, Parisienne, Alex Brush, Pacifico, Oswald). Wähle einen Titel-Farbverlauf und Hintergrund-Farbverlauf aus Vorlagen: pink-purple, gold, fire, ocean, forest, sunset, cotton-candy, ice, white.

Schritt 3: Sharing & Hardware

Aktiviere oder deaktiviere Sharing-Funktionen: QR-Code Download (Premium), Drucken, Galerie speichern, WhatsApp via Twilio, Video & Boomerangs, Sticker, KI-Hintergrundentfernung. Optional WLAN-Name, Passwort und IP-Adresse konfigurieren.

Schritt 4: Netzwerk & APIs

Konfiguriere netzwerkbezogene API-Einstellungen. Dieser Schritt wird automatisch übersprungen, wenn im vorherigen Schritt keine Netzwerk-Sharing-Methoden aktiviert wurden.

Schritt 5: Bestätigung

Überprüfe deine Einstellungen und wähle, ob du direkt den Kiosk-Modus starten oder das Admin-Dashboard für weitere Konfiguration öffnen möchtest.

Die Sprache kann auch jederzeit von Gästen direkt auf dem Hauptbildschirm geändert werden -- nicht nur während der Einrichtung.

Startbildschirm#

Der Startbildschirm ist das, was Gäste sehen, wenn die Fotobox im Leerlauf ist. Er zeigt dein Event-Branding und bietet Zugang zu allen Hauptfunktionen.

Startbildschirm-Elemente

  • Event-Name groß mit gewählter Schriftart und Farbverlauf
  • "BERUEHREN UM ZU STARTEN" Button zum Starten einer Aufnahme-Session
  • Aufnahme-Modus-Auswahl (FOTO / VIDEO / BOOMERANG, wenn Video aktiviert)
  • Gedimmte Kamera-Live-Vorschau im Hintergrund
  • Floating Gallery: animierte Fotos im Hintergrund (deaktiviert im Performance-Modus)
  • QR-Code / Teilen-Button
  • Galerie-Button
  • Sprachauswahl (Deutsch/Englisch) -- dauerhaft änderbar durch Gäste
  • Optionales Hintergrundbild ersetzt den animierten Farbverlauf (Textfarbe passt sich automatisch an)

Ending-Soon Timer

Wenn ein Zeitfenster konfiguriert ist, erscheint ein kreisförmiger Timer auf dem Startbildschirm. Seine Farbe wechselt je nach verbleibender Zeit: gruen (mehr als 45 Min.), gelb (mehr als 30 Min.), orange (mehr als 15 Min.), rot (weniger als 15 Min.). Der Timer blinkt in den letzten 10 Minuten.

Zeitfenster-Steuerung

Du kannst im Admin-Bereich ein Nutzungszeitfenster konfigurieren. Vor der Startzeit zeigt ein WAITING-Modus einen Countdown (TT:HH:MM:SS oder HH:MM:SS) mit optionalem Logo und Hintergrundbild. Nach der Endzeit verhindert ein ENDED-Modus weitere Aufnahmen.

Eine Lizenz-Ablaufwarnung kann als animierter Rahmen auf dem Startbildschirm erscheinen: orange bei mehr als 30 Minuten verbleibend, rot bei weniger als 30 Minuten, und blinkend rot bei weniger als 10 Minuten.

Kameraaufnahme#

Aufnahme-Modi

Foto

3-2-1-Countdown, dann Standbild. Bei Multi-Slot-Templates: eine Aufnahmesequenz pro Slot.

Video

3-2-1-Countdown, 5 Sekunden Aufnahme bei ca. 30 fps, gespeichert als MP4.

Boomerang

3-2-1-Countdown, 2 Sekunden Aufnahme bei ca. 15 fps, vorwärts+rückwärts Schleife, gespeichert als MP4.

Countdown

Der Countdown verwendet animierte Zahlen mit unterschiedlichen Farben: 3 = Rot, 2 = Teal, 1 = Gelb. Nach dem Countdown wird kurz "LÄCHELN!" angezeigt. Standardmäßig ist Auto-Start aktiviert, ein manueller Auslöser-Modus ist ebenfalls verfügbar.

Technische Details

  • Bilder werden horizontal gespiegelt (Selfie-Modus)
  • JPEG-Qualität: 95%
  • Rohdaten werden im Unterordner "Rohdaten" gespeichert
  • Template-Bilder werden auf einem 1800x1200px Canvas gerendert (3:2 Seitenverhältnis)

Review & Bearbeitung#

Nach jeder Aufnahme können Gäste im Review-Bildschirm ihr Foto verbessern, bevor es gespeichert wird. Videos werden in Endlosschleife ohne Filter- oder Hintergrund-Optionen abgespielt.

Filter

8 Filter werden als horizontale Leiste mit Vorschau-Thumbnails angezeigt: Original, Graustufen, Sepia, Warm, Cool, Vignette, Weich, Hell.

Hintergrundersatz (Premium)

Wenn KI-Hintergrundentfernung aktiviert ist, kann der Admin Hintergrundersatz-Modi konfigurieren: Original, Unschärfe, Farbe (Hex-Wert vom Admin), oder Bild (vom Admin hinterlegt). Der Gast wählt den Modus während des Reviews. Die Segmentierung erfolgt via OpenCV GrabCut.

Hintergrundersatz-Optionen werden ausschließlich vom Admin konfiguriert. Gäste können nur den Modus wählen, nicht die Farbe oder das Bild festlegen.

Sticker / Requisiten (Premium)

PNG-Dateien aus dem Sticker-Ordner können per Touch-Gesten auf Fotos platziert werden: verschieben, skalieren, rotieren und entfernen. Eigene Sticker können durch Ablegen von PNG-Dateien im Sticker-Verzeichnis hinzugefügt werden.

Review-Aktionen

  • Fertig: speichert alle Bearbeitungen permanent
  • Verwerfen: Bearbeitungen werden verworfen, Rohbild bleibt erhalten
  • Drucken (wenn aktiviert)
  • QR-Code (Premium)
  • E-Mail senden (Premium, wenn aktiviert)
  • Datei öffnen

Templates & Design#

Templates bestimmen, wie aufgenommene Fotos zusammengesetzt und gerendert werden. Das Standard-Template verwendet ein einzelnes Foto, aber du kannst benutzerdefinierte Multi-Slot-Templates mit dem integrierten visuellen Editor erstellen.

Template-Editor

Template-Editor Funktionen

  • Canvas-Größe: 1800x1200 px (3:2 Seitenverhältnis)
  • Hintergrundfarbe (Hex) oder Hintergrundbild (Premium)
  • Foto-Slots hinzufügen, positionieren und entfernen per Drag & Drop
  • Slot-Positionierung in Prozent für responsives Layout
  • Anzahl der Countdown-Sequenzen entspricht der Anzahl der Slots

Template-Manager

Der Template-Manager im Admin-Bereich ermöglicht das Bearbeiten, Duplizieren und Löschen von Templates. Das aktive Template für die aktuelle Session kann im Admin-Bereich unter dem Tab "Session" ausgewählt werden.

Fotos teilen#

Boothy bietet mehrere Wege, über die Gäste ihre Fotos erhalten können. Alle Sharing-Optionen können im Admin-Bereich individuell aktiviert oder deaktiviert werden.

QR-Code Download (Premium)

Ein QR-Code wird angezeigt, der zum Boothy Mirror Webserver verlinkt. Gäste scannen ihn mit ihrem Smartphone, um das Foto herunterzuladen. Der QR-Code verweist auf http://{IP}:3000.

WhatsApp (Twilio)

Fotos direkt per WhatsApp über Twilio-Integration versenden. Wird im Einrichtungsassistenten oder Admin-Bereich konfiguriert. Diese Funktion ist als Legacy-Sharing-Option verfügbar.

Drucken

Fotos direkt auf einem Windows-kompatiblen Drucker drucken. Unterstützt automatisches Drucken nach jeder Aufnahme und konfigurierbares Drucklimit.

E-Mail (via n8n Webhook)

Fotos per E-Mail über einen n8n Webhook versenden (kein SMTP). Der Admin konfiguriert die Webhook-URL, Caption und optionale Basic-Auth-Zugangsdaten.

Galerie

Alle Fotos werden lokal gespeichert und können jederzeit in der integrierten Galerie angesehen werden.

Galerie#

Die integrierte Galerie bietet einen Überblick über alle aufgenommenen Medien während des Events.

Galerie-Funktionen

  • Filter nach Typ: Alle / Fotos / Boomerangs / Videos
  • Rasteransicht mit Thumbnails, Vollbild-Lightbox bei Antippen
  • Sortierung nach Datum (neueste zuerst)
  • Aktionen: Drucken, QR-Code (Premium), E-Mail (Premium)
  • Speicherort: Eigene Bilder\BoothyPhotos\{Eventname}\

Cloud-Synchronisation#

Boothy kann Fotos nach jeder Aufnahme automatisch in den Cloud-Speicher hochladen (Premium). Bei Offline-Betrieb werden Uploads in eine Warteschlange gestellt und bei Wiederherstellung der Verbindung gesendet. Mehrere Cloud-Dienste können gleichzeitig genutzt werden. Dateien werden in Ordnern mit dem Schema {Eventname}-{Datum} organisiert.

Google Drive

Benötigt einen Service-Account-JSON-Schlüssel. Optionale Elternordner-ID für die Organisation der Uploads.

Dropbox

Benötigt einen Dropbox Access Token aus der Dropbox Developer Console.

Nextcloud

Benötigt Server-URL, Benutzername und Passwort. Verbindung über WebDAV.

Ein manueller Sync-Button ist im Admin-Bereich verfügbar, um einen sofortigen Upload aller ausstehenden Dateien auszulösen.

Gamification & Leaderboard#

Das Gamification-System von Boothy (Premium) macht dein Event interaktiv und mitreißend. Gäste registrieren sich, schließen Foto-Challenges ab und konkurrieren auf einem Live-Leaderboard.

Gäste-Registrierung (3 Schritte)

  • Schritt 1: Name (Pflicht)
  • Schritt 2: E-Mail (optional)
  • Schritt 3: Profilbild (3-Sekunden-Countdown, 300x300px)

Challenges

Jede Challenge besteht aus Name, Beschreibung, Icon und einem Punktwert (1-9999). Challenges können einzeln aktiviert oder deaktiviert werden. Ein Multi-Challenge-Modus erlaubt die Zuweisung mehrerer Challenges pro Foto. Nach jeder Aufnahme wird ein Challenge-Overlay angezeigt.

Leaderboard

Das Leaderboard zeigt die Top 3 mit Gold-, Silber- und Bronze-Hervorhebung und bis zu 10 Einträge insgesamt. Es wird sowohl auf dem Startbildschirm als auch auf dem Mirror/TV-Companion angezeigt. Ein konfigurierbares Zeitfenster steuert, wann Gamification aktiv ist.

DSGVO-Konformität: Profilbilder werden nach einer konfigurierbaren Anzahl von Tagen automatisch gelöscht (Standard: 30 Tage, 0 = nie).

Mirror / TV-Companion#

Boothy enthält einen integrierten lokalen Webserver, der eine Begleitanzeige ausliefert. Er wechselt im Zyklus zwischen Live-Galerie und Gamification-Leaderboard, mit automatischer Rotation zwischen den Ansichten.

Einrichtung

  1. 1Aktiviere das Mirror-Feature im Admin-Bereich unter "Features".
  2. 2Der Port ist konfigurierbar (Standard: 5050).
  3. 3Öffne einen Browser auf einem zweiten Display und navigiere zu: http://{IP}:{Port}/companion
  4. 4Neue Fotos werden in Echtzeit via SignalR/WebSocket gepusht.

Mirror-Funktionen

Live-Galerie

Neue Fotos erscheinen in Echtzeit via WebSocket-Push.

Leaderboard

Zeigt die Top-Spieler mit Rang, Avatar, Name und Punktzahl.

Automatische Rotation

Wechselt automatisch zwischen Galerie- und Leaderboard-Ansichten.

Zweisprachig

Unterstützt Deutsch und Englisch, synchronisiert mit Boothy Desktop-Sprache.

Admin-Bereich#

Der Admin-Bereich ist das zentrale Konfigurationszentrum von Boothy. Er ist in Tabs organisiert und bietet Sidebar-Aktionen für häufige Operationen.

Admin-Tabs

TabBeschreibung
OverviewSoftware-Status, Version, Kamera-API, GPU, Lizenz-Informationen.
SessionEvent-Name, aktives Template, Schriftart, Farbverläufe, Nutzungszeitraum, Hintergrundbilder.
Hardware & PerformanceKamera-Vorschau, Drucker-Einstellungen, Auto-Print, Bildschirmtastatur (integriert vs. Windows TabTip), Performance-Modus.
Netzwerk & SharingWLAN-Einstellungen, IP, Sharing-Optionen (QR, Drucken mit Limit, Galerie, E-Mail mit Webhook), Cloud-Sync.
FeaturesAuto-Start, Video/Boomerang, KI-Hintergrund (Premium), Sticker (Premium), Mirror, Debug-Modus, Admin-Passwort.
TemplatesTemplate-Manager und visueller Editor.
LizenzLizenz-Status, Aktivierung, Trial-Info, Deaktivierung.
GamificationEin/Aus, Multi-Challenge-Modus, Profilbild-TTL, Zeitfenster, Challenge-Verwaltung.

Sidebar-Aktionen

  • Zurück zum Kiosk: kehrt zum Hauptbildschirm zurück
  • App beenden: beendet Boothy (mit Bestätigungsdialog)
  • Fotos löschen: entfernt alle Fotos, Einstellungen bleiben erhalten
  • Factory Reset: erfordert Eingabe von "ja"/"yes", startet den Setup-Wizard neu
  • Cloud Sync jetzt: löst sofortigen Sync aus (wenn konfiguriert)
  • Auf Updates prüfen / Jetzt updaten: prüft auf neue Versionen und installiert sie

Lizenzierung#

Boothy verwendet ein Freemium-Lizenzmodell, das gegen den Lemon Squeezy Server validiert wird. Die Lizenzvalidierung erfolgt beim Start und minütlich während des Betriebs.

Freemium

Kostenlos
  • Unbegrenzte Aufnahmen
  • Maximal 50 Drucke
  • Premium-Features gesperrt
  • Ansonsten volle Funktionalität

Premium

Kostenpflichtig
  • Unbegrenzte Aufnahmen
  • Konfigurierbares Drucklimit
  • Alle Premium-Features freigeschaltet
  • QR-Code, Sticker, KI-Hintergrund, Cloud-Sync

Trial

Testversion
  • Bis zu 10 Aufnahmen
  • Alle Features zum Testen
  • Factory Reset nach Limit erzwungen

Lizenz aktivieren

  1. 1Öffne den Admin-Bereich in Boothy Desktop.
  2. 2Navigiere zum Tab "Lizenz".
  3. 3Gib deinen Lizenzschlüssel ein (nach dem Kauf per E-Mail erhalten).
  4. 4Klicke auf "Aktivieren" -- Boothy prüft den Schlüssel online gegen den Lemon Squeezy Server.
  5. 5Die Aktivierung wird bestätigt und alle Premium-Limits werden aufgehoben.

Datenspeicherung#

Boothy speichert Daten an den folgenden Orten auf deinem System:

DatenSpeicherort
Fotos / VideosEigene Bilder\BoothyPhotos\{Eventname}\
Rohdaten...\Rohdaten\
Konfiguration%AppData%\BoothyDesktop\config.json
Templates%AppData%\BoothyDesktop\templates.json
Gamification%AppData%\BoothyDesktop\gamification_state.json
Profilbilder%AppData%\BoothyDesktop\profile_images\
Lizenz%AppData%\Boothy\license.lic
Freemium State%AppData%\BoothyDesktop\freemium_state.json
Cloud Queue%AppData%\BoothyDesktop\sync_queue.json

Hilfe & Fehlerbehebung#

Die Kamera wird nicht erkannt.
Stelle sicher, dass die Kamera angeschlossen ist und nicht von einer anderen Anwendung verwendet wird. Boothy zeigt ein Fehler-Overlay mit Hinweis auf die Windows-Datenschutz-Einstellung. Das Overlay blendet sich nach 10 Sekunden automatisch aus. Im Admin-Bereich unter Hardware die Kamera-Vorschau prüfen.
Mirror/Companion zeigt "Verbinde...".
Stelle sicher, dass Boothy Desktop läuft und das Mirror-Feature aktiviert ist. Prüfe, ob beide Geräte im selben Netzwerk sind. Überprüfe, ob der konfigurierte Port (Standard: 5050) nicht durch eine Firewall blockiert wird.
Fotos sind unscharf oder von niedriger Qualität.
Überprüfe die Kameraeinstellungen im Admin-Bereich. Sorge für ausreichende Beleuchtung beim Event. Für beste Ergebnisse eine Canon oder Nikon DSLR via USB für native Verschlusssteuerung nutzen.
Der Drucker druckt nicht.
Stelle sicher, dass der Drucker angeschlossen und in Windows installiert ist. Im Admin-Bereich unter Hardware & Performance den richtigen Drucker auswählen. Prüfen, ob das Drucklimit erreicht wurde (konfigurierbar im Admin).
Cloud-Sync funktioniert nicht.
Nutze den manuellen Sync-Button im Admin-Bereich zur Diagnose. Bei Google Drive sicherstellen, dass der Service-Account-JSON gültig ist und Schreibzugriff hat. Bei Nextcloud die WebDAV-URL und Zugangsdaten überprüfen. Ausstehende Uploads werden bei Offline-Betrieb automatisch in die Warteschlange gestellt.
Hintergrundentfernung ist nicht genau.
Die Hintergrundentfernung verwendet OpenCV GrabCut-Segmentierung. Sie funktioniert am besten bei guter, gleichmäßiger Beleuchtung des Motivs und einem klar kontrastierenden Hintergrund. Ungleichmäßige Beleuchtung oder komplexe Hintergruende verringern die Genauigkeit.

Touchscreen-Bedienung

Boothy ist vollständig für Touch-Bedienung optimiert mit grossen Buttons und Touch-Gesten für Sticker-Platzierung. Eine konfigurierbare Bildschirmtastatur ist verfügbar (integriert oder Windows TabTip). Automatische Hochformat-Erkennung wird unterstützt.

Support

Wenn du keine Lösung für dein Problem findest, kontaktiere unser Support-Team: