Interface_uk

Посібник з інтерфейсу 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

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