Alpine + IMAP offline na macOS

Instalacja offlineimap

Zatem najpierw zainstaluję offlineimap-a za pomocą Homebrew:

brew install offlineimap

Konfiguracja kilku kont

Przykładowa konfiguracja dwóch kont (foo i bar) w .offlineimaprc:

[general]
accounts = foo,bar
# The pre-defined options are:
# Blinkenlights -- A fancy (terminal) interface
# TTYUI         -- a text-based (terminal) interface
# Basic         -- Noninteractive interface suitable for cron'ing
# Quiet         -- Noninteractive interface, generates no output
#                  except for errors.
# MachineUI     -- Interactive interface suitable for machine
ui = quiet

#####   FOO   ####################
[Account foo]
localrepository = Local_foo
remoterepository = Remote_foo
# Jak często sprawdzać pocztę (minuty)
autorefresh = 1
# Zrób 10 szybkich synchronizacji zanim zrobisz pełną
quick = 10
[Repository Local_foo]
type = Maildir
localfolders = ~/POCZTA/FOO
# kasuj na serwerze co skasuje lokalnie
sync_deletes = yes
[Repository Remote_foo]
type = IMAP
remotehost = mail.foo.pl
remoteuser = trompka@foo.pl
starttls = yes
sslcacertfile = /usr/local/etc/openssl/cert.pem

#####   BAR    ####################
[Account bar]
localrepository = Local_bar
remoterepository = Remote_bar
autorefresh = 1
quick = 10
[Repository Local_bar]
type = Maildir
localfolders = ~/POCZTA/BAR
sync_deletes = yes
[Repository Remote_bar]
type = IMAP
remotehost = mail.bar.com
remoteuser = trompka
starttls = yes
cert_fingerprint = 4375fcdalefh952z3b307f84350dupaec103ea62b32zbita

#####   BAZ    ####################
[Account baz]
localrepository = Local_baz
remoterepository = Remote_baz
...

Jak widać z powyższego, poczta jest pobierana z serwera i zachowywana w podfolderach w ~/POCZTA.

Skrypty dla Launchd uruchamiające agentów offlineimapa

W folderze ~/Library/LaunchAgents/ utworzyłem plisty dla każdego konta. Przykładowo dla konta FOO plik wygląda tak:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>local.alpine.foo</string>
    <key>OnDemand</key>
    <true/>
    <key>ProgramArguments</key>
    <array>
        <string>~/bin/offlineimap</string>
        <string>-a foo</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <dict>
        <key>NetworkState</key>
        <true/>
    </dict>
    <key>StandardInPath</key>
    <string>/tmp/offlineimap-foo.stdin</string>
    <key>StandardOutPath</key>
    <string>/tmp/offlineimap-foo.stdout</string>
    <key>StandardErrorPath</key>
    <string>/tmp/offlineimap-foo.stderr</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>~/bin:/bin:/usr/bin:/usr/local/bin</string>
    </dict>
</dict>
</plist>

Launchd-em ładuję jeszcze dodatkowy skrypt, którego plist jest poniżej:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple Computer//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>local.poczta-ok</string>
    <key>Program</key>
        <string>~/bin/alpine_czy_poczta_ok.sh</string>
    <key>RunAtLoad</key>
    <true/>
    <key>StartInterval</key>
    <integer>60</integer>
    <key>StandardInPath</key>
    <string>/tmp/poczta-ok.stdin</string>
    <key>StandardOutPath</key>
    <string>/tmp/poczta-ok.stdout</string>
    <key>StandardErrorPath</key>
    <string>/tmp/poczta-ok.stderr</string>
    <key>EnvironmentVariables</key>
    <dict>
        <key>PATH</key>
        <string>~/homebrew/bin:/bin:/usr/bin:/usr/local/bin</string>
    </dict>
</dict>
</plist>

A sam skrypt wygląda tak:

#!/bin/bash

SERVERS=(foo bar)

for server in ${SERVERS[*]}
do
    FILE="/tmp/offlineimap-$server.stdout"
    if [ -s $FILE ]
    then
        MSG=`tail -n 1 $FILE`
        ANSWER="$(~/bin/alerter -message "$MSG" -closeLabel POKAŻ -title "`echo $server | tr '[:lower:]' '[:upper:]'`" -sound default -actions NAPRAW -timeout 10)"
    fi
    if [ "$ANSWER" == "POKAŻ" ]
    then
        ANSWER="$(~/bin/alerter -message "`tail -n 4 $FILE`" -closeLabel ZAMKNIJ -title "`echo $server | tr '[:lower:]' '[:upper:]'`" -sound default -actions NAPRAW -timeout 10)"
    fi
    if [ "$ANSWER" == "NAPRAW" ]
    then
        rm -f $FILE
        touch $FILE
    fi
    if [ "$ANSWER" == "@TIMEOUT" ]
    then
        rm -f $FILE
        touch $FILE
    fi
