65 lines
3.1 KiB
Markdown
65 lines
3.1 KiB
Markdown
# 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
|