Calibre OPDS (and HTML) PHP Server : web-based light alternative to Calibre content server / Calibre2OPDS to serve ebooks (epub, mobi, pdf, ...)
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Theodotos Andreou a51daaea0e Fixed typo in 'libraries' 6 years ago
icons Improve the compatibility with IOS 9 years ago
images Images for feed categories - new set 6 years ago
lang Update Localization_pt_PT.json 6 years ago
resources In case the filename contains non ASCII characters then follow rfc6266. fix #253 6 years ago
styles Remove the stencil. Break the links. fix #148 8 years ago
templates Fixed css to show filter correctly 7 years ago
test Use rawurlencode so that the spaces are remplaced by %20 and not +. Will hopefully help with IIS URL Rewriting 6 years ago
tools Remove all trailing whitespaces 7 years ago
.gitignore Added support for username based configs 8 years ago
.hgtags Étiquette 1.0.0RC3 ajoutée à la révision 681dce395a60 8 years ago
.htaccess Reorder the .htaccess to make it more consistant 7 years ago
.travis.yml Change the way the build matrix is done so that the sauce addon is only enabled when it'll be actually used. 6 years ago
CHANGELOG Prepare the changelog for the next release 6 years ago
COPYING Add v0.0.1 10 years ago
JSON_renderer.php Add another ugly hack to help Kindle. fix #165 8 years ago
OPDS_renderer.php Fix the détection of bad publication date. fix #245 6 years ago chore: advert the docker version. fix #215 6 years ago
about.html Fixed typo in 'libraries' 6 years ago
author.php Fix author list when a book has many author. Was broken for a long time. 8 years ago
base.php Rating icons also for rating details 6 years ago
book.php Fix the détection of bad publication date. fix #245 6 years ago
build.xml Update Phing file. 8 years ago
checkconfig.php Add a formal check for the PHP version. I still have a lot of people trying with PHP 5.2.X 8 years ago
composer.json Upgrade to latest sausage 8 years ago
config.php Added support for username based configs 8 years ago
config_default.php Add the Kindle 4 to the list of device which cannot handle client side rendering (note that Kindle 4 has a UA witn Kindle 3.0). fix #208 7 years ago
config_local.php.example Cleanly fix the problems with line feed 9 years ago
customcolumn.php Fix number of books per custom column value (missing for bootstrap template). fix #172 8 years ago
data.php Add mimetype to most audiobooks formats around. fix #211 6 years ago
epubfs.php Fix headers. re #52 8 years ago
epubreader.php Change viewport in epubreader 8 years ago
favicon.ico Add v0.0.1 10 years ago
feed.php Fix warnings an code enhancement. 8 years ago
fetch.php Duplicate 8 years ago
getJSON.php Big refactoring of the Json handling, I followed what I did from OPDS. It doesn't still feel right but I think it's better. 9 years ago
index.php org\.ebookdroid 6 years ago
language.php Fix the remaining number of elements. re #79 8 years ago
login.html Update jquery from 1.11.0 to 1.11.1 8 years ago
phpunit.xml Add another ignored directory. 9 years ago
publisher.php Add the number of elements with the publishers. re #79 8 years ago
rating.php Fix the remaining number of elements. re #79 8 years ago
sendtomail.php Fix warnings an code enhancement. 8 years ago
serie.php Centralize a little the code 8 years ago
tag.php Unneeded constant 8 years ago
transliteration.php Transliteration of search text 7 years ago
util.js Forgot to make jshint happy ;). re #79 8 years ago
web.config Add the rewrite rules for IIS. It's still mandatory to install fix #249 6 years ago


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

See : COPS's home for more details.

Don't forget to check the Wiki.

Scrutinizer Quality Score

Code Coverage

Build Status

Selenium Test Status

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.
  • With Dropbox / owncloud it's very easy to have an up to date OPDS server.
  • 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.


  1. PHP 5.3, 5.4, 5.5, 5.6 or hhvm with GD image processing, Libxml, Intl, Json & SQLite3 support.
  2. A web server with PHP support. I only tested with various version of Nginx. Other people reported it working with Apache and Cherokee. You can also use PHP embedded server (
  3. The path to a calibre library (metadata.db, format, & cover files).

On any Debian base Linux you can use : aptitude install php5-gd php5-sqlite php5-json php5-intl

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


  1. Extract the zip file 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 choose to put your Calibre directory inside your web directory then you will have to edit /etc/nginx/mime.types to add this line : application/epub+zip epub;

If you like Docker, you can also this project

Known problems

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

Please see for open issues

Need help

Please read and check the FAQ.


External libraries used :

Copyright & License

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

See COPYING and file headers for license info