Scanner Finds No Books

If no books appear after scanning, troubleshoot by storage type.

Mode A: Local Storage

• Ensure path is valid and absolute.
• For Docker, use container path (not host path).
• Verify read permissions for service process.

Mode B: WebDAV

• Run connection test.
• Verify endpoint, credentials, and root path.
• Enable compatibility mode for some providers if scan is unstable.

Shared Rules

• One folder should represent one book.
• Recommended structure: root/book-name/chapter.mp3.

4. Unsupported Audio Formats (.aac / .ogg etc.)

Symptom: The book title is created, but there are "no chapters" inside, or the entire book is skipped by the system.

Reason: The system defaults to supporting .mp3, .m4a, .m4b, .flac, .wav, and .wma formats. .wma playback relies on server-side FFmpeg transcoding. The system explicitly does not support the following formats, and they will be automatically ignored during scanning:

• .aac (raw streams)
• .ogg
• .opus
• Any proprietary formats with DRM encryption (like .xm from Ximalaya, .qmc from QQ Music)

Solution: Use an audio conversion tool (like "Format Factory" or FFmpeg) to batch convert unsupported audiobooks into universal .mp3 or .m4a formats, and then scan again. If .wma cannot play, check whether server-side FFmpeg is enabled and detected.

Task Diagnostics

Open task center and check scan task errors. Use server logs for exact failure reason.