tootgroup.py- 在 Mastodon 和 Pleroma 上模拟组帐户

这是什么？

一些社交媒体平台允许用户组发布到一个统一的“组”时间线/实例/您想要调用的任何内容。如果不向所有成员提供组的完整登录凭据，目前在 Mastodon 或 Pleroma 上是不可能的。tootgroup.py是解决这个特定用例的尝试。

tootgroup.py 组可以托管在 Mastodon 或 Pleroma 上。但是您可以从任何 ActivityPub 服务发布到组，尽管可能存在一些不兼容。目前，Mastodon、Pleroma 和 Friendica 是发布到群组的测试平台。欢迎更多测试！

它是如何工作的？

tootgroup.py必须在计算机上设置并定期运行。它从它所连接的 Mastodon/Pleroma 帐户中读取通知，并过滤它们以重新发布消息。有两种创建小组帖子的方法。可以在设置过程中启用其中之一或两者。

1. 如果群组成员在群组名称前加上感叹号（如“！@mastodon”），则会提高对群组成员的公开提及。对于来自 Friendica 的帖子，正确的语法是“！mastodon”。

2. tootgroup.py还可以查找来自群组成员的直接消息。如果一开始就@提到了该群组，则该消息将作为直接来自该群组帐户的新公共嘟嘟声重新发布。包括状态文本和媒体文件。始发用户不会公开显示。（所有组和实例管理员仍然可以看到它的强硬！）

如果两种转发方法都被禁用，tootgroup.py仍会运行但不会转发任何内容。

但是如何简单地使用它呢？

乳齿象/Pleroma

1. 写一条应该由该组提升的消息：只需在嘟嘟声中的任何位置包含“！@group_name”。

   示例：“OHAI！刚刚发现 !@mastodon thingie！”

2. 写一条应该作为来自群组的新帖子出现的消息：将“@group_name”放在直接/私人消息的开头。

   示例：“@mastodon 这里是消息文本”

友谊赛

由于它的历史和更灵活的性质，从 Friendica 发布时情况会有所不同，甚至可能会更复杂一些。然而，这是完全支持、测试和日常使用的。

1. 写一条应该由小组转发的消息：Friendica 以一种特殊的方式处理感叹号，因为它也用于解决 Friendica 论坛的功能。因此使用星号代替感叹号。只需在消息中的任何位置包含“*@group_name”即可。- 这也适用于 Mastodon/Pleroma，只是不要告诉他们 ;-)

   示例（来自 Friendica）：“哦！刚刚发现 *@mastodon 东西！”

2. 撰写应作为群组新帖子显示的消息：您可以通过限制“正常”帖子的可见性或使用个人消息菜单来发送直接消息。但是，第二种方法不适用于图像，因此首选创建可见性有限的普通帖子。您应该始终将 Title/Subject 字段留空，否则它可能无法按预期工作。将“@group_name”放在直接/私人消息的开头。

   示例：“@mastodon 这里是消息文本”

如何设置？

最简单的安装方法tootgroup.py是通过 Python 包索引 PyPI。用于pip3 install tootgroup.py安装它以及它的所有依赖项。

也可以从 https://github.com/oe4dns/tootgroup.py的 GitHub 存储库手动下载脚本。在这种情况下，还必须提供必要的依赖项：

tootgroup.py需要https://github.com/halcy/Mastodon.py以及 https://github.com/ActiveState/appdirs才能运行。通过操作系统的包管理器、pip 甚至手动安装它们。

tootgroup.py当您第一次从命令行运行它时，它将通过询问它需要的所有信息来指导您完成设置。如果出现困难，对 Python 脚本和一般命令行有点熟悉可能会有所帮助。

1. 您需要在任何 Mastodon 或 Pleroma 实例上的帐户作为您的组帐户。考虑一下是否应该将其标记为“机器人”。

2. tootgroup.py从命令行运行。

3. tootgroup.py将询问您所有需要的设置数据，并尝试通过连接到 Mastodon/Pleroma 服务器来正确设置它们。如果它不能这样做，它会告诉你，你可以重试。成功后，tootgroup.py会将配置写入其 tootgroup.conf 文件，并在下次运行脚本时从那里读取。

   存储配置的位置取决于操作系统，但将在首次运行/设置阶段显示。放置在脚本旁边的本地 tootgroup.conf 文件tootgroup.py将覆盖这些设置，但可用于开发或测试目的。

4. 如果要设置tootgroup.py多个组，可以在指定“--group GROUP_HANDLE”标志时再次运行它。然后，这将生成一个独立的配置，每次您 tootgroup.py使用此名称调用时都会读取该配置。如果您不指定任何组名，则会自动创建并使用句柄“default”

5. tootgroup.py通过在手动运行时向您的组发送直接消息和“！@mentions”来测试功能。看看事情是否按预期工作。该脚本将在每次成功运行后打印一条相应的消息。如果一切正常，请通过 cron 定期运行脚本并享受 groop-tooting！

   tootgroup.py以下是每两分钟运行一次的 crontab 条目的示例：

   */2 * * * * /path/to/tootgroup.py --group default

6. 还有防止任何嘟嘟声的“-d”或“--dry-run”命令行标志。您可以使用它来测试脚本将发布的内容。

   使用“-h”或“--help”获取有关所有可用选项的更多信息