Files

Dmitriy Fofanov 41fb62f62e Добавлены страницы вики для GenAudioBookInfo: Home, Installation, Makefile, OpenRouter, Output Structure, TorrAPI и Sidebar.

Создана структура документации, описывающая функциональность, установку, использование CLI, архитектуру и интеграции с TorrAPI и OpenRouter.
Добавлены примеры конфигурации и метаданных, а также описание структуры выходных данных.

2026-02-23 13:19:39 +03:00

3.2 KiB

Raw Blame History

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

Синтаксис

genaudiobookinfo [опции] [путь к каталогу с аудиокнигами]

Если путь не передан, используется dir.in из config.yaml.

Флаги

Флаг	Тип	По умолчанию	Описание
`-workers N`	int	`0` (из config)	Количество параллельных воркеров. Переопределяет `processing.workers`.
`-timeout T`	duration	`0` (из config)	Таймаут всей сессии. Формат: `5m`, `1h30m`. Переопределяет `processing.timeout`.
`-api URL`	string	из config	URL TorrAPI сервера. Переопределяет `torrapi.url`.
`-result DIR`	string	`<вход>/result`	Папка для результатов. Переопределяет `dir.out`.
`-version`	flag	—	Вывести версию и выйти.

Приоритет параметров

CLI-флаг  >  config.yaml  >  встроенные defaults

Флаги -workers и -timeout со значением 0 (умолчание) не перетирают конфиг.

Примеры

Минимальный запуск (всё из config.yaml)

./genaudiobookinfo

Указать входной каталог явно

./genaudiobookinfo D:\Audiobooks

Переопределить количество воркеров

./genaudiobookinfo -workers 6 D:\Audiobooks

Другой сервер TorrAPI

./genaudiobookinfo -api http://192.168.1.10:9200 D:\Audiobooks

Указать нестандартную папку результатов

./genaudiobookinfo -result E:\ProcessedBooks D:\Audiobooks

Полный набор параметров

./genaudiobookinfo \
    -workers 4 \
    -timeout 30m \
    -api http://localhost:9200 \
    -result D:\Books\result \
    D:\Books\Incoming

Проверить версию

./genaudiobookinfo -version
# GenAudioBookInfo v2.0.0

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

Переменная	Описание
`OPENROUTER_API_KEY`	API ключ OpenRouter. Используется если `openrouter.api_key` в config.yaml пуст.

export OPENROUTER_API_KEY=sk-or-v1-xxxx
./genaudiobookinfo D:\Audiobooks

Управление в TUI

Во время обработки работает полноэкранный TUI:

Клавиша	Действие
`q`	Мягкое завершение (graceful stop, ждёт текущий воркер)
`Ctrl+C`	Прерывание (cancel context)

Сигналы ОС

Сигнал	Действие
`SIGINT` (Ctrl+C)	Отмена контекста → воркеры завершают текущую книгу
`SIGTERM`	То же

Код выхода

Код	Значение
`0`	Успешное завершение
`1`	Ошибка запуска (нет входного каталога, ошибка сканирования)

3.2 KiB Raw Blame History Unescape Escape