Установка Finam Terminal

Finam Terminal ставится одной командой. Скрипт установки определяет систему и архитектуру, скачивает последний релиз с GitHub и добавляет бинарник в PATH. Дальше терминал запускается командой finam-terminal из любого каталога.

Понадобятся брокерский счёт и API-ключ. Если счёта ещё нет, откройте его по инструкции. Ключ вводится при первом запуске.

Команда установки

macOS / Linux / WSL

curl -fsSL https://fcli.ru/install.sh | bash

Windows PowerShell

irm https://fcli.ru/install.ps1 | iex

Windows CMD

curl -fsSL https://fcli.ru/install.cmd -o install.cmd && install.cmd && del install.cmd

В конце скрипт печатает строку Installed finam-terminal <версия> to <путь>. На Windows закройте окно терминала и откройте новое: новая запись в Path видна только там.

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

  1. Выполните команду finam-terminal. Откроется экран настройки с полем API Token.
  2. Создайте ключ на api.finam.ru/tokens/ и включите право «Торговля» — без него терминал покажет счёт и позиции, но не даст выставить заявку.
  3. Вставьте ключ в поле API Token и нажмите Save & Continue.

Ключ сохраняется в ~/.finam-cli/.env, при следующих запусках вводить его не нужно. Терминал загружает список счетов и открывает основной экран.

Требования

  • Терминал с поддержкой Unicode: таблицы и график свечей нарисованы псевдографикой. На Windows приложение само включает UTF-8 при старте.
  • Окно во весь экран: в узком окне колонки таблицы обрезаются.
  • Доступ к api.finam.ru:443 для работы терминала и к github.com для скрипта установки.

Доступные сборки

ПлатформаФайл в релизе
macOS Intelfinam-terminal-darwin-amd64
macOS Apple Siliconfinam-terminal-darwin-arm64
Linux x86-64finam-terminal-linux-amd64
Windows x86-64finam-terminal-windows-amd64.exe

Сборок под Linux ARM64 и Windows ARM64 нет: скрипт на такой машине останавливается с сообщением об архитектуре, и терминал остаётся собрать из исходников на Go 1.26.0. В WSL ставится сборка для Linux x86-64.

Если команда не найдена

Пустой вывод или command not found означают, что каталог установки не попал в PATH. До исправления терминал запускается по полному пути к файлу.

  1. Закройте окно терминала и откройте новое: старое работает со старым значением PATH.
  2. Проверьте путь к файлу — which finam-terminal в bash и zsh, Get-Command finam-terminal в PowerShell, where finam-terminal в CMD.
  3. Если вывод пустой, а установка на macOS или Linux прошла в ~/.local/bin, добавьте строку export PATH="$HOME/.local/bin:$PATH" в ~/.bashrc или ~/.zshrc и откройте новое окно.

Другие способы установки

Docker

docker pull ghcr.io/updevru/finam-terminal:latest
docker run -it --name finam-terminal ghcr.io/updevru/finam-terminal:latest

Токен остаётся внутри контейнера и теряется вместе с ним. Чтобы токен и настройки хранились на хосте, добавьте в docker run ключ -v ~/.finam-cli:/root/.finam-cli.

Готовый бинарник

  1. Скачайте файл для своей платформы со страницы последнего релиза.
  2. На macOS и Linux: chmod +x finam-terminal-darwin-arm64 && sudo mv finam-terminal-darwin-arm64 /usr/local/bin/finam-terminal.
  3. На Windows переименуйте файл в finam-terminal.exe и положите в каталог из Path.

Переменные окружения

Читаются из окружения и из файла .env в текущем каталоге. Токен вдобавок берётся из ~/.finam-cli/.env, поэтому задавать FINAM_API_TOKEN вручную не обязательно.

ПеременнаяПо умолчаниюНазначение
FINAM_API_TOKENобязательнаAPI-ключ Финама
FINAM_GRPC_ADDRapi.finam.ru:443адрес gRPC-эндпоинта
REFRESH_INTERVAL5интервал автообновления данных, секунды

Обновление и удаление

Терминал обновляется сам: раз в сутки в фоне проверяет релизы на GitHub, показывает в шапке значок ⚡ с номером доступной версии и предлагает установить её при следующем запуске. Немедленное обновление — клавиша U на основном экране. Порядок и ограничения — в разделе Обновление программы.

Ручной способ остаётся прежним: та же команда установки повторно, скрипт перезапишет бинарник последним релизом. Для Docker после docker pull удалите старый контейнер командой docker rm finam-terminal и запустите docker run заново, иначе он продолжит работать на старом образе.

Команды удаления в скриптах нет, поэтому три шага вручную:

  1. Удалите бинарник — /usr/local/bin/finam-terminal или ~/.local/bin/finam-terminal на macOS и Linux, каталог %LOCALAPPDATA%\finam-terminal на Windows.
  2. Удалите каталог с настройками и токеном — ~/.finam-cli на macOS и Linux, %USERPROFILE%\.finam-cli на Windows.
  3. Уберите каталог установки из PATH — из пользовательской переменной Path на Windows, из профиля оболочки на macOS и Linux.

Примечания

  • Скрипты ставят только последний релиз. Предыдущие версии — на странице релизов.
  • Лог пишется в файл finam-terminal.log в каталоге, из которого запущен терминал.

Что дальше

Запустите finam-terminal и переходите к разделу Обзор интерфейса.