Author Today CLI

🎧 CLI инструмент для загрузки аудиокниг с платформы Author Today

⚠️ Важная информация

Этот инструмент предназначен исключительно для личного использования!

• 📚 Только для купленных книг - Инструмент позволяет скачивать только те аудиокниги, которые вы приобрели на платформе Author Today
• 🔒 Личное использование - Скачанные файлы предназначены только для личного прослушивания
• 🚫 Запрет передачи - Строго запрещается передача скачанных аудиокниг третьим лицам
• 🌐 Публичное API - Инструмент использует официальное публичное API платформы Author Today
• ⚖️ Соблюдение авторских прав - Пользователь несет полную ответственность за соблюдение авторских прав и условий использования платформы

Установка

npm install -g author-today-cli

или

pnpm add -g author-today-cli

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

Интерактивный режим

at-cli

Команды

# Авторизация
at-cli login

# Показать статус авторизации
at-cli status

# Поиск и скачивание аудиокниг
at-cli search

# Поиск с фильтром
at-cli search --query "фантастика"

# Скачивание с организацией по сериям (по умолчанию)
at-cli search --organize-by-series

# Скачивание с подробными логами
at-cli search --verbose

# Скачивание конкретной книги
at-cli download 12345

# Скачивание всей серии
at-cli download-series "Название серии"

# Просмотр серий
at-cli list-series

# Просмотр скачанных серий
at-cli list-downloaded-series

# Информация о серии
at-cli show-series "Название серии"

# Скачивание с настройкой потоков
at-cli search --concurrent 5

# Скачивание с настройкой попыток при ошибке
at-cli search --retries 5

# Скачивание в определенную папку
at-cli search --output ./my-audiobooks --concurrent 3 --retries 3

# Выход из системы
at-cli logout

Опции команд

# Скачивание с указанием папки
at-cli download 12345 --output ./my-audiobooks

# Поиск с фильтром
at-cli search --query "фантастика"

# Настройка количества одновременных загрузок
at-cli download 12345 --concurrent 5

# Организация по сериям
at-cli search --organize-by-series

# Отключение организации по сериям
at-cli search --no-series-organization

# Настройка шаблонов папок
at-cli search --series-folder-template "{series}" --work-folder-template "{order:03d}. {title}"

# Подробные логи
at-cli search --verbose

Возможности

• ✅ Авторизация - Сохранение токена и автоматическое обновление
• ✅ Поиск аудиокниг - Интерактивный поиск с фильтрацией
• ✅ Многопоточное скачивание - Параллельная загрузка нескольких глав
• ✅ Автоматические повторы - Повторные попытки при ошибках скачивания
• ✅ Скачивание - Загрузка аудиофайлов с прогрессом
• ✅ Возобновление - Продолжение прерванных загрузок
• ✅ Обложки - Автоматическое скачивание обложек книг
• ✅ Метаданные - Сохранение информации о книгах
• ✅ Временные файлы - Безопасное скачивание через временные файлы
• ✅ 2FA поддержка - Двухфакторная аутентификация
• ✅ Организация по сериям - Автоматическое создание папок по сериям
• ✅ Управление сериями - Просмотр, поиск и скачивание целых серий
• ✅ Гибкие шаблоны - Настройка структуры папок и имен файлов
• ✅ Verbose режим - Подробные логи для отладки
• ✅ Rate limiting - Автоматическая обработка ограничений API
• ✅ Только аудиокниги - Фильтрация только аудиоконтента

Структура скачанных файлов

Обычная структура

audiobooks/
├── Название книги 1/
│   ├── book-info.json          # Информация о книге
│   ├── cover.jpg                # Обложка книги
│   ├── annotation.txt           # Аннотация (если есть)
│   ├── 001. Глава 1.mp3         # Аудиофайлы глав
│   ├── 002. Глава 2.mp3
│   └── ...
├── Название книги 2/
│   ├── book-info.json
│   ├── cover.png
│   └── ...

Организация по сериям (по умолчанию)

audiobooks/
├── Название серии 1/
│   ├── 001. Первая книга серии/
│   │   ├── book-info.json
│   │   ├── cover.jpg
│   │   └── 001. Глава 1.mp3
│   ├── 002. Вторая книга серии/
│   │   ├── book-info.json
│   │   └── ...
│   └── 003. Третья книга серии/
│       └── ...
├── Название серии 2/
│   ├── 001. Книга из второй серии/
│   └── ...
└── Отдельные книги/
    ├── Книга без серии 1/
    └── Книга без серии 2/

Авторизация

CLI автоматически сохраняет токен авторизации в системной папке пользователя:

• Linux/macOS: ~/.config/author-today-cli/auth-token.json
• Windows: %USERPROFILE%\.config\author-today-cli\auth-token.json

При повторном запуске токен загружается автоматически.

Поддерживаемые методы авторизации

• Логин/пароль
• Двухфакторная аутентификация (2FA)
• Автоматическое обновление токенов

Требования

• Node.js >= 16.0.0
• Аккаунт на Author Today

Разработка

# Клонирование репозитория
git clone https://github.com/s00d/author-today-cli.git
cd author-today-cli

# Установка зависимостей
pnpm install

# Сборка
pnpm run build

# Запуск в режиме разработки
pnpm run dev

Лицензия

MIT License

Важно: Использование данного инструмента подразумевает согласие с условиями использования платформы Author Today и соблюдение авторских прав. Пользователь несет полную ответственность за правомерность использования скачанных материалов.

Поддержка

Если у вас возникли проблемы или вопросы:

1. Проверьте Issues
2. Создайте новый Issue с описанием проблемы
3. Убедитесь, что у вас актуальная версия Node.js

Changelog

v1.0.5

• ✅ Организация по сериям - Автоматическое создание папок по сериям
• ✅ Управление сериями - Новые команды для работы с сериями
• ✅ Verbose режим - Подробные логи с опцией --verbose
• ✅ Rate limiting - Автоматическая обработка ограничений API
• ✅ Только аудиокниги - Фильтрация только аудиоконтента
• ✅ Гибкие шаблоны - Настройка структуры папок
• ✅ Повторные попытки - Улучшенная обработка ошибок

v1.0.0

• Первый релиз
• Базовая функциональность скачивания аудиокниг
• Интерактивный поиск и выбор
• Автоматическое скачивание обложек
• Поддержка возобновления загрузок
• Временные файлы для безопасного скачивания