steam-achievements

CLI-приложение для выгрузки достижений Steam в CSV по названию игры или AppID.

Требования

• Python 3.12+
• uv (менеджер проектов и пакетов)

Установка

1. Клонирование репозитория

git clone https://github.com/Khalmatov/steam-achievements.git
cd steam-achievements

2. Установка зависимостей

uv sync

Создаётся виртуальное окружение и устанавливаются зависимости из pyproject.toml.

3. Настройка переменных окружения

Скопируйте пример конфигурации и заполните значения:

cp .env.example .env

Отредактируйте .env:

Переменная	Описание
STEAM_API_KEY	Ключ Steam Web API. Получить: steamcommunity.com/dev/apikey
STEAM_ID	64-битный Steam ID вашего профиля. Узнать: steamid.io

Файл .env в репозиторий не попадает (указан в .gitignore).

Использование

Запуск

Два варианта:

uv run steam-achievements <игра>

или

uv run python -m steam_achievements <игра>

Аргументы

Аргумент	Описание
game	Название игры (поиск по вашей библиотеке) или числовой AppID
-o, --output	Файл для сохранения CSV (по умолчанию: achievements.csv)

Примеры

По имени игры (будет предложено выбрать из совпадений в библиотеке):

uv run steam-achievements xcom2
uv run steam-achievements "Half-Life 2"

По AppID:

uv run steam-achievements 19900

Указать свой файл для выгрузки:

uv run steam-achievements xcom2 -o xcom2_achievements.csv

Поведение

• По названию — загружается список ваших игр, выполняется нечёткий поиск; если найдено несколько вариантов, выбираете номер в консоли (1–5 или 0 для отмены).
• По AppID — достижения запрашиваются сразу для указанной игры.
• Результат сохраняется в CSV с колонками: название достижения, описание, статус (получено/нет) и т.п.

Лицензия

MIT