airsonic-pulse/docs/troubleshooting.md
litebito ff0abee3c4
Some checks are pending
CodeQL Advanced / Analyze (actions) (push) Waiting to run
CodeQL Advanced / Analyze (java-kotlin) (push) Waiting to run
CodeQL Advanced / Analyze (javascript-typescript) (push) Waiting to run
Trivy scan / trivy-scan (push) Waiting to run
docs: add database guide, restructure apache proxy for RHEL/Debian, add validation banners to unvalidated pages
2026-07-10 23:26:29 +02:00

1.4 KiB

Troubleshooting

Note: This page was inherited from the upstream Airsonic-Advanced project and has not yet been validated with Airsonic-Pulse. The content may still be correct, but some details (versions, ports, paths, screenshots) may be outdated. If you want to suggest a specific correction, feel free to raise it as an issue

Cue sheet tracks do not end at the end of the track

See also issue #195

If you have a cue sheet with multiple tracks, and you play a track which is not the last track, the client will continue to play the next track without ending.

Please check the following settings.

Settings -> Transcoding -> Downsample command

To fix this, you need to add split option %S to the beginning of the command.

Before: ffmpeg -i %s -map 0:0 -b:a %bk -v 0 -f mp3 -

After: ffmpeg %S -i %s -map 0:0 -b:a %bk -v 0 -f mp3 -

WEB UI does not work over HTTPS

If you see some blank pages in the WEB UI or the Settings page does not work, launch your web browser's development tool, go to the console tab, and check for error messages that start with Mixed content ....

web-ui-mixed-contents-error

If you deploy Airsonic Advanced behind reverse proxies, please add -Dserver.forward-headers-strategy=native or -Dserver.forward-headers-strategy=framework to JAVA_OPTS.