Table of Contents

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

Синтаксис
Флаги

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

Примеры

Минимальный запуск (всё из config.yaml)
Указать входной каталог явно
Переопределить количество воркеров
Другой сервер TorrAPI
Указать нестандартную папку результатов
Полный набор параметров
Проверить версию

Переменные окружения
Управление в TUI
Сигналы ОС
Код выхода

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Использование 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`	Ошибка запуска (нет входного каталога, ошибка сканирования)