FAQ¶

We will try to keep some known workarounds issues documented here.

Freenas¶

There are unresolved issues with lazylibrarians internal upgrade mechanism on freenas systems. If you have problems updating, a debug log of the upgrade process would be really helpful since I don't have a freenas to test on. A workaround for the problem is below (taken from the freenas forums)

`service lazylibrarian onestop`

`rm -r /usr/pbi/lazylibrarian-amd64/share/lazylibrarian/LazyLibrarian`

`fetch --no-verify-peer "https://gitlab.com/LazyLibrarian/LazyLibrarian/archive/master.tar.gz"`

`tar xzf master.tar.gz`

`mv LazyLibrarian-master /usr/pbi/lazylibrarian-amd64/share/lazylibrarian/LazyLibrarian`

`chown -R media:media /usr/pbi/lazylibrarian-amd64/share/lazylibrarian/LazyLibrarian`

`rm master.tar.gz`

`service lazylibrarian start`

Running as a Windows Service¶

download
After you download NSSM, right click on NSSM.exe -> Properties -> UNBLOCK.

_NOTE_:  SOME A/V software will flag NSSM.exe is a virus.  ENSURE to add NSSM.exe to your exclusion list.

Put nssm.exe in c:\windows\system32 (or put NSSM in a root folder (ex: c:\nssm\nssm.exe) and add that to your PATH)
Start a command prompt (elevated/admin privileges)

type:

nssm install lazylibrarian

change the following settings:

lazylibrarian_service

Go to services (Start -> Run -> services.msc) change lazylibrarian to automatic.

Profit:

lazylibrarian_service2

