Использование gomphotherium: Fediverse прямо в терминале Linux

gomphotherium — это терминальный (TUI) клиент для доступа к Fediverse и Mastodon прямо из вашего Linux-терминала. Установите Go, клонируйте репозиторий, скомпилируйте с помощью make, выполните аутентификацию и запустите gomphotherium tui. Ниже — подробная инструкция, советы по безопасности, чеклисты и варианты использования по SSH.

Fediverse — это децентрализованная сеть серверов, объединяющая социальные платформы по открытому протоколу ActivityPub. Вместо единой компании вы получаете множество отдельных инстансов, которые взаимодействуют друг с другом. gomphotherium даёт вам полный доступ к лентам, уведомлениям и публикациям прямо из терминала.

Почему имеет смысл пользоваться Fediverse из терминала

• Вы работаете в терминале большую часть времени и не хотите переключаться на браузер.
• Нужно просматривать ленты с удалённого сервера по SSH.
• Вам важна минималистичная, быстрая и текстовая работа с записями.

Fediverse совместим благодаря ActivityPub. Это значит, что один клиент может работать с разными типами серверов — Mastodon, Pleroma и другими реализациями протокола. gomphotherium реализует TUI, что облегчает навигацию с клавиатуры.

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

Коротко о gomphotherium

• Что это: TUI-клиент для Fediverse написанный на Go.
• Для кого: пользователи Linux, администраторы и те, кто часто работает по SSH.
• Что умеет: просматривать ленты, публиковать записи, отвечать, ретвить/буфферить и просматривать хэштеги.

Как установить gomphotherium на Linux

1. Убедитесь, что у вас установлен Go (версия 1.XX или выше). Если у вас нет Go, установите его через пакетный менеджер вашей системы.

2. Клонируйте репозиторий:

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

3. Перейдите в директорию проекта:

cd gomphotherium

4. Скомпилируйте проект:

make

5. (Опционально) Создайте символическую ссылку, чтобы запускать gomphotherium из любого места:

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

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

Аутентификация и получение токена

Для работы gomphotherium надо авторизовать приложение на вашей инстансе Mastodon/другом сервере Fediverse.

Выполните команду аутентификации, заменив URL на адрес вашей инстансы:

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

Команда вернёт URL. Откройте его в браузере, войдите в учётную запись и нажмите Authorize. Скопируйте код подтверждения в буфер обмена.

Вставьте код обратно в терминал и нажмите Enter. В ответ gomphotherium вернёт строку либо инструкцию экспорта токена. Обратите внимание: если команда просит вас выполнить export, перед словом export должен быть пробел после URL/параметров. Если пробела нет — вставьте его вручную.

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

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

Запустите TUI:

gomphotherium tui

Во время подключения в поле ввода будет анимация. После успешного входа появится зелёная галочка и ваше имя пользователя.

Навигация и режимы:

• Клавиши Up/Down — прокрутка ленты.
• Режимы: «normal» и «command». По умолчанию вы в normal mode.
• Для перехода в command mode нажмите Shift + ;
• В command mode введите одну из временных лент: home, local, public, notifications и нажмите Enter.

Публикация записи (toot):

toot MUO is the best!

Приватные и невидимые для поиска записи:

• tootprivate — для приватной заметки.
• tootunlisted — для неподписной записи.

Дополнительно: поиск по хэштегам, просмотр профилей, реплаи и бусты доступны через соответствующие команды. Для списка команд введите “?” в интерфейсе.

Полезные приёмы и сценарии использования

• Используйте tmux или screen при подключении по SSH. Это сохранит сессию gomphotherium при разрыве связи.
• Для автоматического переподключения применяйте autossh или systemd –user unit.
• Чтобы быстро пересылать длинные тексты, редактируйте их в редакторе (vim/nano) и вставляйте в командный режим.

Совет: если вы часто работаете на нескольких машинах, храните конфигурацию (и, при необходимости, токены) в защищённом dotfile-репозитории с шифрованием.

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

