Audiobookshelf Plugin for Lyrion Media Server

NOT YET WORKING!

This plugin provides integration between your Audiobookshelf (ABS) server and Lyrion Media Server (LMS), allowing you to browse and play audiobooks from ABS directly within LMS with progress synchronization.

Overview

A simple plugin that allows LMS to browse, select and listen to audiobooks stored in ABS via its API and track progress back to the ABS server. Multiple ABS users can be configured with friendly names so family members can listen and track their own books separately, with playback progress synced between LMS and ABS.

Core Features

• Multi-user Support: Configure multiple ABS API keys with friendly names
• Flexible Authentication: Manual API tokens, username/password, or OIDC/SSO authentication
• Library Browsing: Browse audiobooks by library, genre, and title with pagination
• Rich Media Support: View audiobook covers with intelligent caching
• Progress Synchronization: Bidirectional progress tracking with ABS
• Performance Features: Cache audiobook metadata and covers to reduce API requests

Note: Actual playback support and codecs depend on your LMS setup. ABS ultimately serves files via playback URLs to LMS. I may investigate using the transcoding support on the ABS side if I get some time.

Documentation

• Installation - How to install the plugin
• Configuration - Setting up authentication and server connection
• Usage - How to use the plugin once configured
• Architecture - Technical overview and system diagrams
• Development - Code organization and extending the plugin
• Troubleshooting - Common issues and solutions
• Enhancements - Future improvement ideas

Quick Start

1. Install via plugin repository or manually
2. Configure your Audiobookshelf server URL in LMS settings
3. Add API tokens using one of three authentication methods
4. Browse and play audiobooks through the LMS interface

See the Installation and Configuration guides for detailed setup instructions.

License

This plugin is open-source and distributed under the GPL V3 License. See LICENSE for more information. It is principally authored by John Willis.

Acknowledgments

Special thanks to the Lyrion Media Server developers and community, and the developers of Audiobookshelf for their APIs, server and tools.

Also, thanks to expectingtofly, michaelherger and many others, who's awesome LMS plugins, forum posts and work served as a reference when I was hacking this all together.

Declaration

This plugin is not affiliated with the Audiobookshelf or Lyrion organisations or projects in any way, nor is any relationship implied by the use of the names and logos inside this plugin.

Warnings (or trigger warnings, rather)

Please note: I used an LLM (sonnet) to clean up some of the code and help as a 'Perl pair programmer' as I am very rusty with Perl ;-).