跳转到主要内容

CLI用于从Hyperkitty同步本地Maildir中的MailingList存档。

项目描述

HKsync

HKsync,即Hyperkitty-Sync,是一个简单的客户端,可以从Hyperkitty下载公共邮件列表的存档到本地的Maildir,使用您喜欢的电子邮件客户端阅读。

您不需要订阅MailingList来下载存档。由于我们只下载公共邮件列表,因此不需要任何形式的身份验证。我们使用Hyperkitty的导出API下载作为mbox的电子邮件,然后填充本地的Maildir。

警告:目前处于alpha阶段,尽管作者已经测试过它适用于简单的情况.

安装

目前,HKsync处于alpha阶段。要下载和使用,您需要从git仓库下载。以下是说明

# Clone the git repo.
$ git clone https://gitlab.com/mailman/hksync

# Create a virtualenv and install dependencies.
$ python3 -m venv hksync

# Download the dependencies.
$ source hksync/bin/activate
$ python setup.py install

使用方法

HKsync允许您添加各种邮件列表,然后使用单个命令从每个列表同步,这可以作为周期性的cron作业使用。它不提供任何定期运行的机制,因为已经有许多其他工具可以定期运行命令,如Cron或Systemd。

添加新的邮件列表:

$ hksync add --server https://myserver.com/hyperkitty --mlist mylist@myserver.com

您可以使用以下命令列出所有已添加的邮件列表:

$ hksync list

您可以使用以下命令删除邮件列表:

$ hksync remove mylist@myserver.com

最后,您可以使用以下命令同步您的电子邮件:

$ hksync sync

这将只同步过去1天的电子邮件。可选地,您可以提供--days n参数来同步每个列表过去n天的电子邮件。

您还可以传递--mlist mylist@myserver.com来同步仅一个服务器而不是所有服务器的电子邮件。

阅读电子邮件

您可以使用您喜欢的电子邮件客户端来阅读这些电子邮件,因为我们使用的是标准的Maildir格式,大多数客户端都支持。

mutt

这是一个用于在流行命令行电子邮件客户端mutt中阅读电子邮件的示例配置。

# ~/.muttrc
set mbox_type=Maildir
set folder="~/hksync"
set mbox="~/hksync"
set spoolfile="~/hksync"

之后,您只需在终端中运行mutt即可读取您下载的邮件列表中的电子邮件。

如果您不想修改配置,可以直接运行

$ mutt -f ~/hksync

支持