• Токены доступа можно отозвать в настройках вашей инстансы. Делайте это при смене устройств.
• Не делитесь экспортируемыми строками в публичных скриптах.
• Если вы используете общую машину, храните токены в зашифрованном хранилище (gpg, pass, keyring).

Примечание: gomphotherium использует API вашей инстансы, поэтому права и ограничения зависят от настроек сервера и самой реализации ActivityPub.

Чеклист перед установкой

Перед тем как начать, проверьте:

• Установлен Go и PATH настроен.
• Достаточно прав для создания символических ссылок (если нужно).
• Доступ в браузере для подтверждения авторизации.
• Резервная копия важных токенов/конфигураций.

Роль-перспективы:

• Пользователь: фокус на удобстве и приватности.
• Системный администратор: фокус на пакетизации, доступности и безопасности сервисов.

Альтернативы и когда gomphotherium не подойдёт

• Если вам нужен медиацентрированный опыт с изображениями и видео — GUI-клиент или браузер будут лучше.
• При необходимости комплексного управления инстансой (администрирование серверной части) используйте веб-интерфейсы админки или специализированные инструменты.
• Для автоматизированных сценариев интеграции и массовой обработки постов удобнее писать скрипты, использующие API напрямую.

Критерии приёмки

Считайте установку завершённой, когда:

• gomphotherium запускается без ошибок и отображает вашу учётную запись.
• Вы можете просматривать home, local и public ленты.
• Удачно выполнена публикация тестового toot.
• Вы можете отозвать/переавторизовать токен через веб-интерфейс.

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

• Проблема: нет ответа при попытке authenticate.

  • Проверьте, что URL инстансы корректен и доступен из браузера.
  • Убедитесь, что соединение не блокируется прокси или фаерволом.

• Проблема: после вставки кода аутентификации появилось сообщение об ошибке “export”.

  • Убедитесь в наличии пробела перед словом export в строке, которую вам выдала программа.

• Проблема: сессия разрывается по SSH.

  • Запустите gomphotherium в tmux/screen.

Примеры команд и сниппеты

• Запуск TUI прямо:

gomphotherium tui

• Просмотр локальной ленты:

home
local

• Создание приватной записи:

tootprivate Это приватное сообщение.

Решение: выбрать клиент (мини-диаграмма)

flowchart TD
  A[Нужен терминал?] -->|Да| B[Выберите gomphotherium]
  A -->|Нет| C[Используйте GUI или мобильное приложение]
  B --> D{Подключение по SSH}
  D -->|Часто| E[Запуск в tmux]
  D -->|Редко| F[Прямой запуск в терминале]

FAQ

Q: Можно ли запустить gomphotherium на macOS?

A: Теоретически да, если у вас установлен Go и поддерживаемая среда терминала, но инструкция ориентирована на Linux.

Q: Как отозвать доступ, если токен скомпрометирован?

A: Зайдите в настройки вашей инстансы через браузер и удалите/отклоните соответствующее приложение в разделе доступов.

Q: Работает ли gomphotherium с Pleroma или другими серверными реализациями?

A: Да. Если сервер поддерживает ActivityPub и API совместим с Mastodon-совместимыми клиентами, базовая функциональность должна работать.

Итог

gomphotherium даёт удобный и быстрый доступ к Fediverse прямо в терминале. Он особенно полезен для тех, кто предпочитает текстовый интерфейс или работает по SSH. Установите Go, соберите проект, авторизуйте приложение и используйте TUI для чтения лент и публикаций.

Важно: следите за безопасностью токенов и используйте tmux при работе по ненадёжным сетям.

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

• gomphotherium — это TUI-клиент для работы с Fediverse из терминала.
• Установка: git clone → make → (опция) ln -s → authenticate.
• Используйте tmux для надёжной работы по SSH и храните токены в защищённом хранилище.