41fb62f62e
Создана структура документации, описывающая функциональность, установку, использование CLI, архитектуру и интеграции с TorrAPI и OpenRouter. Добавлены примеры конфигурации и метаданных, а также описание структуры выходных данных.
2.1 KiB
2.1 KiB
Установка и сборка
Требования
| Компонент | Версия | Обязательно |
|---|---|---|
| Go | 1.22+ | ✅ |
| TorrAPI-совместимый сервер | любая | ✅ |
| OpenRouter API ключ | — | ❌ (только для LLM) |
Сборка из исходников
# Клонировать репозиторий
git clone https://github.dfv24.com/fofanov/genaudiobookinfo.git
cd genaudiobookinfo
# Загрузить зависимости
go mod tidy
# Сборка
go build -o genaudiobookinfo ./cmd/genaudiobookinfo
# Или через Makefile
make build
Windows
go build -o genaudiobookinfo.exe ./cmd/genaudiobookinfo
Зависимости
Все зависимости управляются через Go Modules. Основные:
| Модуль | Назначение |
|---|---|
charmbracelet/bubbletea |
TUI-фреймворк (интерактивный вывод) |
charmbracelet/lipgloss |
Цветовое оформление терминала (Dracula scheme) |
charmbracelet/bubbles |
Компоненты TUI: прогресс, спиннер |
dhowden/tag |
Чтение ID3/Vorbis/MP4 тегов из аудиофайлов |
tcolgate/mp3 |
Расчёт длительности MP3 с VBR |
schollz/progressbar/v3 |
Прогресс-бар для ConsoleLogger |
gopkg.in/yaml.v3 |
config.yaml |
Первичная настройка
- Скопировать шаблон конфигурации:
cp .env.example .env
- Изменить пути в
.env:
DIR_IN=/path/to/audiobooks # входная папка
DIR_OUT=/path/to/result # папка результатов (опционально)
- Настроить TorrAPI:
TORRAPI_URL=http://localhost:9200 # адрес TorrServer
- Запустить:
./genaudiobookinfo
Проверка сборки
go vet ./...
go test ./...
./genaudiobookinfo -version
Обновление
git pull
go mod tidy
make build