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
Du kan inte välja fler än 25 ämnen Ämnen måste starta med en bokstav eller siffra, kan innehålla bindestreck ('-') och vara max 35 tecken långa.
Theodotos Andreou a51daaea0e Fixed typo in 'libraries' 8 år sedan
icons Improve the compatibility with IOS 10 år sedan
images Images for feed categories - new set 8 år sedan
lang Update Localization_pt_PT.json 8 år sedan
resources In case the filename contains non ASCII characters then follow rfc6266. fix #253 8 år sedan
styles Remove the stencil. Break the links. fix #148 10 år sedan
templates Fixed css to show filter correctly 8 år sedan
test Use rawurlencode so that the spaces are remplaced by %20 and not +. Will hopefully help with IIS URL Rewriting 8 år sedan
tools Remove all trailing whitespaces 8 år sedan
.gitignore Added support for username based configs 9 år sedan
.hgtags Étiquette 1.0.0RC3 ajoutée à la révision 681dce395a60 9 år sedan
.htaccess Reorder the .htaccess to make it more consistant 8 år sedan
.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 år sedan
CHANGELOG Prepare the changelog for the next release 8 år sedan
COPYING Add v0.0.1 12 år sedan
JSON_renderer.php Add another ugly hack to help Kindle. fix #165 9 år sedan
OPDS_renderer.php Fix the détection of bad publication date. fix #245 8 år sedan
README.md chore: advert the docker version. fix #215 8 år sedan
about.html Fixed typo in 'libraries' 8 år sedan
author.php Fix author list when a book has many author. Was broken for a long time. 9 år sedan
base.php Rating icons also for rating details 8 år sedan
book.php Fix the détection of bad publication date. fix #245 8 år sedan
build.xml Update Phing file. 10 år sedan
checkconfig.php Add a formal check for the PHP version. I still have a lot of people trying with PHP 5.2.X 9 år sedan
composer.json Upgrade to latest sausage 10 år sedan
config.php Added support for username based configs 9 år sedan
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 år sedan
config_local.php.example Cleanly fix the problems with line feed 10 år sedan
customcolumn.php Fix number of books per custom column value (missing for bootstrap template). fix #172 9 år sedan
data.php Add mimetype to most audiobooks formats around. fix #211 8 år sedan
epubfs.php Fix headers. re #52 10 år sedan
epubreader.php Change viewport in epubreader 10 år sedan
favicon.ico Add v0.0.1 12 år sedan
feed.php Fix warnings an code enhancement. 10 år sedan
fetch.php Duplicate 10 år sedan
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 år sedan
index.php org\.ebookdroid 8 år sedan
language.php Fix the remaining number of elements. re #79 9 år sedan
login.html Update jquery from 1.11.0 to 1.11.1 9 år sedan
phpunit.xml Add another ignored directory. 10 år sedan
publisher.php Add the number of elements with the publishers. re #79 9 år sedan
rating.php Fix the remaining number of elements. re #79 9 år sedan
sendtomail.php Fix warnings an code enhancement. 10 år sedan
serie.php Centralize a little the code 9 år sedan
tag.php Unneeded constant 9 år sedan
transliteration.php Transliteration of search text 8 år sedan
util.js Forgot to make jshint happy ;). re #79 9 år sedan
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 år sedan

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