Skip to content


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


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 ""`

`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)


nssm install lazylibrarian
  • change the following settings:


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



(Thanks to for the instructions)



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.


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 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
Instructions on modifying the ubuntu config are here:

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 for installation details


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 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.


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.


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

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

  • 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

  • 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 Lazylibrarian does not include an unrar library as it is architecture dependant.

You can download UnRAR library sources (and/or binaries) from: 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, or a later version, not the binary.

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


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 or 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 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 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):

image: linuxserver/lazylibrarian
container_name: lazylibrarian
- PUID=1001
- PGID=1001
- TZ=Pacific/Noumea
- LANG=fr_FR.UTF-8
- LC_CTYPE="fr_FR.UTF-8"
- LC_TIME="fr_FR.UTF-8"
- LC_PAPER="fr_FR.UTF-8"
- LC_NAME="fr_FR.UTF-8"
- /home/lazylibrarian:/config
- ./.bashrc:/root/.bashrc:ro
- 5299:5299
restart: unless-stopped

and put this in your docker bashrc file :

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"

Thanks to @foulou for the information