Common Issues

This page covers the most common non-specialized problems in Tunedance.

Albums Are Not Loading

If the Albums view does not load correctly:

1. Retry the view
2. Confirm the app still has a valid session
3. Check that the app can reach the backend

The Albums library already includes retry behavior for failed fetches, so start there before assuming the local data is gone.

An Album Opens But Looks Incomplete

If an album opens but some expected tracks are missing, Tunedance may have pruned entries whose media files no longer exist.

This can happen if:

• local files were deleted outside the app
• stored media metadata no longer points to a valid file

A Track Exists But Does Not Behave Correctly

If a track row is present but playback, lyrics, or artwork actions do not behave as expected, check whether the underlying media file still exists and whether the specific track type supports that action.

Examples:

• Copy lyrics only works for music tracks
• track image removal only works when the track actually has saved artwork

First Recovery Steps

For most common issues, the first steps are:

• reopen the album
• retry the action once
• restart the app if local state looks stale

If the issue continues, move to the more specific troubleshooting page for that failure type.