CameraSave/README.md

CameraSave Docker Container

Ein Python-Skript, das automatisch Video-Anhänge aus E-Mails herunterlädt und in einer strukturierten Ordnerhierarchie speichert.

🚀 Schnellstart mit Docker

1. Repository klonen/vorbereiten

cd /Users/rxf/Projekte/CameraSave

2. Umgebungsvariablen konfigurieren

# Die .env Datei ist bereits erstellt - passe sie an deine Zugangsdaten an
nano .env
# oder
code .env

Wichtig: Bearbeite die .env Datei und trage deine echten E-Mail-Zugangsdaten ein!

3. Container mit Docker Compose starten

docker-compose up -d

4. Logs überprüfen

docker-compose logs -f camerasave

🐋 Manuelle Docker-Befehle

Image erstellen

docker build -t camerasave .

Container ausführen

docker run -d \
  --name camerasave \
  -v $(pwd)/videospeicher:/app/videospeicher \
  -e EMAIL_USER="deine-email@domain.de" \
  -e EMAIL_PASS="dein-passwort" \
  camerasave

Einmalige Ausführung

docker run --rm \
  -v $(pwd)/videospeicher:/app/videospeicher \
  -e EMAIL_USER="deine-email@domain.de" \
  -e EMAIL_PASS="dein-passwort" \
  camerasave

📁 Ordnerstruktur

Das Skript erstellt automatisch folgende Struktur:

videospeicher/
├── 2025/
│   ├── 01/
│   │   ├── 15/
│   │   │   ├── 01_20250115123456000.mp4
│   │   │   └── ...
│   │   └── ...
│   └── ...
└── ...

⚙️ Konfiguration

Umgebungsvariablen

• IMAP_SERVER: IMAP-Server (Standard: secureimap.t-online.de)
• IMAP_PORT: IMAP-Port (Standard: 993)
• EMAIL_USER: E-Mail-Adresse
• EMAIL_PASS: E-Mail-Passwort (empfohlen: App-spezifisches Passwort)
• SAVE_DIR: Speicherverzeichnis (Standard: /app/videospeicher)

Automatische Bereinigung

• Dateien älter als 365 Tage werden automatisch gelöscht
• Leere Ordner werden entfernt

🔒 Sicherheitshinweise

1. App-spezifische Passwörter verwenden: Erstelle ein App-spezifisches Passwort für dein E-Mail-Konto
2. Umgebungsvariablen nutzen: Speichere Zugangsdaten nicht im Code
3. Volume-Backups: Sichere regelmäßig das videospeicher Volume

🛠 Wartung

Container neustarten

docker-compose restart

Container stoppen

docker-compose down

Logs anzeigen

docker-compose logs camerasave

Container-Status prüfen

docker-compose ps

🐛 Troubleshooting

E-Mail-Verbindungsfehler

• Überprüfe IMAP-Server und Port
• Stelle sicher, dass IMAP aktiviert ist
• Verwende App-spezifische Passwörter

Berechtigung-Fehler

# Berechtigungen für videospeicher-Ordner setzen
sudo chown -R $(id -u):$(id -g) videospeicher/

Container-Logs überprüfen

docker logs camerasave