Gomphotherium в терминале: клиент федиверса

Логотип Mastodon на размытом синем фоне

Что такое федиверс и зачем ActivityPub

Федиверс — это распределённая сеть независимых серверов (инстансов), которые общаются друг с другом по открытому протоколу ActivityPub. Коротко:

ActivityPub — протокол для федерации социальных действий (посты, ответы, подписки). Определение: открытый стандарт для взаимодействия между серверами и клиентами.
Инстанс — отдельный сервер в федиверсе (например, Mastodon, Pleroma и другие).
TUI — текстовый пользовательский интерфейс, удобен для работы в терминале или по SSH.

Важно: из-за децентрализованной архитектуры каждый инстанс может иметь свои политики, ограничения и настройки модерации.

Зачем использовать федиверс из терминала?

Коротко — если вы часто работаете в терминале или подключаетесь к удалённым машинам по SSH, терминальный клиент позволит вам просматривать ленты, отвечать, ретвитить (boost) и публиковать посты без перехода в браузер. Плюсы:

Низкие системные требования и быстрая работа.
Работа по SSH без графического интерфейса.
Простая автоматизация (скрипты, aliases).

Ограничения:

Ограниченная поддержка медиа (загрузка изображений может быть сложнее).
Некоторые функции (например, сложные настройки профиля) удобнее в веб-интерфейсе.

Быстрая проверка перед установкой

Убедитесь, что у вас Linux и доступ к терминалу.
Проверьте установлен ли Go: выполните go version. Если Go нет — установите через пакетный менеджер вашей системы.
Проверьте, что у вас есть учётная запись на Mastodon/другом инстансе и доступ к веб-браузеру для авторизации.

Важное: gomphotherium использует API вашего инстанса. Для авторизации потребуется временный код, который вы получите в браузере.

Как установить gomphotherium на Linux — пошагово

Клонирование и установка gomphotherium на Linux

Клонируйте репозиторий с GitHub:

git clone https://github.com/mrusme/gomphotherium.git

Перейдите в папку проекта:

cd gomphotherium

Соберите программу (Makefile):

make

Создайте символьную ссылку для удобного запуска из любой директории:

sudo ln -s ~/gomphotherium/gomphotherium /usr/bin/gomphotherium

Совет: если вы собрали в другом каталоге, укажите соответствующий путь в команде ln.

Аутентификация и первые шаги

Перед запуском нужно авторизовать приложение на вашем инстансе Mastodon. Выполните:

gomphotherium authenticate https://your-mastodon-instance-url.com

Аутентификация gomphotherium на Mastodon

В ответ вы получите URL — скопируйте и вставьте его в браузер.
Авторизуйтесь в своём аккаунте на инстансе и нажмите Authorize.
Скопируйте код аутентификации (authorization code) и вставьте его в терминале по запросу.

Проверка кода аутентификации и пробела перед export

Внимание: после вставки строки, которую возвращает gomphotherium, убедитесь, что между URL и словом export есть пробел. Если пробела нет — вставьте его вручную, иначе команда может сломаться.

Запуск интерфейса и базовые команды

Интерфейс gomphotherium TUI

Запустить TUI:

gomphotherium tui

Описание взаимодействия:

При подключении в текстовом поле появляется анимация, затем метка успешного входа и ваше имя пользователя.
Прокрутка ленты: стрелки вверх/вниз.
Режимы: “normal” (просмотр) и “command” (ввод команд). Для перехода в командный режим нажмите Shift + ; (точка с запятой).

Частые команды (справочник):

?                   # Справка по командам
home                # Переключиться на домашнюю ленту
local               # Лента локального инстанса
public              # Публичная лента
notifications       # Уведомления
toot <текст>        # Опубликовать публичный пост
tootprivate <текст> # Опубликовать приватный пост
tootunlisted <текст># Опубликовать невидимую в публичной ленте запись
boost           # Поделиться (boost) постом по его id
reply  <текст>  # Ответить на пост

Для полного списка введите ? в интерфейсе.

