-
Notifications
You must be signed in to change notification settings - Fork 7
- I use COPS with a Kobo e-reader and I can't download any books
- How do I protect my COPS library with user/password ?
- Each time I install a new version of COPS, all my settings are lost
- With a specific device, I only see a gray screen. On my favorite desktop browser everything work as expected
- I've password protected my COPS and I can't download books with my Android device
- I've password protected my COPS and my Kobo can't access it anymore
- How do I use search in the HTML catalog
- COPS seems to work fine, I can download most of my ebooks but some fails
- How do I enable the send to function in COPS ?
- After update my Synology's firmware to DSM 5, COPS is not working anymore
- What packages are needed to run on FreeBSD
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 in config_local.php which is never overwritten.
A workaround has been added for Kindles and Sony PRS-TX. Cybook's browser don't handle HTML5 at all so the last working version of COPS is 0.4.0.
In case your device is not listed above, 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.
Sony's browser don't like authentication while downloading books. You can check at the bottom of .htaccess for a workaround.
Please note that Aldiko also has the same problem so please always try to remove authentication check before filing a bug.
How do I use search in the HTML catalog
You have to click on the cog wheel (top right).
COPS seems to work fine, I can download most of my ebooks but some fails
It may be because the file path stored on Calibre library is different from the actual path on disk (often a case difference). You can check your library with checkconfig.php?full=1.
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.
How do I enable the send to function in COPS ?
You can enable the send to function in COPS by inserting the correct informations in your config file.
copy the appropriate section from config_default.php in your config_local.php
/*
* Enable and configure Send To Kindle (or Email) feature.
*
* Don't forget to authorize the sender email you configured in your Kindle's Approved Personal Document E-mail List.
*
* If you want to use a simple smtp server (provided by your ISP for example), you can configure it like that :
* $config['cops_mail_configuration'] = array( "smtp.host" => "smtp.free.fr",
* "smtp.username" => "",
* "smtp.password" => "",
* "smtp.secure" => "",
* "address.from" => "cops@slucas.fr"
* );
*
* For Gmail (ssl is mandatory) :
* $config['cops_mail_configuration'] = array( "smtp.host" => "smtp.gmail.com",
* "smtp.username" => "YOUR GMAIL ADRESS",
* "smtp.password" => "YOUR GMAIL PASSWORD",
* "smtp.secure" => "ssl",
* "address.from" => "cops@slucas.fr"
* );
*/
$config['cops_mail_configuration'] = NULL;
remove the comments, you get that sort of config
$config['cops_mail_configuration'] = array( "smtp.host" => "smtp.gmail.com",
"smtp.username" => "YOUR GMAIL ADRESS",
"smtp.password" => "YOUR GMAIL PASSWORD",
"smtp.secure" => "ssl",
"address.from" => "cops@slucas.fr"
);
insert your own parameters
save the file
Tip : if you use Gmail to send email, you have to authorize external applications to use Gmail. (at first use, you could receive a security alert, it is normal if you did not activate the authorization before).
Tip : if you use GMX to send mail, you have to manually activate POP/SMTP/IMAP functionality, by default it is deactivated. (at first use, you could receive a security mail, it is normal if you did not manually activate the functionality before).
You should see a mail icon appear to send mail.
the first time you click on it a dialog will appear to ask you what is the destination mail. After that this mail will be used for the rest of the session.
you can parameter the destination mail in the configuration of Cops (click on the wrench icon at the bottom left)
for example, see
http://cops-demo.slucas.fr/index.php?page=19
Which format of the book will be sent ?
The rules are here :
https://github.com/seblucas/cops/blob/master/lib/Book.php#L265
from least interesting format to best interesting format (so MOBI is always prefered).
How to deal with multiple kindle devices and addresses ?
In order to clearly identify your kindle devices, you need to setup a name and a specific email for each device.
As explained in the following page
https://www.amazon.com/gp/sendtokindle/email
After update my Synology's firmware to DSM 5, COPS is not working anymore
Starting with DSM5 Synology stopped providing mod_auth which was used in COPS authentication system. X-SendFile is also not working anymore and I still have doubts about URL Rewriting.
You can try checking the "mssql" checkbox or if it doesn't work there is the hard way
What packages are needed to run on FreeBSD
In addition to following the setup instructions in the readme.md file with obvious changes since those are for Debian, not FreeBSD, the following packages need to be installed to get COPS working (assuming php56 is used):
- devel/pecl-intl
- textproc/php56-dom
- graphics/php56-gd
- devel/php56-json
- converters/php56-mbstring
- databases/php56-pdo_sqlite
- databases/php56-sqlite3
- textproc/php56-xml
- archivers/php56-zlib
The above was tested on FreeBSD 10.3, Apache 2.4, mod_php56 (php 5.6).