查理·布朗 0.1.1

安装和使用

尽管查理·布朗没有程序化接口，但它作为Python包（用Hy编写）分发。使用命令 pip install charlie_brown（唯一不是自动安装的依赖项是KDialog）通过pip安装它，并使用 python3 -m charlie_brown 运行它。查理·布朗不会将自己作为守护进程运行，但我喜欢使用像 nohup python3 -m charlie_brown 2>/tmp/charlie-brown-debug >/dev/null & 这样的命令来守护它。

为了始终运行，查理·布朗需要一个JSON配置文件，您应该将其放在 $XDG_CONFIG_HOME/charlie_brown.json。以下是一个示例

{
    "tempfile": "/tmp/charlie-brown",
    "server": "imap.example.com",
    "username": "igelfeldm",
    "password": "hunter2",
    "folder_monitor": "INBOX",
    "folder_trash": "Trash",
    "max_itemized_messages": 10,
    "global_timeout_seconds": 10,
    "idle_timeout_minutes": 5,
    "login_interval_minutes": 10,
    "body_preview_bytes": 256,
    "kdialog_max_word_len": 40
}

所有选项都是必需的。它们的意义如下

tempfile

临时文件的保存路径。这用于记录哪些消息已被报告。对于查理·布朗来说，要考虑一条消息是新消息，它必须既没有被记录在这里，也没有在IMAP端被标记为已读。

服务器

您的IMAP服务器的主机名。

用户名，密码

服务器的凭证。

folder_monitor

用于监视新消息的IMAP文件夹。

folder_trash

点击“垃圾箱”时，将文件放入的IMAP文件夹。

max_itemized_messages

预览的消息数量。如果查理·布朗一次要报告的消息超过这个数量，你只会得到一个计数，而不是每个消息的对话框。

global_timeout_seconds

IMAP操作的一般超时值。

idle_timeout_minutes

IDLE等待的超时时间。

login_interval_minutes

再次登录前要等待的最大时间。

body_preview_bytes

为制作预览而检索的每条消息体中的字节数。

kdialog_max_word_len

在插入换行符之前，消息预览中连续非空白字符的最大数量，以解决KDialog的行为，如果单词太长，则截断整个对话框内容。如果您不使用像我一样的大字体，您可能可以将此值设置得更高。

琐事

尽管这个存储库的第一个提交是在2023年，但查理·布朗是我仍在使用的最老的代码库之一。它始于不晚于2007年的Perl脚本。

许可证

本程序版权所有 © 2023 Kodi B. Arfer。

本程序是自由软件：您可以在自由软件基金会发布的GNU通用公共许可证的条款下重新分发和/或修改它，无论是许可证的第3版，还是（根据您的选择）任何较新版本。

本程序是在希望它将是有用的前提下分发的，但不提供任何保证；甚至没有关于适销性或适用于特定目的的暗示性保证。有关详细信息，请参阅GNU通用公共许可证。