Files
FEDEO/docs/bedienung/gmail-anhaenge-herunterladen.md
florianfederspiel afb9adb444
All checks were successful
Build and Push Docker Images / build-frontend (push) Successful in 24s
Build and Push Docker Images / build-website (push) Successful in 22s
Build and Push Docker Images / build-central-services-api (push) Successful in 22s
Build and Push Docker Images / build-central-services-admin (push) Successful in 22s
Build and Push Docker Images / build-docs (push) Successful in 1m23s
Build and Push Docker Images / build-backend (push) Successful in 29s
KI-AGENT: Gmail-Download mit Debugausgaben erweitern
2026-08-27 07:44:45 +02:00

2.1 KiB

Gmail-Anhänge herunterladen

Das Skript scripts/download-gmail-attachments.py lädt Anhänge aus einem Gmail-Postfach per IMAP herunter. Es nutzt nur Python-Standardbibliotheken.

Voraussetzungen

  • IMAP muss im Gmail-Konto aktiviert sein.
  • Für Konten mit Zwei-Faktor-Authentifizierung wird ein Gmail App-Passwort benötigt.
  • Python 3.9 oder neuer.

Beispiele

Alle Anhänge aus dem kompletten Gmail-Postfach herunterladen:

GMAIL_APP_PASSWORD="dein-app-passwort" \
python3 scripts/download-gmail-attachments.py \
  --email name@gmail.com \
  --output gmail-anhaenge \
  --group-by-message \
  --debug

Nur Anhänge ab einem bestimmten Datum herunterladen:

GMAIL_APP_PASSWORD="dein-app-passwort" \
python3 scripts/download-gmail-attachments.py \
  --email name@gmail.com \
  --since 2026-01-01 \
  --output gmail-anhaenge

Nur ungelesene Mails durchsuchen:

GMAIL_APP_PASSWORD="dein-app-passwort" \
python3 scripts/download-gmail-attachments.py \
  --email name@gmail.com \
  --search UNSEEN

Verfügbare IMAP-Postfächer anzeigen, falls [Gmail]/All Mail nicht passt:

GMAIL_APP_PASSWORD="dein-app-passwort" \
python3 scripts/download-gmail-attachments.py \
  --email name@gmail.com \
  --list-mailboxes

Wenn --password nicht gesetzt ist und GMAIL_APP_PASSWORD fehlt, fragt das Skript das Passwort interaktiv ab. Mit --debug zeigt das Skript unter anderem den Aufbau der TLS-Verbindung, den erfolgreichen Login, das ausgewählte Postfach, die Suche und die Verarbeitung jeder Mail an. Das Passwort selbst wird nie ausgegeben.

Häufige Optionen

  • Ohne --mailbox erkennt das Skript das sprachabhängige Gmail-Postfach für alle Nachrichten automatisch.
  • --mailbox "Postfachname" überschreibt die automatische Auswahl.
  • --list-mailboxes zeigt alle verfügbaren Gmail-IMAP-Postfächer an.
  • --debug aktiviert detaillierte Statusausgaben inklusive Login-Erfolg.
  • --group-by-message legt pro Mail einen Unterordner an.
  • --overwrite überschreibt vorhandene Dateien.
  • --since YYYY-MM-DD und --before YYYY-MM-DD grenzen den Zeitraum ein.