flibgolite

For advanced sutup you can edit config/config.yml selfexplanatory configuration file.
This file by default is located in config subfolder of program file location.

To change location of a folder just edit corresponding line in config.yml

For example, if you need to setup separate folder for new aquired books uncomment line

NEW: "books/new"

and change books/new to the appropriate folder path.

You can change OPDS default 8085 http port to yours

# OPDS-server port so opds can be found at http://<server name or IP-address>:8085/opds
PORT: 8085

Here you can set OPDS-server preferred name

# OPDS-server title that is displayed in a book reader
TITLE: "FLib Go Go Go!!!"

You can change the number of books your bookreader will load at a time when you page (pulldown/update the screen)

# OPDS feeds entries page size
PAGE_SIZE: 30

Do not set this value more than default. With lower values it updates faster.

There are some easy features that may help to tune your language experience

1. By default new books processing is limited to English, Russian and Ukrainian books. You can add others like "de", "fr", "it" and so on.

# Accept only these languages publications. Add others if needed please.
ACCEPTED: "en, ru, uk"

1. By default bookreader will show menues and comments in English "en" If you are Rusiian or Ukranian you can change this setting to "ru" or "uk"

# Default english locale for opds feeds (bookreaders opds menu tree) can be changed to:
# "uk" for Ukrainian, 
# "ru" for Russian 
DEFAULT: "en"

1. If your native language is other then tree mentioned above for your convinience you can make language file and put it in config/locales folder

# Locales folder. You can add your own locale file there like en.yml, ru.yml, uk.yml
DIR: "config/locales"

For example, for German, copy en.yml to de.yml and translate the phrases into German to the right of the colon separator. Leave %d format symbols untouchced. Something like this:

Found authors - %d: Autoren gefunden - %d

Don't forget to replace alphabet string ABC to German. This will ensure that German names and titles are displayed and sorted correctly.

1. Genres tree selection language adaptation can be done by editing the file genres.xml in config folder

  TREE_FILE: "config/genres.xml"
  # Alternative genres tree can be used (Russian only, sorry) 
  # TREE_FILE: "config/alt_genres.xml"

This can be done by adding language specific lines in genres.xml file

<genre-descr lang="en" title="Alternative history"/>
<genre-descr lang="ru" title="Альтернативная история"/>
<genre-descr lang="uk" title="Альтернативна історія"/>
<genre-descr lang="de" title="Alternative Geschichte"/>

Default configuration file config.yml with folder tree is created at the first programm run. You can edit it and your edits will not be canceled the next time you run the program. Thus, you can distribute the files used by the program into the necessary folders. With reasonable care, you can edit or add any configuration file located by default in the config folder and it will not be deleted or overwriten.

library:
  # Selfexplained folders
  STOCK: "books/stock" # Book stock
  TRASH: "books/trash" # Error and duplicate files and archives wil be moved to this folder 
  # NEW: "books/new" # Uncomment the line to have separate folder for new acquired books

genres:
  TREE_FILE: "config/genres.xml"
  # Alternative genres tree can be used (Russian only, sorry) 
  # TREE_FILE: "config/alt_genres.xml"
  
database:
  DSN: "dbdata/books.db"
  # Delay before start each new acquisitions processing
  POLL_DELAY: 30 
  # Maximum simultaneous new aquisitios processing threads
  MAX_SCAN_THREADS: 3

logs:
  # Logs are here
  # To redirect the log output to console (stdout) just comment out the appropriate line OPDS or SCAN
  OPDS: "logs/opds.log"
  SCAN: "logs/scan.log"
   # Logging levels: D - debug, I - info, W - warnings (default), E - errors
  LEVEL: "W" 

opds:
  # OPDS-server port so opds can be found at http://<server name or IP-address>:8085/opds
  PORT: 8085
  # OPDS-server title that is displayed in a book reader
  TITLE: "FLib Go Go Go!!!"
  # OPDS feeds entries page size
  PAGE_SIZE: 30

locales:
  # Locales folder. You can add your own locale file there like en.yml, ru.yml, uk.yml
  DIR: "config/locales"
  # Default english locale for opds feeds (bookreaders opds menu tree) can be changed to:
  # "uk" for Ukrainian, 
  # "ru" for Russian 
  DEFAULT: "en"
  # Accept only these languages publications. Add others if needed please.
  ACCEPTED: "en, ru, uk"

Book index is stored in SQLite database file located in dbdata folder. It is created at the first program run and is not intended for manual editing.

DSN: "dbdata/books.db"

While running program writes opds.log and scan.log located in logs folder.

OPDS: "logs/opds.log"
SCAN: "logs/scan.log"

opds.log contains records about bookreaders requests.
scan.log contains records about new books and archive indexing.
To redirect the log output to console (stdout) just comment out the appropriate line OPDS or SCAN.

You don't need to delete logs to free up disk space, as logs are rotated (overwrite) after 7 days.

You can setup logging level (verbosity) to one of: D - debug, I - info, W - warnings (default), E - errors

LEVEL: "W" 

As an option you may run program in docker container

If you have any security doubts about builded executables or there is no suitable one you may easily build it yourself.
To build an executable install Golang, Git clone FLibGoLite repositiry and run go build ./cmd/flibgolite
It's better to build it on the host the service will run. You will get executable right for the host OS and hardware.
For crosscompile install and run GNU make with Makefile