Чек-лист: как проверить, что всё работает (Критерии приёмки)

Команда gomphotherium tui запускает TUI без ошибок.
Вы видите своё имя пользователя в верхней части интерфейса.
Прокрутка ленты работает клавишами вверх/вниз.
Команда toot публикует пост на вашем инстансе.
Вы можете переключаться между home/local/public/notifications.

Отладка и частые проблемы

Ошибка “command not found”: проверьте, правильно ли создан симлинк /usr/bin/gomphotherium и что файл бинарника существует.
Проблемы с аутентификацией: убедитесь, что вы используете правильный URL инстанса и правильно вставили код авторизации.
Код аутентификации возвращается, но команда не выполняется: проверьте, есть ли пробел между URL и командой export как указано выше.
Проблемы с загрузкой медиа: некоторые инстансы ограничивают загрузку через API или требуют дополнительных настроек; в этом случае используйте веб-интерфейс для загрузки медиа.

План отката (Rollback)

Если нужно удалить gomphotherium и отменить авторизацию:

Удалите символьную ссылку:

sudo rm /usr/bin/gomphotherium

Удалите каталог с репозиторием, если он больше не нужен:

rm -rf ~/gomphotherium

При необходимости отозовите авторизацию приложения через веб-интерфейс вашего инстанса (на странице настроек приложений вашего аккаунта).

Безопасность и конфиденциальность

Токены доступа: gomphotherium хранит токен, полученный во время авторизации. Обращайтесь с ним как с паролем.
Минимизируйте привилегии: при возможности просматривайте, какие права (scopes) запрашивает приложение, и согласовывайте их с практикой на вашем инстансе.
GDPR/конфиденциальность: федиверс распределён. Перед публикацией учитывайте, что копии вашего контента могут храниться на разных инстансах.

Замечание: если вы используете корпоративную или чувствительную учётную запись, проконсультируйтесь с администратором инстанса о политике доступа приложений.

Альтернативные подходы и когда терминал не подходит

Если нужна полноценная работа с медиа, настройками профиля или модерацией — используйте веб-интерфейс инстанса или полноценное графическое приложение.
Если вы не хотите устанавливать ПО локально — рассмотрите веб-порталы и мобайл-приложения.
Если требуется интеграция в CI/CD или автоматизация публикаций — лучше использовать серверные скрипты с официальными API и безопасным хранением токенов.

Быстрый SOP: от клонирования до первого тоута (сокращённо)

git clone https://github.com/mrusme/gomphotherium.git
cd gomphotherium && make
sudo ln -s ~/gomphotherium/gomphotherium /usr/bin/gomphotherium
gomphotherium authenticate https://your-instance
gomphotherium tui -> переключиться в командный режим -> toot Привет!

Ментальные модели и рекомендации

Модель: думайте о федиверсе как о почтовой системе для социальных действий — разные сервера обмениваются сообщениями, но политики могут отличаться.
Правило безопасности: не делайте публичную информацию секретной — все публичные посты могут быть реплицированы.
Приоритеты: автоматизируйте рутинные задачи в терминале; оставьте сложные операции для графического интерфейса.

Краткий глоссарий

Федиверс — сеть федеративных социальных серверов.
Инстанс — отдельный сервер в федиверсе.
ActivityPub — протокол федерации.
TUI — текстовый пользовательский интерфейс.
Toot — неформальный термин для поста в Mastodon (публикация).

Короткое резюме

gomphotherium даёт удобный способ читать и публиковать в федиверсе прямо из терминала. Это полезно для тех, кто работает в командной строке или подключается к удалённым машинам. Следуя шагам установки и аутентификации, вы сможете просматривать ленты, публиковать посты и управлять уведомлениями без графического интерфейса. При необходимости используйте веб-интерфейс для задач с медиа и продвинутых настроек.

И помните: федиверс — децентрализованная сеть. Если вам важна централизованная модерация и единая политика, возможно, стоит выбрать проприетарную платформу.

Краткие контрольные выводы: