Skip to content

README.md

Latest commit

 

History

History
132 lines (105 loc) · 6.02 KB

README.md

File metadata and controls

132 lines (105 loc) · 6.02 KB
Raw

🦌 GardePro Gallery

Eine selbst gehostete Web-Galerie für GardePro Wildkameras. Die App verbindet sich automatisch per Bluetooth und WLAN mit der Kamera, lädt neue Fotos und Videos herunter und zeigt sie in einer modernen Browser-Oberfläche an.

✨ Features

  • Automatischer Sync — Verbindet sich per BLE-Wakeup → WLAN → HTTP mit der Kamera und lädt neue Medien herunter
  • Web-Galerie — React-Frontend mit Thumbnail-Grid, Lightbox, Favoriten und Papierkorb
  • Kamera-Steuerung — Einstellungen der Kamera (Foto/Video-Modus, Qualität) direkt aus dem Browser ändern
  • Immich-Integration — Automatischer Upload neuer Medien an einen Immich-Server
  • Geplanter Sync — Konfigurierbarer Intervall-Sync über APScheduler
  • Docker-fähig — Einfaches Deployment mit Docker Compose

🚀 Schnellstart

Docker Compose (empfohlen)

git clone https://github.com/CodingEmil/GardePro.git
cd GardePro/gardepro-gallery
docker compose up -d

Die Galerie ist unter http://localhost:5000 erreichbar.

Medien und Datenbank werden im Ordner ./data/ gespeichert.

Hinweis zu Bluetooth & WLAN (OS-abhängig): Docker isoliert den Hardware-Zugriff.

  • Unter Linux (z. B. Raspberry Pi, Debian): Docker kann mit entsprechenden Rechten auf lokales WLAN und Bluetooth zugreifen. In der docker-compose.yml ist am Ende ein entsprechender Block vorbereitet, den du für Linux einfach einkommentieren (die # am Zeilenanfang entfernen) musst.
  • Unter Proxmox (LXC Container): Wenn du Docker innerhalb eines LXC-Containers auf Proxmox betreibst, musst du dem Container den Bluetooth-Adapter vom Host explizit durchreichen, da er sonst im Container fehlt:
    1. Installiere bluez auf dem Proxmox Host (nicht im Container): apt install bluez
    2. Finde den Pfad zum Bluetooth-Gerät auf dem Host: find /sys/devices/ -name "*bluetooth*" oder hcitool dev
    3. Reiche das Gerät an den Container durch: pct set <vmid> --dev0 path=/pfad/zum/bluetooth/adapter (Ersetze <vmid> mit der ID deines Containers und den Pfad mit dem Ergebnis aus Schritt 2)
  • Unter Windows / macOS: Docker Desktop läuft in einer virtuellen Maschine (WSL2/Hyper-V). Der direkte Zugriff auf die PC-interne WLAN- und Bluetooth-Hardware aus dem Container heraus ist daher nicht möglich. Wenn du das Projekt auf Windows betreibst und die automatische Kamera-Verbindung nutzen willst, musst du die native Ausführung (siehe unten) verwenden.

Nativ (Windows)

Voraussetzungen: Python 3.10+ und Node.js 18+

# Repository klonen
git clone https://github.com/CodingEmil/GardePro.git
cd GardePro\gardepro-gallery

# Alles starten (Server + Frontend)
.\start.ps1

Das Startskript:

  1. Installiert Python-Abhängigkeiten (requirements.txt)
  2. Startet den Flask-Server auf Port 5000
  3. Installiert npm-Pakete und startet den Vite-Dev-Server auf Port 5173

Für den Produktions-Modus (ohne Vite-Dev-Server):

cd frontend
npm install
npm run build
cd ..
python server.py

⚙️ Konfiguration

Alle Einstellungen können über die Web-Oberfläche (Zahnrad-Icon) geändert werden:

Einstellung Beschreibung
Kamera-IP IP-Adresse der Kamera im WLAN (Standard: 192.168.8.1)
Kamera-Port HTTP-Port der Kamera (Standard: 8080)
Sync-Intervall Automatischer Sync alle X Minuten
BT MAC-Adresse Bluetooth MAC der Kamera für Wake-up
WLAN SSID/Passwort Zugangsdaten des Kamera-WLANs
Immich Server-URL, API-Key und Album-Name für Immich-Upload

Die Konfiguration wird in settings.json gespeichert (siehe settings.example.json als Vorlage).

Umgebungsvariablen (Docker)

Variable Standard Beschreibung
ARCHIVE_DIR /data/archive Verzeichnis für heruntergeladene Medien
DATA_DIR /data Verzeichnis für Datenbank und State-Dateien
TZ Europe/Berlin Zeitzone

🏗️ Architektur

┌─────────────────────────────────────────────┐
│               Browser (React)               │
│  Galerie · Lightbox · Kamera · Einstellungen│
└────────────────────┬────────────────────────┘
                     │ HTTP API
┌────────────────────┴────────────────────────┐
│             Flask Server (Python)            │
│  /api/media · /api/sync · /api/camera · ... │
├──────────────────────────────────────────────┤
│  sync.py      │ db.py (SQLite) │ immich.py  │
│  BLE + WLAN   │ Medien-DB      │ Upload API │
└───────┬───────┴────────────────┴────────────┘
        │ HTTP / BLE
┌───────┴───────┐
│  GardePro Cam │
└───────────────┘

📁 Projektstruktur

gardepro-gallery/
├── server.py              # Flask REST-API
├── sync.py                # Kamera-Sync-Engine (BLE, WLAN, Download)
├── db.py                  # SQLite-Datenbank
├── immich.py              # Immich-API-Integration
├── requirements.txt       # Python-Abhängigkeiten
├── start.ps1              # Windows-Startskript
├── Dockerfile             # Multi-Stage Docker Build
├── docker-compose.yml     # Docker Compose Konfiguration
├── frontend/              # React + Vite + TypeScript
│   ├── src/
│   │   ├── App.tsx
│   │   ├── components/    # UI-Komponenten
│   │   ├── hooks/         # React Hooks
│   │   └── utils/         # Hilfsfunktionen
│   └── package.json
└── settings.example.json  # Beispiel-Konfiguration

📜 Lizenz

MIT