Easy OPDS

Здравствуйте! Хочу представить вам Easy OPDS — продолжение развития проекта SOPDS, который многие годы использовался для организации домашних библиотек и OPDS-каталогов электронных книг. Оригинальный проект был создан автором GitHub-проекта mitshel и распространялся как открытое программное обеспечение. К сожалению, активная разработка SOPDS со временем остановилась, однако сам проект оказался настолько удачным и востребованным, что мне стало жалко позволить ему окончательно уйти в историю. Так появился Easy OPDS. Название было изменено специально, чтобы не возникало путаницы между оригинальным SOPDS и его дальнейшим развитием. Что уже изменилось? За время работы над проектом была проведена серьёзная модернизация внутренней части системы: обновлены зависимости Python и сторонние библиотеки; выполнен переход на современные версии Django и сопутствующих компонентов; обновлены библиотеки обработки изображений и XML; обновлены компоненты работы с базой данных и планировщиком задач; улучшена совместимость с современными версиями Linux и PostgreSQL. Встроенная онлайн-читалка Одним из самых заметных нововведений стала встроенная онлайн-читалка. Теперь книги можно открывать и читать непосредственно в браузере без скачивания файлов и установки дополнительных приложений. Достаточно открыть книгу и начать чтение с любого устройства — компьютера, планшета или смартфона. В оригинальном SOPDS такой возможности не было. Новый конвертер книг Также полностью обновлён механизм конвертации книг. Вместо прежнего решения используется fb2cng v1.5.3 — современный статический бинарный файл, написанный на Go и не требующий установки дополнительных зависимостей. Теперь доступны следующие форматы конвертации: EPUB 2 (epub2) EPUB 3 (epub3) Kobo EPUB (kepub) Kindle AZW8/KFX (azw8) Kindle KFX (kfx) PDF (pdf) TXT (txt) Markdown (md) Это значительно расширяет возможности использования библиотеки на различных устройствах и ридерах. Проект открыт для всех Easy OPDS остаётся полностью открытым проектом. Исходный код доступен всем желающим, а предложения, исправления ошибок и собственные модификации только приветствуются. Надеюсь, что проект окажется полезным не только мне, но и другим любителям электронных книг и домашних библиотек. Добро пожаловать в Easy OPDS!

Здравствуйте! Многие пользователи знают и используют проект SOPDS, который долгое время оставался одним из наиболее удобных и простых способов организации собственного OPDS-каталога электронных книг. Проект Easy OPDS появился как продолжение и развитие оригинального проекта SOPDS, созданного автором GitHub-проекта mitshel. Исходный проект распространяется как открытое программное обеспечение и доступен сообществу для изучения и модификации. К сожалению, активная разработка SOPDS со временем практически остановилась, а сайт продан другому владельцу. Несмотря на это, сам проект оказался очень удачным, востребованным и продолжает использоваться многими владельцами домашних библиотек и серверов электронных книг. Было бы жаль потерять такой полезный инструмент только из-за отсутствия дальнейшей поддержки. Именно поэтому и появился Easy OPDS. Основные цели проекта: сохранить и продолжить развитие идей оригинального SOPDS; исправлять ошибки и устранять накопившиеся проблемы; добавлять новые возможности и улучшать удобство использования; обеспечить совместимость с современными версиями программного обеспечения и серверных платформ; развивать проект совместно с сообществом пользователей. Название было изменено с SOPDS на Easy OPDS, чтобы избежать путаницы между оригинальным проектом и его дальнейшим развитием. Easy OPDS остаётся полностью открытым проектом. Исходный код доступен всем желающим, а любые предложения, исправления и модификации приветствуются. Проект создаётся не только для сообщества, но и вместе с сообществом. Добро пожаловать в Easy OPDS!

Easy OPDS (EOPDS) поддерживает работу как со встроенной базой данных SQLite, так и с внешней базой PostgreSQL. Для производственного использования рекомендуется использовать PostgreSQL. Требования Docker 24+ Docker Compose v2+ Внешний сервер PostgreSQL 14 или новее Доступ к каталогу с книгами Создание базы данных PostgreSQL Подключитесь к вашему серверу PostgreSQL и выполните: CREATE USER eopds WITH PASSWORD 'StrongPasswordHere'; CREATE DATABASE eopds OWNER eopds; GRANT ALL PRIVILEGES ON DATABASE eopds TO eopds; Параметры подключения: Параметр: Значение Хост: 10.16.88.10 Порт: 5432 Имя БД: eopds Пользователь БД: eopds Пароль БД: StrongPasswordHere Создание структуры каталогов mkdir -p /opt/eopds mkdir -p /srv/books mkdir -p /opt/eopds/config cd /opt/eopds Каталог /srv/books должен содержать вашу библиотеку книг. Пример: /srv/books ├── Фантастика ├── Детективы ├── Научная литература ├── Программирование └── Техническая документация Но это не обязательное требование. Все равно книги можно будет отсортировать по названию или автору. docker-compose.yml Создайте файл docker-compose.yml: services: eopds: image: ghcr.io/iahtoh/eopds:latest container_name: eopds restart: unless-stopped ports: - "8080:8080" environment: TZ: Europe/Moscow EOPDS_DB_TYPE: postgres EOPDS_DB_HOST: 10.16.88.10 EOPDS_DB_PORT: 5432 EOPDS_DB_NAME: eopds EOPDS_DB_USER: eopds EOPDS_DB_PASSWORD: StrongPasswordHere volumes: - ./config:/config - /srv/books:/books:ro Запуск контейнера docker compose pull docker compose up -d Проверить состояние контейнера: docker compose ps Просмотреть журнал работы: docker compose logs -f Открытие веб-интерфейса После запуска интерфейс будет доступен по адресу: http://SERVER_IP:8080 Например: http://10.16.88.10:8080 Обновление docker compose pull docker compose up -d Остановка docker compose down Использование через обратный прокси Для публикации в интернет рекомендуется использовать: Nginx Nginx Proxy Manager nginx-ui Traefik Caddy Пример адреса: https://books.example.com Дополнительные возможности Easy OPDS поддерживает: OPDS 1.x OPDS 2.0 Web-интерфейс каталога Конвертацию книг "на лету" PostgreSQL SQLite Многопользовательский режим Интеграцию с внешними ридерами Поддержка Если возникли проблемы с установкой: создайте тему в разделе Техподдержка приложите вывод команды: docker compose logs укажите используемую версию Easy OPDS и PostgreSQL.