Kind of inspired by https://github.com/geek1011/BookBrowser/
Download an appropriate release from the release page
Please, please, please be careful. I'm pretty sure it shouldn't eat up your collection, but it might. If your are testing booksing, please copy your files into the import dir. Do not move them until you feel comfortable with booksing.
- Easy-to-use
- List view
- Automatic deletion of duplicates and unparsable epubs
- Automatic sorting of books based on Author
- Users meilisearch for blazing fast fuzzy search
Set the following env vars to configure booksing:
| env var | default | required | purpose |
|---|---|---|---|
| BOOKSING_BINDADDRESS | localhost:7132 |
❌ | The bind address, if external access is needed this should be changed to :7132 |
| BOOKSING_BOOKDIR | ./books/ |
❌ | The directory where books are stored after importing |
| BOOKSING_FAILDIR | ./failed |
❌ | The directory where books are moved if the import fails |
| BOOKSING_IMPORTDIR | ./import |
❌ | The directory where booksing will periodically look for books |
| BOOKSING_LOGLEVEL | info |
❌ | determines the loglevel, supported values: error, warning, info, debug |
| BOOKSING_MAXSIZE | 0 |
❌ | If set, any epub larger than this size in bytes will be automatically deleted, can be useful with limited diskspace |
| BOOKSING_TIMEZONE | Europe/Amsterdam |
❌ | Timezone used for storing all time information |
| BOOKSING_MEILIADDRESS | http://localhost:7700 |
❌ | Address to find meilisearch |
| BOOKSING_MEILISECRET | "" |
❌ | Secret to connect to meilisearch |
$ mkdir booksing booksing/failed booksing/import booksing/db
$ cd booksing
$ wget 'https://github.com/gnur/booksing/releases/download/v9.0.5/booksing_9.0.5_linux_x86_64.tar.gz'
$ tar xzf booksing*
$ mkdir books db failed import
$ ./booksing &
$ mv ~/library/*.epub import/
# visit localhost:7132 to see the books in the interface
There is an example systemd unit file available on the releases page, can also be found in includes/booksing.service