Interface_ru

Руководство по интерфейсу TinyOPDS

Вкладка "Сканер"

Вкладка сканера отвечает за индексацию вашей библиотеки книг и управление базой данных.

Путь к папке с книгами - укажите папку, где хранится ваша библиотека. Используйте кнопку справа для выбора через стандартный диалог Windows.

Мониторинг изменений - при включении этой опции программа автоматически отслеживает добавление, изменение и удаление файлов в библиотеке в реальном времени.

Имя файла базы данных - SQLite база данных, где хранится вся информация о книгах. По умолчанию books.sqlite.

Статистика библиотеки:

• Книг в базе данных - общее количество проиндексированных книг с разбивкой по форматам (fb2, epub)
• Найдено книг - количество книг, обнаруженных при последнем сканировании (может превышать количество в базе из-за дубликатов)
• Недействительные книги - повреждённые или нечитаемые файлы
• Пропущенные книги - файлы, которые не удалось обработать
• Дубликаты - количество обнаруженных дубликатов (программа автоматически оставляет лучшую версию)
• Обработано книг - общее количество файлов, просканированных за сессию

Информация о процессе:

• Время начала - когда было запущено сканирование
• Затраченное время - продолжительность сканирования
• Скорость сканирования - количество обрабатываемых книг в минуту
• Статус - текущее состояние (FINISHED - завершено)

Важно: Сканирование больших архивов (350-400 ГБ) может занимать несколько часов, так как при добавлении в базу каждая книга проверяется на наличие дубликатов. Если вы планируете использовать TinyOPDS на маломощном компьютере (например, Raspberry Pi 4/5 с 4 ГБ RAM), рекомендуется выполнить первичное сканирование на быстром ПК с SSD-диском, а затем скопировать готовую базу данных на целевое устройство.

Вкладка "Сервер"

Настройки HTTP-сервера и сетевых подключений.

Имя сервера - название вашей библиотеки, которое будет отображаться в OPDS-клиентах.

Сетевой интерфейс - выберите IP-адрес, на котором будет работать сервер. Выберите конкретный адрес для локальной сети или 0.0.0.0 для прослушивания на всех интерфейсах.

Порт - TCP-порт для HTTP-сервера (по умолчанию 8080).

Корень OPDS - путь для OPDS-каталога в URL (по умолчанию "opds").

Перенаправление порта на роутере - автоматическая настройка проброса портов через UPnP. Опция доступна только если роутер поддерживает UPnP. Для включения UPnP на роутере обычно нужно зайти в веб-интерфейс роутера (обычно 192.168.1.1 или 192.168.0.1), найти раздел "UPnP" или "Universal Plug and Play" в настройках сети/безопасности и активировать эту функцию.

URL-адреса:

• Локальный OPDS URL - адрес для подключения OPDS-клиентов в локальной сети
• Локальный веб URL - адрес веб-интерфейса для браузера
• Внешний OPDS URL - адрес для доступа из интернета (если настроен проброс портов)
• Внешний веб URL - внешний адрес веб-интерфейса

Статистика сервера:

• Уникальные клиенты - количество различных устройств, подключавшихся к серверу
• Всего запросов - общее количество HTTP-запросов
• Отправлено книг - количество скачанных книг
• Отправлено изображений - количество переданных обложек

Вкладка "Каталог OPDS"

Настройки отображения и организации OPDS-каталога.

Элементов на страницу OPDS - количество книг/авторов на одной странице в OPDS-клиенте (рекомендуется 50-100 для мобильных устройств).

Элементов на веб-страницу - количество элементов на странице веб-интерфейса (можно больше, так как браузеры мощнее).

Порядок сортировки - выберите приоритет отображения:

• Сначала кириллица - русские авторы и книги будут показаны первыми
• Сначала латиница - английские и другие латинские названия в начале

Период проверки "Новые книги" - книги, добавленные в этот период, будут отображаться в разделе "Новинки":

• Одна неделя
• Две недели
• Три недели
• Месяц
• Полтора месяца
• Два месяца
• Три месяца

