a download failed

[ado11231]

If a download fails, the most common cause is an outdated yt-dlp. YouTube changes its backend often and yt-dlp ships fixes for each change.

Fix

1. Update yt-dlp:
   • pipx: pipx upgrade yt-dlp
   • pip: python -m pip install --user --upgrade yt-dlp
   • macOS: brew upgrade yt-dlp
2. Retry the song. If it still fails, run with --verbose to see the full yt-dlp stderr:

   addsong --verbose "your song"

The error line is usually self-explanatory (private video, region-locked, age-gated). If it looks like a genuine bug, open a new issue with the verbose output.

This is not an addsong bug — it just wraps yt-dlp.