Все разделы

Начало работы

Установка

На этой странице

Tetiva ставится из трёх артефактов: DMG для macOS, инсталлятор для Windows и пакет .deb для Ubuntu и Debian — все лежат на странице Скачать и бесплатны. Установка не требует аккаунта: клиент запускается и работает локально сразу.

macOS#

Требования: macOS 11 или новее. Сборка universal — один файл для Apple Silicon и Intel, около 32 МБ.

  1. Скачайте Tetiva-X.Y.Z-macos-universal.dmg.
  2. Откройте образ и перетащите Tetiva в папку «Программы».
  3. Запустите приложение из Launchpad или Spotlight.

DMG подписан сертификатом Developer ID и нотаризован Apple, поэтому Gatekeeper пропускает приложение без предупреждений и без обходных команд в терминале. Если предупреждение всё-таки появилось, скорее всего, скачан повреждённый или чужой файл — загрузите его заново со страницы Скачать и сверьтесь с разделом Решение проблем.

Windows#

Требования: Windows 10 или 11. Есть два инсталлятора — x64 (около 16 МБ) и ARM64. Если в системе нет WebView2, инсталлятор доустановит его сам.

  1. Скачайте инсталлятор под свою архитектуру (для большинства машин это x64).
  2. Запустите его и пройдите шаги мастера.

Инсталлятор ставит Tetiva в профиль пользователя, в %LOCALAPPDATA%\Programs\Tetiva, и прав администратора не просит. Прежние версии ставились в Program Files, в C:\Program Files\Saveliy Yudin\Tetiva. Если там осталась копия, инсталлятор удалит её, один раз запросив разрешение Windows. Если отказаться, установка всё равно завершится, а старую копию можно удалить в «Параметры» → «Приложения».

Инсталлятор пока не подписан, поэтому SmartScreen показывает синее окно «Windows защитила ваш компьютер». Нажмите «Подробнее» → «Выполнить в любом случае». Так и будет, пока у сборки нет сертификата подписи кода; на странице загрузки об этом написано прямо.

Первый запуск#

При первом старте открывается экран приветствия с двумя вариантами: Работать локально и Подключить аккаунт. Выбор ничего не блокирует — синхронизацию можно включить позже, а локальная работа не ограничена ничем. Рядом есть тур из четырёх экранов; и тур, и приветствие переоткрываются из настроек кнопкой Show welcome.

Данные складываются в SQLite-файл ~/.tetiva/data.db: коллекции, окружения, cookies, история и настройки. Каталог переопределяется переменной окружения TETIVA_DATA_DIR. Удаление приложения каталог не трогает — данные остаются на диске.

Сразу после установки логично пройти Быстрый старт, а если вы приходите из Postman — сначала импортировать коллекции.

Обновления#

С версии 1.2.1 Tetiva на macOS и Windows обновляется сама. Не чаще раза в сутки она проверяет, вышла ли новая версия, а если синхронизация остановилась из-за старой версии — сразу. Если вышла, скачивает её в фоне и сверяет файл с подписью Tetiva (ed25519) и контрольной суммой sha256. После этого внизу боковой панели появляется карточка: обновление готово. «Перезапустить» сохраняет правки, перезапускает Tetiva уже новой версией и открывает те же вкладки. «Позже» сворачивает карточку в строку, а × прячет её для этой версии. Если через неделю вы так и не обновились, карточка откроется ещё раз. В разделе «Обновления» настроек есть такая же кнопка, «Перезапустить для обновления».

Этим управляют два переключателя в разделе «Обновления» окна настроек: «Проверять автоматически» и «Скачивать обновления автоматически», оба включены по умолчанию. Если выключить скачивание, на карточке будет кнопка «Скачать». Если выключить проверку, приложение само не сделает ни одного запроса за обновлениями, а проверить можно кнопкой «Проверить сейчас».

Обновиться сама Tetiva может, только если её установили обычным путём: на macOS перенесли из DMG в «Программы» или другую папку, куда у вас есть права на запись, на Windows поставили инсталлятором. Иначе раздел «Обновления» объяснит, в чём дело, и даст ссылку на страницу Скачать.

На Linux обновления приходят через apt. Когда выходит новая версия, карточка показывает команду sudo apt update && sudo apt install --only-upgrade tetiva с кнопкой копирования. Если Tetiva ставили не из репозитория, карточка покажет команды, которые его подключают, — те же, что в разделе Linux ниже.

Версии 1.2.0 и более ранние только сообщают о новой версии. Их нужно один раз обновить со страницы Скачать тем же способом, каким ставили. Обновление не трогает базу в ~/.tetiva, коллекции и окружения остаются на месте.

Linux#

Требования: архитектура amd64 или arm64 и стек GTK3 + WebKit2GTK 4.1. Пакет объявляет зависимости libgtk-3-0 и libwebkit2gtk-4.1-0 — под этими именами они лежат в Ubuntu 22.04 и новее и в Debian 12 и новее. Другие дистрибутивы не проверялись.

Проще всего поставить из репозитория Tetiva: apt установит пакет вместе с зависимостями, а новые версии потом привезёт sudo apt upgrade.

wget -qO- https://apt.tetiva.app/tetiva.gpg | sudo tee /etc/apt/keyrings/tetiva.gpg >/dev/null
echo "deb [signed-by=/etc/apt/keyrings/tetiva.gpg] https://apt.tetiva.app stable main" | sudo tee /etc/apt/sources.list.d/tetiva.list
sudo apt update && sudo apt install tetiva

Репозиторий подписан, и apt сверяет с ним каждый пакет; ключ лежит в /etc/apt/keyrings/tetiva.gpg и доверен только этому репозиторию.

Или поставьте скачанный пакет:

  1. Скачайте .deb под свою архитектуру со страницы Скачать: для большинства машин это amd64, для ARM — arm64.
  2. Поставьте его через apt, чтобы зависимости подтянулись сами (файл для ARM оканчивается на linux-arm64.deb):
sudo apt install ./Tetiva-1.2.0-linux-amd64.deb

sudo dpkg -i тоже поставит пакет, но зависимости не подтянет — после него понадобится sudo apt -f install.

Пакет называется tetiva. Бинарь ложится в /usr/bin/tetiva, так что из терминала приложение запускается командой tetiva; в меню приложений появляется пункт Tetiva. База лежит там же, где на остальных системах — ~/.tetiva/data.db.

Скачанный .deb никто не проверяет — dpkg подписи отдельных пакетов игнорирует — и сам он не обновляется: скачайте свежий и поставьте той же командой поверх. У установки из репозитория обеих проблем нет.

Сейчас публикуется только .deb. AppImage, rpm и пакет для AUR собираются, но на сайт не выкладываются, поэтому любая сторонняя сборка Tetiva для Linux — не наша.

обновлено