FAQ

I use COPS with a Kobo e-reader and I can't download any books

You have to enable URL rewriting ($config['cops_use_url_rewriting']) to make it work.

How do I protect my COPS library with user/password

• If you're using Apache then check at the bottom of .htaccess.
• If you use any other browser, please google about enabling HTTP basic authentication.

Each time I install a new version of COPS, all my settings are lost

You may have modified config_default.php and you shouldn't, all your settings should be config_local.php which is never overwritten.

With a specific device, I only see a gray screen. On my favourite desktop browser everything work as expected

Please open an issue with the user agent of your device (check with http://whatsmyua.com/).

I've password protected my COPS and I can't download books with my Android device

There's an old bug with Android about that. Long story short, you'll have to use an OPDS client to download your books (FBReaderJ for example).

I've password protected my COPS and my Kobo can't access it anymore

Kobo's browser don't support HTTP basic auth but you can use login.html as a workaround.

How do I use search in the HTML catalog

You have to click on the cog wheel (top right).

COPS seems to be working correctly (I can see covers and book information) but I can't download books

9 times out of 10, it's due to this setting in config_local.php :

$config['cops_use_url_rewriting'] = "1";

If you enabled URL rewriting, you'll have to make sure your webserver can do it. If you don't know, just remove this line and you'll be able to download books.

You can also check this setting :

    /*
     * SPECIFIC TO NGINX
     * The internal directory set in nginx config file
     * Leave empty if you don't know what you're doing
     */
    $config['calibre_internal_directory'] = ''; 

As stated in the comment : it should only be filled when using Nginx. If you don't know if you're using Nginx or not then you're probably not running it so leave it empty.