Кэш изображений:

• В памяти - быстрее, но требует больше RAM
• На диске - экономит память, немного медленнее

Размер кэша в памяти - объём RAM для хранения обложек книг (128-512 МБ обычно достаточно).

Очистить историю загрузок - удаляет информацию о скачанных книгах из раздела "Загруженные книги" в OPDS-каталоге.

Вкладка "Маршруты OPDS"

Настройка структуры OPDS-каталога. Вы можете включить или отключить различные разделы и настроить их иерархию.

Структура каталога:

• Корень - главная страница каталога
  • Новые книги - недавно добавленные книги
    • Новые книги (по дате) - сортировка по дате добавления
    • Новые книги (по алфавиту) - алфавитная сортировка новинок
  • По авторам - навигация по авторам
    • Книги автора - список произведений выбранного автора
      • Книги по сериям - группировка по сериям/циклам
      • Книги вне серий - отдельные произведения
      • Книги по алфавиту - все книги автора от А до Я
      • Книги по дате - сортировка по дате публикации
  • По сериям - навигация по книжным сериям
  • По жанрам - разделение по жанрам (фантастика, детективы и т.д.)
  • Загруженные книги - история скачиваний с данного устройства

Снимите галочки с разделов, которые не нужны в вашем каталоге.

Вкладка "Авторизация"

Настройки безопасности и контроля доступа с использованием HTTP Basic авторизации.

Использовать HTTP Basic авторизацию - включает стандартную HTTP-авторизацию для защиты библиотеки паролем.

Запоминать авторизованных клиентов - устройства не будут запрашивать пароль повторно после первого входа.

Блокировать клиентов после N неудачных попыток - защита от подбора пароля.

Таблица пользователей:

• Добавьте имена пользователей и пароли для доступа к библиотеке
• Символ * в первом столбце означает активного пользователя
• Можно создать несколько учётных записей для разных устройств

Статистика безопасности:

• Успешные входы - количество правильных авторизаций
• Неудачные входы - попытки входа с неверным паролем
• Заблокированные клиенты - IP-адреса, заблокированные за превышение лимита попыток

Вкладка "Разное"

Общие настройки программы и ведение журнала.

Запуск с Windows - автоматический старт при загрузке системы.

Запускать свёрнутой - программа сразу сворачивается в трей.

Закрывать или сворачивать в трей - при нажатии на крестик программа не закрывается, а прячется в системный трей.

Только один экземпляр - запрещает запуск нескольких копий программы одновременно. Если снять эту галочку, можно запустить несколько экземпляров TinyOPDS с разными портами для обслуживания разных библиотек или настроек.

Язык интерфейса и OPDS - выбор языка для GUI и OPDS-каталога:

• English
• Українська
• Русский
• Deutsch
• Español
• Français

Проверка обновлений - частота автоматической проверки новых версий:

• Никогда
• Раз в неделю
• Раз в месяц

Сохранять журнал в файл - включает запись событий в лог-файл для диагностики.

Уровень детализации журнала:

• Информация, предупреждения и ошибки - максимальная детализация
• Предупреждения и ошибки - средний уровень
• Только ошибки - минимальное логирование

Просмотр журнала - открывает текущий лог-файл в текстовом редакторе.

Консольная версия - TinyOPDSCLI

TinyOPDSCLI - версия программы для работы из командной строки, предназначенная для установки в качестве системной службы.

Доступные команды:

• install - установить и запустить TinyOPDS как службу Windows/Linux/macOS
• uninstall - удалить службу TinyOPDS
• start - запустить службу (или в консольном режиме, если служба не установлена)
• stop - остановить службу
• scan - выполнить сканирование библиотеки
• encred user pwd - закодировать учётные данные для конфигурации

Примечание: Команды управления службой требуют прав администратора.

Установка как службы

Windows:

TinyOPDSCLI.exe install

Linux (с Mono):

sudo mono TinyOPDSCLI.exe install

macOS (с Mono):

sudo mono TinyOPDSCLI.exe install

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