Bookshelf-Traveller

Bookshelf-Traveller

Docker app from DonKevlar's Repository

Overview

A simple discord bot that allows you to listen to your audiobooks and manage your audiobookshelf (ABS) server. For the full guide, please visit the bookshelf-traveller repository.

Requirements

This requires an audiobookshelf server and a discord application token.

Runtime arguments

Network
bridge
Shell
sh
Privileged
false

Template configuration

Discord TokenVariable

Discord application token.

Target
DISCORD_TOKEN
Value
INSERT_TOKEN
Client IDVariable

Discord application client ID. This can be found under the 'OAuth2' tab in the discord dev portal.

Target
CLIENT_ID
Bookshelf TokenVariable

ABS Token, generated in the settings page of the user. Accepts all user types, but will have limitations if not admin.

Target
bookshelfToken
Value
INSERT_TOKEN
Audiobookshelf URLVariable

Audiobookshelf url. ex: http://127.0.0.1:13378

Target
bookshelfURL
Default
http://127.0.0.1:13378
Value
http://127.0.0.1:13378
Persistant DBPathrw

Path for db(s) to stay persistant. Delete if you want the docker to re-initialize the dbs everytime it starts up.

Target
/ABSBOT/db
Default
/mnt/user/appdata/bookshelf_traveller/db
Value
/mnt/user/appdata/bookshelf_traveller/db
Owner OnlyVariable

Only the owner will have access to all commands. Disable to allow others to use the bot.

Target
OWNER_ONLY
Default
True
Value
True
Enable Audio PlaybackVariable

By default is true, enables the audio module. If disabled, it will remove the ability for audio playback.

Target
AUDIO_ENABLED
Default
True
Value
True
Default Search ProviderVariable

Default search provider for titles. Please refer to ABS API wiki page for full list. EXPERIMENTAL AND OPTIONAL

Target
DEFAULT_PROVIDER
Default
audible
Enable Audio PlaybackVariable

By default is true, enables the audio module. If disabled, it will remove the ability for audio playback.

Target
AUDIO_ENABLED
Default
True
Value
True
Playback RoleVariable

Playback Role. Can be copied over from discord when developer mode is enabled.

Target
PLAYBACK_ROLE
Default
True
Value
0
Multi-UserVariable

Enables multi-user login to ABS server. Disable to allow admin controls.

Target
MULTI_USER
Default
True
Value
True
HTTPS Image URLVariable

Used if you want to use HTTPS connection to retrieve your images. Note this won't do anything if you are already using it in the primary URL.

Target
OPT_IMAGE_URL
Debug ModeVariable

Will make log verbose and show all internal library logs as well.

Target
DEBUG_MODE
Default
False
Value
False

Download Statistics

9,150
Total Downloads

Details

Repository
donkevlar/bookshelf-traveller:latest
Last Updated2026-04-11
First Seen2024-07-19

Run Bookshelf-Traveller on Unraid.

Bookshelf-Traveller is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.