Sign inSign up

mikespub/seblucas-cops

By mikespub

•Updated 5 months ago

COPS - Calibre OPDS (and HTML) PHP Server to serve ebooks (epub, mobi, pdf, ...)

Image
0

7.9K

mikespub/seblucas-cops repository overview

⁠Image Tags

⁠web or latest

For "regular" users, this image only contains production packages and can be launched via docker compose: https://github.com/mikespub-org/seblucas-cops/raw/main/docker-compose.yaml⁠

⁠dev

For "advanced" users, this image contains development packages and can be launched via docker compose: https://github.com/mikespub-org/seblucas-cops/raw/main/docker-compose-dev.yaml⁠

⁠Change Log

See CHANGELOG⁠ at https://github.com/mikespub-org/seblucas-cops⁠

1.4.1 - 20230728 Clean-up before next release

1.4.0 - 20230721 Use namespaces in PHP lib, upgrade jquery npm asset + sausage package

1.3.6 - 20230714 Add REST API, limit email address, clean up constants + fix book test

1.3.5 - 20230712 Send EPUB, fix custom columns, support wildcard + add tests

1.3.4 - 20230609 Fix EPUB 3 TOC, replace other npm assets and use namespace in PHP resources

1.3.3 - 20230327 Update npm asset dependencies

1.3.2 - 20230325 Improve tests and security

1.3.1 - 20230325 Update epub-loader resources

1.3.0 - 20230324 Add bootstrap2 templates

1.2.3 - 20230324 Add fixes for PHP 8.2

1.2.2 - 20230324 Update fetch.php to lower memory consumption

1.2.1 - 20230321 Add phpstan baseline + fixes

1.2.0 - 20230319 Migration to PHP 8.x

1.1.3 - 20190624 Latest "official" release at https://github.com/seblucas/cops⁠

⁠COPS by Sébastien Lucas

COPS stands for Calibre OPDS (and HTML) Php Server.

See : COPS's home⁠ for more details.

Don't forget to check the Wiki⁠.

⁠Why ?

In my opinion Calibre is a marvelous tool but is too big and has too much dependencies to be used for its content server.

That's the main reason why I coded this OPDS server. I needed a simple tool to be installed on a small server (Seagate Dockstar in my case).

I initially thought of Calibre2OPDS but as it generate static file no search was possible.

Later I added an simple HTML catalog that should be usable on my Kobo.

So COPS's main advantages are :

  • No need for many dependencies.
  • No need for a lot of CPU or RAM.
  • Not much code.
  • Search is available.
  • It was fun to code.

If you want to use the OPDS feed don't forget to specify feed.php at the end of your URL.

You just have to sync your Calibre directory to your COPS server the way you prefer (Dropbox, Bt Sync, Syncthing, use a directory shared with Nextcloud, ...).

⁠Prerequisites (this fork)

  1. PHP 7.4 or 8.X with GD image processing, Libxml, Intl, Json & SQLite3 support (PHP 8.1 or later recommended).

See CHANGELOG⁠ for changes compared to upstream repository https://github.com/seblucas/cops⁠ from @seblucas

⁠Prerequisites

  1. PHP 5.3, 5.4, 5.5, 5.6, 7.X or hhvm with GD image processing, Libxml, Intl, Json & SQLite3 support (PHP 5.6 or later recommended).
  2. A web server with PHP support. I tested with various version of Nginx and Apache. Other people reported it working with Apache and Cherokee. You can also use PHP embedded server (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer⁠)
  3. The path to a calibre library (metadata.db, format, & cover files).

On any Debian based Linux you can use : apt-get install php5-gd php5-sqlite php5-json php5-intl

If you use Debian Stretch : apt-get install php7.0-gd php7.0-sqlite3 php7.0-json php7.0-intl php7.0-xml php7.0-mbstring php7.0-zip

On Centos you may have to add : yum install php-xml

⁠Install a release (Easiest way)

  1. Extract the zip file you got from the release page⁠ to a folder in web space (visible to the web server).
  2. If you're doing a first-time install, copy config_local.php.example to config_local.php
  3. Edit config_local.php to match your config.
  4. If needed add other configuration item from config_default.php

If you like Docker, you can also try this multiarch docker container from linuxserver.io⁠ It has builds for x64, armhf and arm64.

⁠Install from sources

git clone https://github.com/seblucas/cops.git # or download lastest zip see below
cd cops
wget https://getcomposer.org/composer.phar
php composer.phar global require "fxp/composer-asset-plugin:~1.1"
php composer.phar install --no-dev --optimize-autoloader

After that you can use the previous how-to starting at the second step.

Note that instead of cloning you can also get latest master as zip⁠

Note that if your PHP version is lower that 5.6, then you may have to remove composer.lock before starting the last line.

⁠Where to put my Calibre directory ?

Long story short : ALWAYS outside of COPS's directory especially if COPS is installed on a VPS / Server. If you follow my advice then your data will be safe.

If you choose to put your Calibre directory inside your web directory and use Nginx then you will have to edit /etc/nginx/mime.types to add these lines :

application/epub+zip epub;
application/x-mobipocket-ebook mobi prc azw;

⁠Known problems

Not a lot, except for the bad quality of the code (first PHP project ever) ;)

Please see https://github.com/seblucas/cops/issues⁠ for open issues

⁠Need help

Please read https://github.com/seblucas/cops/wiki⁠ and check the FAQ.

⁠Contributing

As you could see here⁠, I appreciate every contributions and there were a lot over time. So don't be shy and submit your Pull Requests.

Note to translators : please prefer using Transifex⁠ instead of doing a PR.

I only have one limit (I may have more but that one is the worse) : COPS' goal is to provide an alternative to Calibre's content server and not to replace Calibre entirely. So I will refuse any PR making changes to the database content.

⁠Credits

External libraries used :

⁠Copyright & License

COPS - 2012-2019 (c) Sébastien Lucas

See COPYING and file headers for license info

Tag summary

Content type

Image

Digest

sha256:0c9f76000…

Size

59 MB

Last updated

5 months ago

docker pull mikespub/seblucas-cops