Home assistant add-on: booksonic-air

Thanks to everyone having starred my repo! To star it click on the image below, then it will be on top right. Thanks!

About

Booksonic-air is a platform for accessing the audiobooks you own wherever you are. At the moment the platform consists of Booksonic Air - A server for streaming your audiobooks, successor to the original Booksonic server and based on Airsonic. Booksonic App - An DSub based Android app for connection to Booksonic-Air servers. This addon is based on the docker image https://github.com/linuxserver/docker-booksonic-air

Installation

The installation of this add-on is pretty straightforward and not different in comparison to installing any other add-on.

Add my add-ons repository to your home assistant instance (in supervisor addons store at top right, or click button below if you have configured my HA)
Install this add-on.
Click the Save button to store your configuration.
Set the add-on options to your preferences
Start the add-on.
Check the logs of the add-on to see if everything went well.
Open the webUI and adapt the software options

Configuration

Webui can be found at http://homeassistant:4040. Default credentials are shown in the startup logs.

Setup Steps

Access the web interface after starting the addon
Initial setup wizard will guide you through configuration
Add your audiobook directories via the web interface
Configure transcoding settings if needed

Options

Option	Type	Default	Description
`PGID`	int	`0`	Group ID for file permissions
`PUID`	int	`0`	User ID for file permissions
`TZ`	str		Timezone (e.g., `Europe/London`)
`localdisks`	str		Local drives to mount (e.g., `sda1,sdb1,MYNAS`)
`networkdisks`	str		SMB shares to mount (e.g., `//SERVER/SHARE`)
`cifsusername`	str		SMB username for network shares
`cifspassword`	str		SMB password for network shares
`cifsdomain`	str		SMB domain for network shares

Example Configuration

PGID: 1000
PUID: 1000
TZ: "Europe/London"
localdisks: "sda1,sdb1"
networkdisks: "//192.168.1.100/audiobooks"
cifsusername: "audiobookuser"
cifspassword: "password123"
cifsdomain: "workgroup"

Mounting Drives

This addon supports mounting both local drives and remote SMB shares:

Local drives: See Mounting Local Drives in Addons
Remote shares: See Mounting Remote Shares in Addons

Custom Scripts and Environment Variables

This addon supports custom script execution and environment variable injection:

Custom scripts: See Running Custom Scripts in Addons
env_vars option: Use the add-on env_vars option to pass extra environment variables (uppercase or lowercase names). See https://github.com/alexbelgium/hassio-addons/wiki/Add-Environment-variables-to-your-Addon-2 for details.

Support

Create an issue on github

5.7 KiB Raw Blame History