Fotobox

Achtung: Diese Version ist eine Vorab-/Testversion (Pre-Release) und nicht für den Produktiveinsatz geeignet!

Kurzbeschreibung

Die Fotobox ist ein flexibles, webbasiertes System für Events, Partys und Feiern. Nutzer können direkt Fotos aufnehmen, diese in einer Galerie ansehen und – sofern ein geeigneter Drucker vorhanden ist – direkt ausdrucken. Die Oberfläche bietet einen Aufnahmemodus und eine Galerieansicht. Optional können Gäste auch Fotos von ihrem eigenen Handy hochladen; diese werden in der Galerie in einem separaten Ordner unter dem vom Nutzer gewählten Namen angezeigt. Alle Bilder und Uploads werden zentral in einer Datenbank verwaltet. Die detaillierte Beschreibung der Funktionen und Konfigurationsmöglichkeiten findet sich in der Projektdokumentation.

Inhaltsverzeichnis

• Features
• Voraussetzungen
• Installation
• Schnellstart
• Konfiguration
• Update und Deinstallation
• Dokumentation
• Beitrag
• Lizenz
• Kontakt

Hinweis für Entwickler

Abhängigkeitenverwaltung

Alle Abhängigkeiten werden zentral in den folgenden Dateien verwaltet:

• conf/requirements_python.inf: Python-Paketabhängigkeiten
• conf/requirements_system.inf: Systempaketabhängigkeiten

Gemäß unserer Projekt-Policy dürfen neue Abhängigkeiten nicht direkt installiert werden (z.B. mit pip install oder apt install), sondern müssen in den entsprechenden Requirements-Dateien definiert werden. Details finden Sie in den Policies.

Ausführungsrechte für Shell-Skripte

Bei direkter Entwicklung am Repository müssen Sie sicherstellen, dass alle Shell-Skripte ausführbare Berechtigungen haben. Nach dem Klonen des Repositories:

# Alle Shell-Skripte ausführbar machen
chmod +x backend/scripts/*.sh

Bei der regulären Installation mit install.sh werden diese Berechtigungen automatisch gesetzt.

Features

• Fotos direkt über die Fotobox aufnehmen
• Galerieansicht für alle aufgenommenen und hochgeladenen Fotos
• Fotos direkt ausdrucken (sofern Drucker vorhanden)
• Aufnahmebildschirm (Kamera-Modus) und Galerie-Modus
• Optional: Upload von Fotos über das Handy (mit Username-Abfrage)
• Hochgeladene Fotos werden in separatem Ordner mit Geräte-ID gespeichert
• In der Galerie werden Uploads als 'Bilder von [Username]' angezeigt
• Zentrale Verwaltung aller Bilder und Uploads über eine Datenbank
• Trennung und Kennzeichnung von lokalen Aufnahmen und Uploads in der Galerie
• Verwaltung, Update und Deinstallation bequem über die Weboberfläche (WebUI)

Voraussetzungen

• Unterstützte Betriebssysteme: Debian/Ubuntu (getestet), andere Linux-Distributionen mit Anpassung möglich
• Python 3.8 oder neuer
• Systempakete: git, lsof, nginx, python3-venv, python3-pip, sqlite3 (Hinweis: Die notwendigen Systempakete werden bei der Installation über das Installationsskript automatisch mit installiert)
• Optional: Drucker mit Linux-Unterstützung für Druckfunktion
• Webbrowser für die Nutzung der Weboberfläche
• Netzwerkzugang für Upload-Funktion (optional)

Installation

Hinweis: Das Repository muss zunächst geklont werden, bevor die Installation durchgeführt werden kann. Die Installationsschritte sind wie folgt:

1. Repository klonen (Zielverzeichnis frei wählbar, z.B. /opt/fotobox):

   sudo git clone https://github.com/DirkGoetze/MyFotoBox.git /opt/fotobox

2. In das Projektverzeichnis wechseln und das Installationsskript ausführbar machen:

   cd /opt/fotobox
   sudo chmod +x install.sh

3. Installationsskript als root/Admin ausführen:

   sudo ./install.sh

4. Folgen Sie den Anweisungen auf dem Bildschirm, um die Installation abzuschließen.

Für eine ausführliche Anleitung siehe das BENUTZERHANDBUCH

Schnellstart

Nach erfolgreicher Installation:

1. Öffnen Sie einen Webbrowser und rufen Sie die Fotobox-Oberfläche auf:

   • Lokal: http://localhost oder http://localhost:8080 (je nach konfiguriertem Port)
   • Im Netzwerk: http://<IP-Adresse> oder http://<IP-Adresse>:8080

2. Beim ersten Start werden Sie zur Ersteinrichtung weitergeleitet:

   • Legen Sie ein Administrator-Passwort fest
   • Konfigurieren Sie grundlegende Einstellungen (Eventname, Kamera, etc.)

3. Nach der Ersteinrichtung können Sie sofort Fotos aufnehmen und die Galerie nutzen

Konfiguration

Die gesamte Konfiguration erfolgt über die Einstellungsseite der Weboberfläche:

1. Rufen Sie die Einstellungsseite auf (settings.html)
2. Melden Sie sich mit Ihrem Administrator-Passwort an
3. Hier können Sie anpassen:
   • Event-Einstellungen (Name, Datum)
   • Anzeigeoptionen (Darkmode, Timeouts)
   • Kamera-Einstellungen
   • Netzwerk- und Systemeinstellungen

Detaillierte Informationen finden Sie im Benutzerhandbuch

Update und Deinstallation

Die Verwaltung, das Update und die Deinstallation der Fotobox erfolgen ausschließlich über die Weboberfläche (WebUI). Melden Sie sich dazu in den Einstellungen mit Ihrem Administrator-Passwort an und nutzen Sie die entsprechenden Funktionen im Bereich "System". Technische Kenntnisse sind dafür nicht erforderlich. Detaillierte Anweisungen zu Update und Deinstallation finden Sie im BENUTZERHANDBUCH.

Dokumentation

• BENUTZERHANDBUCH: Ausführliche Installations- und Nutzungsanleitung sowie Informationen zu Update und Deinstallation
• ENTWICKLERHANDBUCH: Technische Details zur Architektur und Entwicklungsrichtlinien

Beitrag

Beiträge, Fehlerberichte und Feature-Vorschläge sind willkommen! Bitte nutze dazu das Issue-Management von GitHub. Pull Requests werden gerne entgegengenommen, sofern sie klar dokumentiert sind und das Projekt sinnvoll erweitern.

Bitte beachte: Dies ist ein Hobby-Projekt ohne Anspruch auf Support oder regelmäßige Weiterentwicklung. Es besteht kein Anspruch auf Fehlerbehebung oder Unterstützung. Für Fragen und Diskussionen steht ausschließlich das Issue-System zur Verfügung.

Lizenz

Dieses Projekt steht unter der MIT-Lizenz. Siehe LICENSE für Details.

Hinweis: Für den Betrieb werden weitere Open-Source-Komponenten (z. B. NGINX, Python) benötigt. Bitte beachten Sie die jeweiligen Lizenzbedingungen der eingesetzten Fremdsoftware (in der Regel Open Source, siehe Distribution/Paketquelle).

Kontakt

Bei Fragen oder Problemen bitte ein Issue auf GitHub eröffnen. Persönlicher Support oder E-Mail-Kontakt ist nicht möglich.

Danksagung

Danke an alle Open-Source-Entwickler, deren Tools und Software dieses Projekt ermöglichen.