audav

For when you manage your own audiobooks and just want a clean, non-invasive way to listen across devices.

Usage scenario

You have a collection of audiobooks stored on NextCloud/WebDAV.

You want to:

• Listen on multiple devices (phone/tablet/desktop)
• See how much of a book you've listened to

You don't want to:

• Lose your place
• Install complex server apps

Features

Progress map

See which parts of a book you’ve listened to

• Great for dense/non-fiction books where you jump between chapters
• Visualize each chapter as a series of blocks showing played/unplayed segments
• Tap an unplayed segment to play it

Detailed bookmarks

Take notes while listening and jump back to any point easily

• Notes are searchable

Themes

Match your own vibe

• Light/dark modes
• Multiple colour schemes
• Adjust book cover styles, from fully decorative to plain text

Metadata display

Know what you're listening to

• Display details from .txt/.nfo files, audio streams, and embedded metadata

Unix-style philosophy goals

Tread lightly. Stay in your lane.

• Don't manage users or files --- NextCloud/WebDAV already does this
• Never write outside the working folder:
  {YOUR_AUDIOBOOKS_FOLDER}/.audav_audiobook_listener/
  To remove the app from the server just delete the folder

Requirements

• A WebDAV server + login details
• On that server, a folder of audiobooks (organise subfolders however you like)
• A device with auDAV for listening on

Install and setup

1. Install and open auDAV

Install on the Android device you want to listen from

2. Enter your WebDAV settings

Tap menu button twice to change settings:

Beware typos! Some providers throttle connections for a few hours if you repeatedly try to log in with bad credentials

• Server URL: Find in NextCloud under Files Settings - WebDAV - WebDAV URL
• WebDAV Username + Password: Will be encrypted and stored only on your device
• Audiobooks folder: Path (relative to Server URL) to your audiobooks folder

3. Scan your server

Go back to the main page. The app will scan your server for books. This may take a while depending on number of books and internet/server speeds.

4. Start listening

After the scan, you will see a list of your books --- tap a book to open it and start playing.

Tips/FAQ

Tap menu button twice for settings

First tap opens the theme chooser. Second tap opens the settings page.

Seeking is slow!

For very long seeks in large audiobook chapters, you might experience a significant wait (over a minute) while the player buffers data, during which the interface may show little progress.

Please be patient, as the seek will eventually succeed unless an error appears; this is a known, rare technical limitation for very large files. Compressing the audiobook might help.

Re-Scan when you add or move books

If you add new books to your server or rearrange them into different folders, open the app and press the 'Re-scan library' button.

For full README see https://codeberg.org/mm-dev/audav.