Calibre OPDS (and HTML) PHP Server : web-based light alternative to Calibre content server / Calibre2OPDS to serve ebooks (epub, mobi, pdf, ...) http://blog.slucas.fr/en/oss/calibre-opds-php-server
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' преди 8 години
icons Improve the compatibility with IOS преди 10 години
images Images for feed categories - new set преди 8 години
lang Update Localization_pt_PT.json преди 8 години
resources In case the filename contains non ASCII characters then follow rfc6266. fix #253 преди 8 години
styles Remove the stencil. Break the links. fix #148 преди 10 години
templates Fixed css to show filter correctly преди 8 години
test Use rawurlencode so that the spaces are remplaced by %20 and not +. Will hopefully help with IIS URL Rewriting преди 8 години
tools Remove all trailing whitespaces преди 8 години
.gitignore Added support for username based configs преди 9 години
.hgtags Étiquette 1.0.0RC3 ajoutée à la révision 681dce395a60 преди 9 години
.htaccess Reorder the .htaccess to make it more consistant преди 8 години
.travis.yml Change the way the build matrix is done so that the sauce addon is only enabled when it'll be actually used. преди 8 години
CHANGELOG Prepare the changelog for the next release преди 8 години
COPYING Add v0.0.1 преди 12 години
JSON_renderer.php Add another ugly hack to help Kindle. fix #165 преди 9 години
OPDS_renderer.php Fix the détection of bad publication date. fix #245 преди 8 години
README.md chore: advert the docker version. fix #215 преди 8 години
about.html Fixed typo in 'libraries' преди 8 години
author.php Fix author list when a book has many author. Was broken for a long time. преди 9 години
base.php Rating icons also for rating details преди 8 години
book.php Fix the détection of bad publication date. fix #245 преди 8 години
build.xml Update Phing file. преди 10 години
checkconfig.php Add a formal check for the PHP version. I still have a lot of people trying with PHP 5.2.X преди 9 години
composer.json Upgrade to latest sausage преди 10 години
config.php Added support for username based configs преди 9 години
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 преди 9 години
config_local.php.example Cleanly fix the problems with line feed преди 10 години
customcolumn.php Fix number of books per custom column value (missing for bootstrap template). fix #172 преди 9 години
data.php Add mimetype to most audiobooks formats around. fix #211 преди 8 години
epubfs.php Fix headers. re #52 преди 10 години
epubreader.php Change viewport in epubreader преди 10 години
favicon.ico Add v0.0.1 преди 12 години
feed.php Fix warnings an code enhancement. преди 10 години
fetch.php Duplicate преди 10 години
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. преди 10 години
index.php org\.ebookdroid преди 8 години
language.php Fix the remaining number of elements. re #79 преди 9 години
login.html Update jquery from 1.11.0 to 1.11.1 преди 9 години
phpunit.xml Add another ignored directory. преди 10 години
publisher.php Add the number of elements with the publishers. re #79 преди 9 години
rating.php Fix the remaining number of elements. re #79 преди 9 години
sendtomail.php Fix warnings an code enhancement. преди 10 години
serie.php Centralize a little the code преди 9 години
tag.php Unneeded constant преди 9 години
transliteration.php Transliteration of search text преди 8 години
util.js Forgot to make jshint happy ;). re #79 преди 9 години
web.config Add the rewrite rules for IIS. It's still mandatory to install http://www.iis.net/downloads/microsoft/url-rewrite. fix #249 преди 8 години

README.md

COPS

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.

Prerequisites

  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 (https://github.com/seblucas/cops/wiki/Howto---PhpEmbeddedServer)
  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

Install

  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 https://github.com/seblucas/cops/issues for open issues

Need help

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

Credits

External libraries used :

Copyright & License

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

See COPYING and file headers for license info