Account-Konfiguration

Jeder E-Mail-Account benötigt eine separate Konfiguration in config/config.yaml. Ein Account kann sowohl IMAP (zum Abrufen) als auch SMTP (zum Senden) konfiguriert haben.

Account-Struktur

accounts:
  - name: "work"
    imap:
      # IMAP-Konfiguration
    smtp:
      # SMTP-Konfiguration (optional)
    check_interval_minutes: 5
    recovery_message_count: 50
    attachment_base_directory: "attachments/work"
    filters_file: "filters/work_rules.yaml"
    trash_folder: "Trash"
    max_actions_per_filter: 50

IMAP-Konfiguration

IMAP wird zum Abrufen von E-Mails verwendet.

imap:
  server: "imap.example.com"      # IMAP-Server-Adresse
  port: 993                        # IMAP-Port (993 für SSL, 143 für TLS)
  ssl: true                        # SSL/TLS verwenden
  credentials_file: "credentials/work.cred"  # Pfad zu Credentials-Datei
  check_folders: ["INBOX"]         # Ordner, die geprüft werden sollen
  create_folders: true             # Ordner automatisch erstellen, falls nicht vorhanden

Parameter

Parameter	Beschreibung	Beispiel
`server`	IMAP-Server-Adresse	`imap.gmail.com`
`port`	IMAP-Port (993 für SSL, 143 für TLS)	`993`
`ssl`	SSL/TLS verwenden	`true`
`credentials_file`	Pfad zu Credentials-Datei	`credentials/work.cred`
`check_folders`	Liste der zu prüfenden Ordner	`["INBOX", "INBOX.Important"]`
`create_folders`	Ordner automatisch erstellen	`true`

Häufige IMAP-Server

Gmail:

imap:
  server: "imap.gmail.com"
  port: 993
  ssl: true

Outlook/Office365:

imap:
  server: "outlook.office365.com"
  port: 993
  ssl: true

SMTP-Konfiguration

SMTP wird für forward- und reply-Aktionen benötigt. Die Konfiguration ist pro Account (analog zu IMAP).

smtp:
  server: "smtp.example.com"       # SMTP-Server-Adresse
  port: 587                        # SMTP-Port (587 für TLS, 465 für SSL, 25 für unverschlüsselt)
  use_tls: true                    # TLS verwenden (STARTTLS)
  use_ssl: false                   # SSL verwenden (nur wenn port=465)
  credentials_file: "credentials/work.cred"  # Optional: separate SMTP-Credentials
  from: "work@example.com"         # Absender-Adresse für Forward/Reply

Parameter

Parameter	Beschreibung	Beispiel
`server`	SMTP-Server-Adresse	`smtp.gmail.com`
`port`	SMTP-Port (587 für TLS, 465 für SSL)	`587`
`use_tls`	TLS verwenden (STARTTLS)	`true`
`use_ssl`	SSL verwenden (nur wenn port=465)	`false`
`credentials_file`	Optional: separate SMTP-Credentials	`credentials/work.cred`
`from`	Absender-Adresse für Forward/Reply	`work@example.com`

SMTP-Credentials

Gleiche Credentials wie IMAP: Setze credentials_file auf die gleiche Datei wie IMAP
Separate SMTP-Credentials: Erstelle separate Credentials-Datei und referenziere sie
Automatischer Fallback: Wenn credentials_file fehlt, werden IMAP-Credentials verwendet

Beispiele für verschiedene Provider

Gmail:

smtp:
  server: "smtp.gmail.com"
  port: 587
  use_tls: true
  use_ssl: false
  credentials_file: "credentials/gmail.cred"
  from: "yourname@gmail.com"

Outlook/Office365:

smtp:
  server: "smtp.office365.com"
  port: 587
  use_tls: true
  use_ssl: false
  credentials_file: "credentials/outlook.cred"
  from: "yourname@outlook.com"

Provider mit SSL (Port 465):

smtp:
  server: "smtp.example.com"
  port: 465
  use_tls: false
  use_ssl: true
  credentials_file: "credentials/example.cred"
  from: "yourname@example.com"

Account-Parameter

Parameter	Beschreibung	Standard
`check_interval_minutes`	Intervall für E-Mail-Checks (überschreibt General-Setting)	`5`
`recovery_message_count`	Anzahl der letzten Nachrichten, die bei State-Verlust erneut verarbeitet werden	`50`
`attachment_base_directory`	Basis-Verzeichnis für gespeicherte Anhänge	-
`filters_file`	Pfad zur Filterregel-Datei	-
`trash_folder`	Ordner für gelöschte E-Mails (wenn `delete` verwendet wird)	`Trash`
`max_actions_per_filter`	Max. Aktionen pro Filter pro Durchlauf (0 = unbegrenzt)	`0`

Trash-Ordner

E-Mails werden nicht wirklich gelöscht, sondern in einen Trash-Ordner verschoben:

accounts:
  - name: "work"
    trash_folder: "Trash"  # Standard-Trash
  - name: "gmail"
    trash_folder: "[Gmail]/Trash"  # Gmail-spezifischer Trash-Ordner

Vollständiges Beispiel

accounts:
  - name: "work"
    imap:
      server: "imap.example.com"
      port: 993
      ssl: true
      credentials_file: "credentials/work.cred"
      check_folders: ["INBOX", "INBOX.Important"]
      create_folders: true
    smtp:
      server: "smtp.example.com"
      port: 587
      use_tls: true
      use_ssl: false
      credentials_file: "credentials/work.cred"
      from: "work@example.com"
    check_interval_minutes: 5
    recovery_message_count: 50
    attachment_base_directory: "attachments/work"
    filters_file: "filters/work_rules.yaml"
    trash_folder: "Trash"
    max_actions_per_filter: 50

Weitere Informationen

Konfiguration - Hauptkonfiguration
Filter - Filterregeln erstellen
Aktionen - Verfügbare Aktionen