Troubleshooting

Troubleshooting

FFmpeg Is Missing

The uploading client needs FFmpeg for CD Writer conversion of non-OGG files. The server needs FFmpeg for duration checks and admin/server-side imports.

Options:

• install FFmpeg on PATH and use ffmpegMode = system
• set ffmpegMode = path and configure ffmpegPath
• use the explicit managed setup flow where supported
• use already-normalized .ogg files where possible
• set ffmpegMode = disabled only when you understand the limitations

MusicXCST public jars do not bundle FFmpeg binaries.

Track Is Too Long

Check:

maxMusicDurationEnabled
maxMusicDurationSeconds

If duration limiting is enabled and the server cannot determine duration, the upload is rejected.

Player Hit The File Limit

Check:

maxMusicFilesPerPlayerEnabled
maxMusicFilesPerPlayer
playerLimitMode

MusicXCST 0.1.4 counts active tracks only for the per-player file limit.

Players can delete old entries with:

/cstmusic delete <uploadedFile>

Uploaded File Suggestions Are Missing

Use /cstmusic list to confirm the player has available uploaded music. Deleted, missing, or invalid entries are not shown as available uploads.

If a reusable uploaded file was deleted with its music entry, upload the audio again through the CD Writer or admin upload command.

Jukebox Is Silent

Check the entry:

/cstmusic info <uploadedFile>

Admins can inspect by music ID and repair metadata:

/cstmusic admin info <musicId>
/cstmusic admin repairindex

Client Download Fails

Delete the local musicxcst-cache folder and run:

/cstmusic download all