# GenAudioBookInfo

> Автоматический каталогизатор аудиокниг с обогащением метаданных из торрент-трекеров и LLM.

## Что делает инструмент

1. **Сканирует** каталог с аудиокнигами — находит все подпапки с аудиофайлами (mp3, m4b, ogg, flac, opus, aac и др.).
2. **Извлекает метаданные** из аудиофайлов: автор, название, год, жанр, длительность через ID3/Vorbis теги.
3. **Ищет книгу на трекерах** через [TorrAPI](TorrAPI) по имени папки и/или тегам — получает расширенное описание.
4. **Опционально** уточняет автора и название через LLM ([OpenRouter](OpenRouter)).
5. **Создаёт структуру** `result/<Буква>/<Автор>/<Автор — Книга [Год]>/` с `metadata.json` и обложкой.
6. Папки, которые не удалось найти, уходят в `ERROR/`; дубликаты — в `DUPLICATE/`.

## Быстрый старт

```bash
# Сборка
go build -o genaudiobookinfo ./cmd/genaudiobookinfo

# Первичная настройка
cp .env.example .env
# Отредактировать .env: задать DIR_IN, TORRAPI_URL, OPENROUTER_API_KEY

# Запуск (входная папка из DIR_IN в .env)
./genaudiobookinfo

# Явное указание каталога
./genaudiobookinfo D:\Audiobooks

# С переопределением параметров
./genaudiobookinfo -workers 4 -timeout 10m D:\Audiobooks
```

Полная документация по флагам: [[CLI-Usage]].

## Структура вики

| Страница | Содержание |
|---|---|
| [[Installation]] | Требования, сборка из исходников |
| [[Configuration]] | Справочник `.env` (все переменные конфигурации) |
| [[CLI-Usage]] | Флаги командной строки, примеры |
| [[Architecture]] | Чистая архитектура, слои, паттерны |
| [[Algorithm]] | Шаги конвейера, ретрай, ERROR, DUPLICATE |
| [[Output-Structure]] | Структура `result/`, формат `metadata.json` |
| [[TorrAPI]] | Интеграция с торрент-трекерами |
| [[OpenRouter]] | LLM-интеграция для нормализации метаданных |

## Поддерживаемые форматы

`mp3` · `m4b` · `m4a` · `ogg` · `opus` · `flac` · `aac` · `wma` · `wav` · `aiff`

## Требования

- Go 1.22+
- [TorrAPI](https://github.com/yourok/TorrServer) (локальный или удалённый сервер)
- Ключ [OpenRouter](https://openrouter.ai/) — **опционально**, для нормализации автора/названия через LLM

## Ссылки

- Репозиторий: `https://github.dfv24.com/fofanov/genaudiobookinfo`
- Документация OpenRouter: [[OpenRouter]]

Sync test 2026-02-23T14:27:00