flibgolite

README

FLibGoLite

русский вариант здесь
український варіант тут

BETA RELEASE v0.1.x *

*This software release has not been tested thoroughly yet but based on flibgo it does the job

---

FLibGoLite is easy to use home library OPDS server

The Open Publication Distribution System (OPDS) catalog format is a syndication format for electronic publications based on Atom and HTTP. OPDS catalogs enable the aggregation, distribution, discovery, and acquisition of electronic publications. (Wikipedia)

__FLibGoLite__is multiplatform lightweight OPDS server with SQLite database book search index Current FLibGoLite release only supports FB2 publications, both individual files and zip archives.

OPDS-catalog is checked and works with mobile bookreaders applications FBReader and PocketBook Reader

FLibGoLite program is written in GO as a single executable and doesn't require any prerequsites.
All you have to do is to download, install and start it.

Download

---

Download your OS and Hardware specific program build

OS	Hardware	Program executable	Tested
Windows	Intel, AMD 32-bit	flibgolite-linux-386.exe	Yes
Windows	Intel, AMD 64-bit	flibgolite-linux-amd64.exe	Yes
OS X (MAC)	64-bit	flibgolite-darwin-64	No
Linux	Intel, AMD 32-bit	flibgolite-linux-386	No
Linux	Intel, AMD 64-bit	flibgolite-linux-amd64	Yes
Linux	ARM 32-bit (armhf)	flibgolite-linux-arm-6	Yes
Linux	ARM 64-bit (armv8)	flibgolite-linux-arm64	Yes

You may rename downloaded program executable to flibgolite or any other name you want. For convenience, flibgolite name will be used below in this README.

Install and start

---

Although FLibGoLite program can be run from command line, the preferred setup is program to be installed as a system service running in background that will automaticaly start after power on or reboot.

Service installation and control requires administrator rights. On Linux you may use sudo.

On Windows open Powershell as Administrator and run commands to install, start and check service status

1. In Windows Powershell terminal run command

Install service:

  ./flibgolite -service install

Start service

  ./flibgolite -service start

And check that service is running

  ./flibgolite -service status

1. On Linux open terminal and run commands:

  sudo ./flibgolite -service install
  sudo ./flibgolite -service start
  sudo ./flibgolite -service status

If status is like "running" you can start to use it.

Use

---

At the first run program will create the set of subfolders in the folder where program is located

flibgolite
├─┬─ books  
| ├─── new   - new book files and/or zip archives should be placed here to be added to the index
| ├─── stock - indexed library book files and archives are stored here
| └─── trash - files with processing errors will go here
├─┬─ config - contains main configiration file config.yml and genre tree file
| └─── locales - subfolder for localization files 
├─── dbdata - database with book index resides here
└─── logs - scan and opds rotating logs are here

Put your book files or book file zip archives in books/new folder and start to setup bookreader. Meanwhile book decriptions will be added to book index of OPDS-catalog/

Set bookreader opds-catalog to http://<server_name or IP-address>:8085/opds to choose and download books on your device to read. See bookreader manual/help.

Tip: While searching book in bookreader use native keyboard layout to fill dearch pattern. For example, don't use Latin English "i" instead of Cyrillic Ukrainian "i", because it's not the same Unicode symbol.

---

Advanced usage

From command line run ./flibgolite -help to see run options

Usage:
./flibgolite [OPTION]

With no OPTION program will run in console mode (Ctrl+C to exit)  
Caution: Only one OPTION can be used at a time

OPTION should be one of:

-service [action]     control FLibGoLite service
	where action is one of: install, start, stop, restart, uninstall, status  
-reindex              empty book stock index and then scan book stock directory to add books to index
-config               create default config file in ./config folder for customization and exit
-help                 display this help and exit
-version              output version information and exit

Examples:

./flibgolite                      	  Run FLibGoLite console mode
sudo ./flibgolite -service install    Install FLibGoLite as a system service
sudo ./flibgolite -service start	

Detalization

1. Main configuration file

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.

2. Locations of folders setup

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

For example, if you need to change the folder for new aquired books

NEW: "books/new"

just change books/new to the appropriate folder path.

3. OPDS tuning

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

You can change the number of books your bookreader will load when you page (pulldown the screen)

# OPDS feeds entries page size
PAGE_SIZE: 30

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

4. Localization tips

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: "uk"

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: Found Autoren gefunden - %d

Don't forget to replace alphabet string ABC to German. This ensures that the selections are in the correct alphabetical order.

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

5. Default config.yml

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"
  NEW: "books/new"
  TRASH: "books/trash"

genres:
  TREE_FILE: "config/genres.xml"
  # Alternative genres tree can be used (Russian only, sorry) 
  # TREE_FILE: "config/alt_genres.xml"
  
database:
  DSN: "dbdata/flibgolite.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
  OPDS: "logs/opds.log"
  SCAN: "logs/scan.log"
  DEBUG: false 

opds:
  # OPDS-server port so opds can be found at http://<server name or IP-address>:8085/opds
  PORT: 8085
  # 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: "uk"
  # Accept only these languages publications. Add others if needed please.
  ACCEPTED: "en, ru, uk"

6. Book index database

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/flibgolite.db"

7. Logging

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.

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

8. Build from sources

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

---

Comments and suggestions are welcome

ANY CONCEPT CAN BE RETHINKED :)