done

Zadaniem tego skryptu jest wykrywanie błędów offlineimapa i pokazywanie ich w postaci Notification (za pomocą alertera: https://github.com/alloy/terminal-notifier) oraz umożliwienia podstawowej ich obłsugi. Polega to na ich kasowaniu i tworzeniu. ;)

Jest jeszcze jeden skrypt, którym od czasu do czasu przeładowuję offlineimapa, nie dodałem go do obsługi bo już się praktycznie przeniosłem na Macbooka pod Debiana, a tam wszystko działa bez zarzutu. Ten skrypt to taki prymityw:

#!/bin/sh

LISTA=`ls -1 ~/Library/LaunchAgents/*.alpine.*.plist`
for i in $LISTA; do
    launchctl unload $i
done
for i in $LISTA; do
    launchctl load $i
done
launchctl unload ~/Library/LaunchAgents/local.poczta-ok.plist
launchctl load ~/Library/LaunchAgents/local.poczta-ok.plist

Instalacja Alpine

Alpine można zaisntalować z paczki, ja jednak wolałem skompilować go ze źródeł, aby wyposażyć swoją wersję w aktualne patche.

Instalacja paczki:

brew install alpine

Instalacja ze źródeł przebiega następująco:

mkdir Alpine
cd Alpine
wget http://alpine.x10host.com/alpine/release/src/alpine-2.22.tar.xz
tar zxvf alpine-2.22.tar.xz
wget http://alpine.x10host.com/alpine/patches/alpine-2.22/all.patch.gz
gunzip all.patch.gz
cd alpine-2.22
patch -p 1 < ../all.patch
xcode-select --install # instalacja "command line tools" w macOS-ie
./configure  --disable-debug --with-passfile=.pine-passfile
make
sudo make install

Warto odwiedzić stronę http://alpine.x10host.com/alpine/ i poczytać co zmieniają w Alpinie poszczególne łaty.

Konfiguracja Alpine

Mój plik jest bardzo długi, więc skupię się na najważnieszych ustawieniach, których Alpine szuka w ~/.pinerc.

Podstawową rzeczą jest podanie serwera wysyłającego pocztę:

smtp-server=mail.foo.pl:587/tls/user=trompka@foo.pl

Następną mega-ważną sprawą jest prawidłowe ustawienie ścieżek do plików poczty pobranych przez offlineimapa, u mnie każde konto ma własny podfolder w folderze ~/POCZTA, czyli dla trzech kont foo, bar i baz, wygląda to tak:

~
 |____POCZTA
      |____FOO
      |____BAR
      |____BAZ

Zatem dla konta FOO (mojego domyślnego) ścieżka do Inboxa to:

inbox-path=#md/POCZTA/FOO/inbox

Pozostałe Inboksy są w tzw. kolekcji (dodałem konto BAZ, żeby łatwiej było zrozumieć):

# Lista pozostałych Inboxów, poza głównym
incoming-folders=#md/POCZTA/BAR/inbox, #md/POCZTA/BAZ/inbox

# Lista folderów, do których trafiają zachowane emaile, pierwszy jest folderem domyślnym (w moim pzypadku: dla konta FOO)
folder-collections=FOO #md/POCZTA/FOO/[],
        BAR #md/POCZTA/BAR/[],
        BAZ #md/POCZTA/BAZ/[]

# Ścieżka względna do homedira, w której leżą foldery z moją pocztą
maildir-location=POCZTA

Jeszcze ustawienie wymuszające na Alpine, żeby po starcie wyświetlał indeks emaili w Inboksie i podświetlił najnowszy email:

initial-keystroke-list=I,
        j,
        ^v

Alpine można bardzo ściśle dopasować do własnych przyzwyczajeń ale wymaga to porządnego zapoznania się z opcjami dostępnymiu w programie, przy każdej z nich znajduje się obszerna Pomoc w języku angielskim. Naprawdę warto to przeczytać, serdecznie polecam tzw. Role pozwalające na kolorowanie emaili czy uruchamianie własnych poleceń np. na podstawie adresu nadawcy, itp.