Audplexus

Audplexus is a self-hosted app that syncs your Audible library, downloads audiobooks, and organizes them for your media server.

Use it when you want a single place to:

• connect Audible and keep your library in sync
• download books into a local audiobook library
• send finished books to Plex, Emby, Jellyfin, or Audiobookshelf
• keep the queue, retry, and sync flow in one web UI

Pipeline Preview

Example using synthetic book data. See Queue and Download Books for pipeline stages and controls.

Quick Start

Docker Compose

1. Create folders:

mkdir -p config audiobooks downloads

1. Start Audplexus:

docker compose up -d

1. Open the web UI:

http://localhost:8080

1. In Settings, connect Audible.
2. If you want automatic library scans, add a library destination.

Docker Run

docker pull ghcr.io/mstrhakr/audplexus:latest

mkdir -p config audiobooks downloads

docker run -d \
	--name audplexus \
	-p 8080:8080 \
	-v $(pwd)/config:/config \
	-v $(pwd)/audiobooks:/audiobooks \
	-v $(pwd)/downloads:/downloads \
	ghcr.io/mstrhakr/audplexus:latest

If you run into permission issues, make sure the container user can write to config/, audiobooks/, and downloads/.

Unraid / Community Applications

If you install from Unraid Community Applications, use the app entry as your container start point, map the common shares, and keep PUID/PGID aligned with your Unraid user setup.

Recommended share layout:

• /mnt/user/appdata/audplexus/config -> /config
• /mnt/user/appdata/audplexus/downloads -> /downloads
• /mnt/user/audiobooks -> /audiobooks

More details: Unraid App Store Setup

Basic Setup Notes

• Open the web UI at http://localhost:8080
• Connect Audible first
• Add a library destination if you want automatic scans after downloads
• The web app login is disabled by default on a fresh install. No default username/password is shipped.
• To enable a bootstrap admin account, set AUDPLEXUS_ADMIN_USERNAME and AUDPLEXUS_ADMIN_PASSWORD before the first start. If both are set on a brand-new install, Audplexus creates the admin user automatically and turns Forms auth on.
• Use the user guide for task-by-task help when you need more detail

Common Paths

• config/ stores app settings and auth data
• downloads/ holds temporary work files
• audiobooks/ is the final library output

Need more detail? Start with the User Guide or Developer Docs.

Documentation

• User Guide
• Developer Docs

Security Scanning (CodeQL)

Audplexus includes an advanced CodeQL setup for GitHub and local use:

• GitHub workflow: .github/workflows/codeql.yml
• Shared CodeQL config: .github/codeql/codeql-config.yml
• Local runner script: scripts/codeql-local.sh

Run CodeQL locally before push:

./scripts/codeql-local.sh

Run a subset of languages:

./scripts/codeql-local.sh go javascript-typescript

License

MIT