Mail Filter - Dokumentation

Ein selbstständiger Mailfilter für IMAP-E-Mail-Accounts, ähnlich den Filtern in Thunderbird. Prüft regelmäßig auf neue E-Mails und führt Aktionen basierend auf konfigurierbaren Filterregeln aus.

Features

✅ IMAP-Integration: Unterstützt alle IMAP-Server (Gmail, Outlook, etc.)
✅ SMTP-Integration: E-Mail-Versendung für Forward/Reply (pro Account konfigurierbar)
✅ Regelmäßige Checks: Automatische Prüfung auf neue E-Mails
✅ Flexible Filter: Kriterien basierend auf Absender, Betreff, Body, Anhängen, Größe, Datum
✅ Mehrere Aktionen: Verschieben, Löschen, Weiterleiten, Antworten, Externe Scripts
✅ Prioritätssystem: Filter mit Prioritäten, mehrere Aktionen pro E-Mail möglich
✅ Anhang-Speicherung: Automatisches Speichern von Anhängen in konfigurierbare Verzeichnisse
✅ Multi-Account: Unterstützung für mehrere E-Mail-Accounts
✅ State-Management: SQLite-basiertes Tracking verarbeiteter E-Mails
✅ Lazy Loading: Body wird nur bei Bedarf geladen (Performance)
✅ CLI-Interface: Einfache Kommandozeilen-Befehle
✅ Sicherheitsfeatures: Rate Limiting, Script-Whitelist, Delete → Trash, Action-Limits
✅ Monitoring: Error-Notifications und tägliche Reports per E-Mail

Schnellstart

Installation - Installation und Setup
Konfiguration - Grundkonfiguration einrichten
Accounts - E-Mail-Accounts konfigurieren
Filter - Filterregeln erstellen
Aktionen - Aktionen konfigurieren
Verwendung - CLI-Befehle verwenden

Dokumentation

Grundlagen

Installation - Voraussetzungen und Installation
Konfiguration - Hauptkonfiguration (config.yaml)
Accounts - IMAP- und SMTP-Konfiguration
Credentials - Credentials-Verwaltung

Filter und Aktionen

Filter - Filterkriterien und -optionen
Aktionen - Verfügbare Aktionen (move, delete, forward, reply, script)
Prioritätssystem - Filter-Prioritäten
Markierungen - E-Mail-Markierungen

Verwendung

Verwendung - CLI-Befehle und Parameter
Beispiele - Praktische Beispiele

Erweiterte Themen

Sicherheit - Sicherheitsfeatures und Best Practices
State-Management - State-Datenbank und Backups
Logging - Logging und Fehlerbehebung
Entwicklung - Code-Struktur und Tests

Projektstruktur

mail-filter/
├── config/
│   ├── config.yaml          # Hauptkonfiguration
│   └── credentials/         # Credentials-Dateien
├── filters/
│   └── *.yaml               # Filterregeln
├── templates/               # Reply-Templates
├── scripts/                 # Externe Scripts
├── state/                   # SQLite-Datenbank
├── logs/                    # Log-Dateien
├── attachments/             # Gespeicherte Anhänge
├── src/                     # Quellcode
└── main.py                  # Haupteinstiegspunkt