[[Vorlage(Getestet, focal, jammy, noble)]] {{{#!vorlage Wissen [:Pakete_installieren: Installation von Programmen] [:Terminal: Ein Terminal öffnen] [:Editor: Einen Editor öffnen] [:Rechte: Rechte für Dateien und Ordner ändern] }}} [[Inhaltsverzeichnis(2)]] [[Bild(neomutt.png, 48, align=left)]] [https://neomutt.org NeoMutt] {en} ist ein textbasierter E-Mail-Client für die Konsole. Das Programm ist ein [https://neomutt.org/about.html Fork] {en} von Mutt, welcher einige Patches der Community integriert. Es handelt sich in erster Linie um [wikipedia:E-Mail-Programm:MailUserAgents], die externe Programme für das Senden ([wikipedia:Mail_Transfer_Agent:MTA]) bzw. den Empfang ([wikipedia:Mail_Delivery_Agent:MDA] und [wikipedia:Mail Retrieval Agent:MRA]) verwenden. Die in den Ubuntu Quellen bereitgestellten binaries sind mit IMAP bzw. SMTP Support compiliert, sodass diese externen Programme nicht mehr zwingend zum Einsatz kommen müssen. Der vorliegende Artikel konzentriert sich auf NeoMutt, ist aber in weiten Teilen für Mutt ebenso anwendbar. Er zielt darauf ab, die Einstiegshürde zu entschärfen und die anfängliche Verwirrung in Bezug auf die Funktionsweise zu minimieren. Um die ganze Breite vorhandener Konfigurationsmöglichkeiten auszuschöpfen, empfiehlt sich eine Konsultation der [:man:Manual Page] von '''neomuttrc''' und der zahlreichen in den Links angegebenen Quellen, wobei insbesondere das Arch wiki einen reichen Born sinnvoller Einstellungen bietet. [[Bild(./Bildschirmfoto.png, 250, right)]] = Einrichtung = == Installation == NeoMutt befindet sich in den Quellen. {{{#!vorlage Paketinstallation neomutt, universe }}} Um in Erfahrung zu bringen, mit welchen Optionen kompiliert wurde, nutzt man die Option `-v` {{{#!vorlage Befehl neomutt -v }}} Das Programm `mutt` ist über das Paket '''mutt''' ebenfalls aus den offiziellen Paketquellen installierbar. == Konfiguration von NeoMutt == Neomutt wird über die Datei '''.neomuttrc''' gesteuert und es lohnt sich, einen Blick in die [:man:manpage] und die Beispielkonfiguration in '''/usr/share/doc/neomutt/examples''' zu [:less#zless-und-bzless:werfen]. Die Datei wird an verschiedenen Orten gesucht, wobei in der [:man:manpage] der Ubuntu Version nur ein Teil davon angegeben ist. Eine robuste Lösung ist es, die Datei unter '''~/.neomutt/neomuttrc''' anzulegen und die Konfiguration in mehrere Dateien aufzuteilen. {{{#!vorlage Hinweis NeoMutt sucht in einer bestimmten [https://neomutt.org/guide/configuration.html Reihenfolge]{en} nach Konfigurationsdateien, sodass Mutts Konfigurationsdateien benutzt werden, sofern keine NeoMutt-Dateien gefunden werden. }}} Die Reihenfolge der Schritte ist nicht beliebig, weil Variablen gesetzt werden, die ihre Gültigkeit so lange behalten, bis ihnen ein neuer Wert zugewiesen wird. Alle Einstellungen lassen sich testen, indem man die Variablen im laufenden Betrieb nach [:VIM:vim]-Manier setzt: Die Eingabe eines Doppelpunktes gefolgt von dem Kommando, also Beispielsweise `:set wrap=100` '''~/.neomutt/neomuttrc''' {{{ source ~/.neomutt/global # die zuletzt eingebundene Konfiguration wird beim Start geöffnet sein source ~/.neomutt/gmailrc source ~/.neomutt/posteorc # source ~/.neomutt/color }}} '''~/.neomutt/global''' {{{ set ssl_starttls=yes set sendmail="/usr/bin/msmtp" # Falls externer MTA benutzt wird set envelope_from=yes # übergibt msmtp den richtigen Absender set edit_hdrs # Header im Editor mitbearbeiten set signature ="~/.neomutt/signatur" # Text der Signatur set attribution="%f schrieb am %d:" # Zitatkennzeichnung set sort=threads # E-Mails werden nach Gesprächsverlauf und nach Datum sortiert set sort_aux=date-sent #set sort=date # würde alternativ zuerst nach Datum sortieren set wrap=100 # Zeilenumbruch im Pager set sidebar_short_path # imap pfade im sidepanel kürzen set sidebar_visible # sidebar #set mail_check_stats # regelmäßig auf neue Mails prüfen (POP3) unset imap_passive # nicht nur bestehende IMAP Verbindung auf neue Mails prüfen #unset allow_8bit # u.U. verbesserte Darstellung von Umlauten set date_format="%a, %d. %b %y %H:%M" #set index_format="%4C %Z %D %-22.22F (%?l?%4l&%4c?) %s" # Format der Mail-Übersicht #set folder_format="%2C %8s %d %t %N %f" # Format des Datei-Browsers set pager_index_lines=10 # Anzahl der angezeigten Mails in der Übersicht set alias_file=~/.neomutt/alias # Kontakte. Normalerweise ~/.neomuttrc source ~/.neomutt/alias set reverse_alias # Im Index Name statt Absender-Adresse anzeigen, wenn er gefunden wird # Editor ist Vim im Einfügemodus auf der ersten Leerzeile mit Zeilenumbruch bei 80 Zeichen set editor="vim -c 'startinsert' -c 'set tw=80 et' -c 'set wrap' '+/^$'" }}} '''~/.neomutt/gmailrc''' {{{ set from="login@gmail.com" # Absender Adresse set realname="Log In" # Absender Name set imap_login="login@gmail.com" set imap_pass="`secret-tool lookup user login@gmail.com`" # falls kein externer MTA genutzt wird #set smtp_url="smtps://login@smtp.example.com:587/" #set smtp_pass="`secret-tool lookup user login@gmail.com`" set folder="imaps://login@imap.web.de/" # Nur wenn mehrere accounts auf dem selben Server liegen, muss das login zwingend angegeben werden. set spoolfile="=INBOX" # Posteingang mailboxes =INBOX # Auf neue Mails prüfen. Kann mehrere Pfade definieren # falls ein externer MRA genutzt wird #set folder="$HOME/Mail" #set spoolfile="=" #mailboxes = set postponed="=[Google Mail]/Entwürfe" # Entwürfe set record="=[Google Mail]/Gesendet" # Gesendet set mbox="=[Google Mail]/Archiv" # Gespeichert account-hook $folder "set imap_user=login@gmail.com imap_pass=$imap_pass" folder-hook $folder 'source ~/.neomutt/gmailrc' # makro setzen, wenn gewünscht #macro index 1 "$folder" }}} '''~/.neomutt/posteorc''' {{{ set from=login@posteo.de set realname="Log In" set imap_login="login@posteo.de" set imap_pass="`secret-tool lookup user login@posteo.de`" # falls kein externer MTA genutzt wird #set smtp_url="smtps://login@posteo.de:587/" #set smtp_pass="`secret-tool lookup user login@posteo.de`" set folder="imaps://posteo.de/" set spoolfile="=INBOX" mailboxes =INBOX # falls ein externer MRA genutzt wird #set folder="$HOME/Mail" #set spoolfile="=" #mailboxes = set postponed="=Entwürfe" set record="=Gesendet" set mbox="=Archiv" account-hook $folder "set imap_user=login@gmail.com imap_pass=$imap_pass" folder-hook $folder 'source ~/.neomutt/gmailrc' #macro index 2 "$folder" }}} === Tastatur-Abkürzungen === Um im NeoMutt-Pager Vim-Tastatur-Einstellungen zu haben, Folgendes am besten in einer via '''source ~/.neomutt/bindings''' eingebundenen Datei definieren: '''~/.neomutt/bindings''' {{{ bind index G imap-fetch-mail bind pager j next-line bind pager k previous-line bind pager g top bind pager G bottom }}} Es ist mit (groß) [[Vorlage(Tasten, J)]] [[Vorlage(Tasten, K)]] noch möglich, gleichzeitig durch den Index zu scrollen. Mit dieser Syntax lassen sich auch andere Tatstatur-Abkürzungen definieren. Details dazu in der [https://neomutt.org/guide/configuration#6-%C2%A0changing-the-default-key-bindings Dokumentation] {en}. === OAuth2 === Es gibt aktuell kaum noch Provider, die reine Nutzername/Passwort-Authentifizierung erlauben. NeoMutt kann aber mit OAuth2 umgehen – es empfiehlt sich, die aktuelle Version des Scripts herunterzuladen. Anbei befindet sich auch eine (englische) Anleitung, wie man die Einrichtung beim Provider durchführt: [https://github.com/neomutt/neomutt/tree/main/contrib/oauth2] === Passwörter === Grundsätzlich kann man Passwörter auf verschiedene Weise bereitstellen: * via [:GNOME_Schlüsselbund/:GNOME Schlüsselbund] * GPG-verschlüsselt * Klartext {{{#!vorlage Hinweis Falls sich Sonderzeichen wie `$`, `'` oder `"` im Passwortstring befinden, kann das zu unvorhergesehenen Problemen führen, die unspezifische Fehlermeldungen produzieren. }}} ==== GNOME Keyring ==== Um den Schlüsselbund von der Kommandozeile nutzen zu können, muss das entsprechende Werkzeug installiert sein: {{{#!vorlage Paketinstallation libsecret-tools, universe }}} Folgender Befehl fügt exemplarisch ein Passwort in den Schlüsselbund ein. Die Angabe des Schlüssel-Wert-Paares `service smtp` ist für `msmtp` von Belang. Sollte das IMAP-Passwort abweichen, ändere man im Duplikat einfach zu `service imap` und `--label=mutt`. {{{#!vorlage Befehl secret-tool store --label=msmtp host smtp.example.com service smtp user user@example.com }}} Das Auslesen via Kommandozeile erfolgt adäquat {{{#!vorlage Befehl secret-tool lookup user user@example.com }}} Alternativ kann auch [:Seahorse:] verwendet werden. ==== GPG ==== Folgender Befehl erstellt exemplarisch eine Passwortdatei. Zunächst wird der [:GPG-Agent:] nach dem Masterpasswort fragen. Dann gibt man das Passwort im Klartext auf der Konsole ein, gefolgt von Return (für neue Zeile) und STRG-D (für EOF) {{{#!vorlage Befehl gpg2 --output ~/config/mutt/password.my_account.gpg -c }}} ==== Klartext ==== Das Speichern von Passwörtern im Klartext (via Konfigurationsoptionen `_pass`) ist nur auf als absolut sicher eingestuften Computern zu empfehlen, jeder Nutzer mit Root-Zugriff kann diese problemlos auslesen. Falls gewünscht, sollten die Zugangsdaten auf jeden Fall in einer separaten Datei mit beschränkten Zugriffsrechten vorgehalten werden. === externer MTA === NeoMutt (und auch Mutt) sind in Ubuntu mit smtp-Unterstützung kompiliert, es kann aber auch ein externes Programm als [wikipedia:Mail_Transfer_Agent: MTA] eingesetzt werden, wie beispielsweise `msmtp`. Die [:man:manpage] ist informativ und enthält neben Beispielen auch Hinweise für die Konfiguration von NeoMutt. {{{#!vorlage Hinweis Die meisten Provider beenden ihre Unterstützung für Nutzername/Passwort-Authentifizierung. Es ist aber grundsätzlich möglich, `msmtp` mit oauth2 zu konfigurieren (siehe https://wiki.archlinux.org/title/Msmtp#OAuth2_Setup) }}} {{{#!vorlage Paketinstallation msmtp, universe msmtp-gnome, universe; bis [:20.04:] }}} Die Konfiguration geschieht über eine Datei. Es wird zunächst die benutzerspezifische, dann die systemweite Datei gesucht. Die entsprechenden Pfade bringt man per `--version` in Erfahrung: {{{#!vorlage Befehl msmtp --version }}} Die Benutzerkonfigurationsdatei liegt unter `$HOME/.msmtprc`. Der einfachste Weg ist, sie von `/usr/share/doc/msmtp/examples/msmtprc-user.example` zu kopieren und anzupassen: {{{#!vorlage Befehl cp /usr/share/doc/msmtp/examples/msmtprc-user.example ~/.msmtprc editor ~/.msmtprc }}} {{{ #Exemplarische Konfiguration für einen posteo und einen google account defaults tls on tls_starttls on # Ausschalten falls Test mit »Server schickte leere Antwort« fehlschlägt auth on # auskommentieren, wenn gewünscht: #logfile ~/.msmtp.log # logging auf stdout #logfile - # journal #syslog on account gmail host smtp.gmail.com from login@gmail.com user login@gmail.com # setzen, wenn gpg2 als Methode benutzt wird #passwordeval gpg2 --no-tty -q -d ~/.msmtp-password.gmail.gpg account posteo host posteo.de from login@posteo.de user login@posteo.de # setzen, wenn gpg2 als Methode benutzt wird #passwordeval gpg2 --no-tty -q -d ~/.msmtp-password.gmail.gpg # posteo alias account alias : posteo from alias@posteo.de #Das Posteo Konto soll das Standard-Konto werden: account default: posteo # vim: set ft=msmtp: }}} {{{#!vorlage Hinweis Wenn das Passwort im gnome-keyring [:Mutt#Passwoerter:korrekt abgelegt] ist, fragt msmtp dieses automatisch ab. }}} Der Mailversand kann wie folgt getestet werden {{{#!vorlage Befehl msmtp -a posteo --logfile=- -- empfänger@adresse.de < }}} = Bedienung = NeoMutt wird über den Befehl {{{#!vorlage Befehl neomutt }}} gestartet [2]. == Nützliche Befehle für den Einstieg == Es lohnt sich immer, einen Blick in die oberste Zeile zu werfen, dort werden einige verfügbare Befehle angezeigt. Es gilt zu beachten, dass sich die Tastenbelegungen in den verschiedenen Ansichten unterscheiden. Hat man beispielsweise eine Mail zum Lesen geöffnet, blendet [[Vorlage(Tasten, T)]] den zitierten Text ein und aus, während, wenn nur der Index sichtbar ist, die Funktion `tag-pattern` ausgeführt wird. ||<-2 rowclass="titel" tablestyle="zebra_start2" :>'''Im Index''' || || [[Vorlage(Tasten, ?)]] || Befehlsübersicht für die aktive Ansicht|| || [[Vorlage(Tasten, Enter)]] || Mailbox/E-Mail öffnen, Eingaben bestätigen, in E-Mails eine Zeile weiterblättern|| || [[Vorlage(Tasten, backspace)]] || In E-Mails zurückblättern|| || [[Vorlage(Tasten, space)]] || In E-Mails eine Seite weiterblättern bzw. nächste E-Mail öffnen|| || [[Vorlage(Tasten, -)]] || In E-Mails eine Seite zurückblättern|| || [[Vorlage(Tasten, y)]] || Liste der Mailboxen aufrufen|| || [[Vorlage(Tasten, c)]] || wechseln der Mailbox ([[Vorlage(Tasten, tab)]] Liefert eine Liste aller Mailboxen bzw. vervollständigt den Namen einer Mailbox)|| || [[Vorlage(Tasten, hoch)]],[[Vorlage(Tasten, runter)]] bzw. [[Vorlage(Tasten, k)]],[[Vorlage(Tasten, j)]]|| Zum Navigieren in Mailboxen|| || [[Vorlage(Tasten, Tab)]] || Zur nächsten ungelesenen Nachricht springen || || [[Vorlage(Tasten, =)]] || Zur ersten Nachricht springen || || [[Vorlage(Tasten, *)]] || Zur letzten Nachricht springen || || [[Vorlage(Tasten, /)]] || Nachricht suchen || || [[Vorlage(Tasten, l)]] || Ansicht auf bestimmte Nachrichten begrenzen || || [[Vorlage(Tasten, b)]] || Bounce – Nachricht weiterleiten ohne den Inhalt zu bearbeiten|| || [[Vorlage(Tasten, f)]] || Nachricht weiterleiten|| || [[Vorlage(Tasten, s)]] || Nachricht in einen anderen Ordne verschieben|| || [[Vorlage(Tasten, p)]] || [:GnuPG:GPG]-Menü öffnen|| || [[Vorlage(Tasten, a)]] || Absenderadresse in die Alias-Liste übernehmen|| || [[Vorlage(Tasten, m)]] || Mail verfassen|| || `$` || Mailbox synchronisieren || Beim Wechseln der Mailboxen mit [[Vorlage(Tasten, c)]][[Vorlage(Tasten, Tab)]] blättert jedes weitere [[Vorlage(Tasten, Tab)]] durch verschiedene Ansichten. Das selbe Verhalten zeigt die Liste der Mailboxen mit [[Vorlage(Tasten, y)]]. Dort lassen sich auch neue IMAP Ordner anlegen und löschen. Am Einfachsten allerdings legt man Ordner an, indem man bei [[Vorlage(Tasten, s)]] einen nicht existenten Zielpfad angibt. {{{#!vorlage Hinweis Bei der Angabe von Zielen muss bei IMAP statt `/` ein `.` geschrieben werden. Also statt `=mein/tief/verschachtelter/ordner` muss es heißen `=mein.tief.verschachtelter.ordner` }}} In NeoMutt lassen sich alle Tastaturbelegungen an die persönlichen Bedürfnisse anpassen. Für detaillierte Informationen über Konfiguration und Bedienung sei auf die Links verwiesen. === Tastatur-Abkürzungen für Mail-Ordner === Beim Wechseln der Ordner ist es bequem, Tastatur-Abkürzungen einzusetzen. Beispielsweise führt [[Vorlage(Tasten, c)]][[Vorlage(Tasten, !)]] in den Posteingang. {{{#!vorlage Tabelle <-2 rowclass="titel" :>Mail-Ordner Tastatur-Abkürzungen +++ Variable <:>Shortcut +++ $folder `=`, `+` +++ $spoolfile `!` +++ $mbox `>` +++ $record `<` +++ last visit `!!`, `-` +++ $HOME `~` }}} == Adressbuch == Einen Kontakt kann man erstellen, indem man ihn einfach im Format {{{#!vorlage Befehl alias BEZEICHNUNG NAME DES KONTAKTES }}} in die Alias-Datei (normalerweise '''~/.neomuttrc''') einträgt, oder in NeoMutt eine E-Mail des gewünschten Kontakts markiert und [[Vorlage(Tasten, a)]] drückt, oder mit dem Befehl {{{#!vorlage Befehl alias [ ]
}}} wobei das letzte leerzeichenseparierte Wort als Email-Adresse gilt. Nun kann man in NeoMutt als Empfänger einer neuen Mail statt der Adresse die Bezeichnung des Kontakts eingeben ([[Vorlage(Tasten, Tab)]] zur Vervollständigung). Alternativ empfiehlt sich die Verwendung des Programmes [sourceforge2:abook:], dass sich auch aus den Quellen als Paket ''abook'' beziehen lässt. = Problembehebung = == Fehler bei der Anzeige von HTML-Mails mit Firefox == Gelegentlich kann es zu einem Fehler bei der Anzeige kommen. Der Browser meldet dann '''File not found'''. In diesem Fall muss in der Datei '''~/.mailcap''' eine Verzögerung eingebaut werden: {{{ text/html; /usr/bin/sensible-browser %s && sleep 1; description=HTML Text; nametemplate=%s.html }}} was der angepassten Zeile aus '''/etc/mailcap''' entspricht. = Links = * [https://neomutt.org/ Projektseite von Neomutt] {en} * [gitlab:muttmua/mutt/-/wikis/home:Mutt Wiki mit vielen Resourcen] {en} * [http://www.mutt.org/ Projektseite von Mutt] {en} * [http://mutt.org/doc/manual/ Mutt-Handbuch] {en} * [https://wiki.archlinux.org/index.php/mutt Anleitung im Arch wiki] {en} * [sourceforge2:msmtp:Projektseite von msmtp] {en} * [sourceforge2:abook:] {en} - Adressbuch für Mutt * [https://blog.stefan-betz.net/2013/09/13/mutt-und-dieses-html/ Mutt und dieses HTML] {de} - Blogbeitrag, 09/2013 * [https://www.linux-community.de/ausgaben/linuxuser/2007/05/mutt-mit-allen-raffinessen-nutzen/ Mutt mit allen Raffinessen nutzen] {de} - Artikel LinuxUser, 05/2007 * [prolinux:artikel/2/955/mutt-konfiguration.html:Einrichtungsanleitung] {de} - auf Pro-Linux.de, 05/2003 * [https://www.linux-community.de/ausgaben/linuxuser/2008/05/mail-auf-der-kommandozeile/ mailx] {de} - alternative Möglichkeit, E-Mails (mit mailx) auf der Kommandozeile zu verschicken * [:Alpine:] – Weiterentwicklung von [wikipedia:Pine:] und Alternative zu Mutt; in den offiziellen Paketquellen enthalten #tag: Internet, Kommunikation, Email