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