(Thanks to https://github.com/seanvree for the instructions)

SSL¶

Installation¶

If you get an error message "You must install pyOpenSSL to use HTTPS" Installing pyOpenSSL on it's own may not be enough. You may also need to install pycrypto, pyasn1, ndg-httpsclient. Seems some installations automatically pull these in when you install pyOpenSSL and some don't.

Errors¶

If you get the error message "SSL: SSLV3_ALERT_HANDSHAKE_FAILURE" when trying to load bookstrap themes The server you are trying to reach requires (SNI) Server Name Indication and will cause a handshake failure if the client is not using this SNI extension.. Support for SNI was only added with python 2.7.9

You may need to upgrade to a more recent version of python 2.7, and also make sure you have the additional modules mentioned in the previous answer (pycrypto, pyasn1, ndg-httpsclient)

If you get the error message SSLError("bad handshake: Error([('SSL routines', 'tls_process_server_certificate', 'certificate verify failed')]) your version of requests/cryptography is incomplete or outdated. Try pip install -U cryptography, pyopenssl, requests[security]

SSL on Ubuntu 20.04/20.10¶

If you get ssl errors on goodreads sync you need to modify your ubuntu ssl settings, this is because ubuntu have decided to disable some older ssl features that goodreads still uses. There are several different workarounds...
1. Ask Goodreads to update their TLS to use TLS1.2 or later (good luck with that!)
2. Use the official SSL libraries from www.openssl.org or the debian packages which don't include the ubuntu restrictions
3. Downgrade the Ubuntu packages to the ones shipped with 19.10 which don't include the restrictions
4. Modify ubuntu ssl config to switch off the restrictions (works on 20.10 but not confirmed on 20.04)
The debian packages can be downloaded from
https://packages.debian.org/sid/openssl
https://packages.debian.org/sid/libssl1.1
Instructions on modifying the ubuntu config are here: https://discourse.ubuntu.com/t/default-to-tls-v1-2-in-all-tls-libraries-in-20-04-lts/12464

Magic library¶

This library is used to detect filetypes where there is no extension on the filename (libgen does this sometimes). It's usually included in linux/mac installations, but if not, or if you are on windows see https://github.com/ahupp/python-magic for installation details

MAC¶

Many mac installations of python include an old version of TLS which is no longer supported by git (and pip and lots of other websites). This will stop lazylibrarian upgrading as we can't talk to git. LazyLibrarian will report the ssl and tls versions in the startup log, and in the config/system info popup. The problem is described here https://news.ycombinator.com/item?id=13539034 with some suggested workarounds. If someone with a mac has got it working, Let us know and we will update the documentation.

Also some mac installations can't find "gs" as a system app. See the "Magazine Covers" section below.

Note¶

GoodReads has issued a notice that at some future date they will enforce https only access to their api, and at that point lazylibrarian will not be able to use their service without these ssl libraries.

Synology¶

Magazine covers¶

Possibly applies to other systems with old or broken ghostscript or imagemagick or if you get a message in your lazylibrarian log saying
Command '['which', 'gs']' returned non-zero exit status 1
it means that "which" can't find "gs"

Option 1¶

If you already have a working gs on your system, simply copy it into the lazylibrarian program folder (the folder containing LazyLibrarian.py)

Option 2¶

If you don't have gs, or the system gs is too old
(this assumes your LazyLibrarian installation is in /volume1/@appstore/LazyLibrarian
If not, you will need to adjust the path in step 2, it should be the folder containing LazyLibrarian.py)

ssh into your NAS
Switch to your LazyLibrarian installation directory
cd /volume1/@appstore/LazyLibrarian
Download a new version of GhostScript from here - 9.18 was the latest version at the time of writing this wiki entry, you can use a later version if one is available
wget https://github.com/ArtifexSoftware/ghostpdl-downloads/releases/download/gs918/ghostscript-9.18-linux-x86_64.tgz
Unpack the archive
tar -xvf ghostscript-9.18-linux-x86_64.tgz
Move the new ghostscript into the LazyLibrarian directory and change the name to gs
mv ghostscript-9.18-linux-x86_64/gs-918-linux_x86_64 gs
Delete the unwanted files
rm -rf ghostscript-9.18-linux-x86_64*

That way we don't disturb any of the other software on Synology that might want a different version of gs, we use our own private copy.

Synology Dockers¶

Possibly applies to dockers on other systems too.

If you are running both lazylibrarian and calibre in separate dockers you may hit file permission problems unless one of the dockers has elevated privileges. You need to give elevated privileges either to the calibre one so it will successfully access the files, or to the lazylibrarian one so it can chmod the files.

If you want to chmod the files from the lazylibrarian docker please edit config.ini and change file permissions to 0o666 (default is 0o644) this is so that the calibre docker can read and write (delete) the files as it processes them.

If you want to use the aptalca docker for calibre, please set EDGE to 1 so it upgrades to latest calibre as the default version in that docker is quite old and seems to have issues talking to newer calibre versions.

For elevated privileges on synology you have an option when you configure the docker (a simple box to check)

If you have lazylibrarian in a docker and want to talk to calibre it is HIGHLY recommended that you use the linuxserver docker for lazylibrarian (link is on the lazylibrarian git page). This docker includes calibredb so you can talk to a remote calibre outside the docker, which can be calibre in another docker or a standalone calibre instance, possibly on a different machine.

Thanks to yongbi85 for the info

unrar-library and cbr/cbz¶

cbz magazines should just work. They are zipped collections of jpeg images. Lazylibrarian looks for page 000, or page -00, or cover.jpg This should cover most cases. If there is another common format that I haven't included, please let me know.

cbr is a little more difficult. These are rar archives, so we need an unrar library. You may already have one on your system (usually called unrar.dll or libunrar.so). Lazylibrarian does not include an unrar library as it is architecture dependant.

You can download UnRAR library sources (and/or binaries) from: http://www.rarlab.com/rar_add.htm and compile (you may need to rename the makefile that you want to use according to your OS) and install it from there: Note that for lazylibrarian we need the library sources, https://www.rarlab.com/rar/unrarsrc-5.6.4.tar.gz or a later version, not the binary.

wget https://www.rarlab.com/rar/unrarsrc-5.6.4.tar.gz
tar -xvzf unrarsrc-5.6.4.tar.gz
cd unrar
make lib  
sudo make install-lib  
sudo ldconfig

For Windows you can also download the already compiled library http://www.rarlab.com/rar/UnRARDLL.exe.

LibGen¶

Libgen are getting difficult about robot programs scraping their site so often we get 403 or 404 errors back

Changing libgen mirror often helps, try gen.lib.rus.ec or libgen.pw or try an internet search for a different libgen mirror
If you are behind a vpn try turning that off or using a different server as libgen blacklists some ip addresses
Changing lazylibrarian user_agent might help, in config.ini you could add something like
user_agent = Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/52.0.2743.116 Safari/537.36
which will make lazylibrarian look like a regular browser
Not all libgen mirrors accept all search types. Currently gen.lib.rus.ec is working with search types "fiction" "comics" and "search.php"
or just leave it and try another day as libgen seems to only block temporarily

macOS Mojave¶

After upgrading to macOS Mojave 10.14.2 LazyLibrarian does not start when using LazyLibrarian.app. This is probably due to higher security implemented in Mojave.
The following error message is shown in a system popup:
"Not authorised to send Apple events to Finder (-1743)". With an "Edit" and a "OK" button.

Advice from another mac user (@sebrk): "I tried to recreate the script by simply copying the contents which upon execution asked if it could be allowed to message "Finder". I allowed it and it seemed to work. So the simple solution here is probably to recompile the script using Mojave"
If someone with access to Mojave and also an earlier version of macOS could try this and upload us a new version of the script that works on Mojave (and preferably also earlier versions) it would be really helpful as I don't have access to a mac.

Docker locales¶

Dockers are usually set up with english locale. If your host locale is not english you may need to add the following to your docker to get accented book titles and magazine names working properly.

For French locale use this for your docker env (change all locale accordingly):

lazylibrarian:
image: linuxserver/lazylibrarian
container_name: lazylibrarian
environment:
- PUID=1001
- PGID=1001
- TZ=Pacific/Noumea
- PYTHONIOENCODING=utf-8
- LANG=fr_FR.UTF-8
- LANGUAGE=fr_FR:fr
- LC_CTYPE="fr_FR.UTF-8"
- LC_NUMERIC="fr_FR.UTF-8"
- LC_TIME="fr_FR.UTF-8"
- LC_COLLATE="fr_FR.UTF-8"
- LC_MONETARY="fr_FR.UTF-8"
- LC_MESSAGES="fr_FR.UTF-8"
- LC_PAPER="fr_FR.UTF-8"
- LC_NAME="fr_FR.UTF-8"
- LC_ADDRESS="fr_FR.UTF-8"
- LC_TELEPHONE="fr_FR.UTF-8"
- LC_MEASUREMENT="fr_FR.UTF-8"
- LC_IDENTIFICATION="fr_FR.UTF-8"
volumes:
- /home/lazylibrarian:/config
- /NFS:/NFS
- ./.bashrc:/root/.bashrc:ro
ports:
- 5299:5299
restart: unless-stopped

and put this in your docker bashrc file :

export PYTHONIOENCODING=utf-8
export LANG=fr_FR.UTF-8
export LANGUAGE=fr_FR:fr
export LC_CTYPE="fr_FR.UTF-8"
export LC_NUMERIC="fr_FR.UTF-8"
export LC_TIME="fr_FR.UTF-8"
export LC_COLLATE="fr_FR.UTF-8"
export LC_MONETARY="fr_FR.UTF-8"
export LC_MESSAGES="fr_FR.UTF-8"
export LC_PAPER="fr_FR.UTF-8"
export LC_NAME="fr_FR.UTF-8"
export LC_ADDRESS="fr_FR.UTF-8"
export LC_TELEPHONE="fr_FR.UTF-8"
export LC_MEASUREMENT="fr_FR.UTF-8"
export LC_IDENTIFICATION="fr_FR.UTF-8"

Thanks to @foulou for the information