[Enhancement]: Support Bonjour / Avahi / mDNS for local domain discovery #3068

Open
opened 2026-04-25 00:13:24 +02:00 by adam · 0 comments
Owner

Originally created by @spacedmonkey on GitHub (Nov 2, 2025).

Type of Enhancement

Server Backend

Describe the Feature/Enhancement

It would be great if Audiobookshelf supported local network discovery via Bonjour (macOS/iOS) or Avahi (Linux) using mDNS.

At the moment, the server can only be reached by IP address (e.g. http://192.168.1.10:13378), which can change if the network uses DHCP. With Bonjour support, the server could advertise itself on the local network and be accessible via a consistent hostname such as http://audiobookshelf.local:13378.

Why would this be helpful?

Benefits:
• Simplifies connecting from mobile apps or browsers on the same network.
• Removes the need to know or configure the local IP address.
• Improves plug-and-play usability on home networks.

Proposed behaviour:
• On startup, Audiobookshelf advertises itself using mDNS under a service name like _audiobookshelf._tcp.
• The advertised hostname (e.g. audiobookshelf.local) resolves automatically on all devices that support Bonjour/Avahi.
• Optionally, provide a configuration toggle to enable or disable the mDNS advertisement.

Future Implementation (Screenshot)

Implementation notes:
• Node.js has several libraries that can handle mDNS advertisements, such as bonjour-service or mdns-js.
• Avahi is compatible on Linux and integrates with mDNSResponder on macOS.
• The feature should not require extra setup beyond the existing local install.

Audiobookshelf Server Version

1

Current Implementation (Screenshot)

No response

Originally created by @spacedmonkey on GitHub (Nov 2, 2025). ### Type of Enhancement Server Backend ### Describe the Feature/Enhancement It would be great if Audiobookshelf supported local network discovery via Bonjour (macOS/iOS) or Avahi (Linux) using mDNS. At the moment, the server can only be reached by IP address (e.g. http://192.168.1.10:13378), which can change if the network uses DHCP. With Bonjour support, the server could advertise itself on the local network and be accessible via a consistent hostname such as http://audiobookshelf.local:13378. ### Why would this be helpful? Benefits: • Simplifies connecting from mobile apps or browsers on the same network. • Removes the need to know or configure the local IP address. • Improves plug-and-play usability on home networks. Proposed behaviour: • On startup, Audiobookshelf advertises itself using mDNS under a service name like _audiobookshelf._tcp. • The advertised hostname (e.g. audiobookshelf.local) resolves automatically on all devices that support Bonjour/Avahi. • Optionally, provide a configuration toggle to enable or disable the mDNS advertisement. ### Future Implementation (Screenshot) Implementation notes: • Node.js has several libraries that can handle mDNS advertisements, such as [bonjour-service](https://www.npmjs.com/package/bonjour-service) or [mdns-js](https://www.npmjs.com/package/mdns-js). • Avahi is compatible on Linux and integrates with mDNSResponder on macOS. • The feature should not require extra setup beyond the existing local install. ### Audiobookshelf Server Version 1 ### Current Implementation (Screenshot) _No response_
adam added the enhancement label 2026-04-25 00:13:24 +02:00
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: starred/audiobookshelf#3068