Album Art Downloader Scripts Not Working? Fix It (2026)
Album Art Downloader finds covers through small search scripts (files ending in .boo) — one script per source site. When a script stops returning results, the program itself is usually fine. Here are the three real causes and how to fix each one.
Quick rule of thumb: if every source fails, suspect your setup or network. If only one or two sources fail while others work, those sources’ scripts are broken — skip to Cause 1.
Cause 1: The source site changed its website (most common)
This is the number-one reason scripts break, and it is completely normal. Scripts work by reading a source site’s pages; when that site redesigns its layout or changes its search URLs, the old script can no longer find anything. The program’s own update history is full of exactly these fixes — scripts for Amazon, Discogs, LastFM, Juno and others have been repaired many times over the years after their sites changed. More recently, the Qobuz script has broken and been fixed repeatedly.
What to do:
- Update your scripts. Open Album Art Downloader and check for script updates (there is an option to check automatically and even download new scripts as they appear — a small notification appears under the sources list when new ones arrive). Outdated scripts are the single most common cause.
- Disable the broken source for now. You can enable or disable individual sources; just uncheck the one that stopped working and keep using the rest.
- Try a different source. With 20+ community script sources available, one site’s redesign should never leave you empty-handed.
- Check the SourceForge discussion forum. When a popular script breaks, users usually report it there first, and fixed scripts appear there before anywhere else.
⚠️ The biggest misconception: reinstalling Album Art Downloader does not fix broken scripts. Scripts live separately from the program — a fresh install of v1.05 ships the same scripts you already had. If a source site changed, you need an updated script, not a reinstalled program. See our scripts guide for how script updates work.
Cause 2: Scripts are missing or in the wrong place
If no sources appear at all, or the program complains it cannot find scripts, the .boo script files may be missing from the Scripts folder (for example after moving the portable version to a new PC).
What to do:
- Reinstall from our download page (the installer includes the full script set) — this is the one case where reinstalling helps.
- Use the built-in “Get more scripts” function to browse and install any scripts you are missing.
- If you write or download scripts manually, make sure the
.boofiles land in the program’s Scripts folder, not in a random subfolder.
Cause 3: Network, DNS or proxy problems
If scripts were working yesterday and suddenly all of them return nothing, the program may not be reaching the internet at all.
What to do:
- Check that your browser can open the source sites — if the browser can’t reach them either, it’s your connection, not the program.
- Temporarily disable VPNs or proxies; some source sites block datacenter and VPN IP ranges.
- If you are on a school or office network, a firewall may be blocking the program’s requests.
Frequently asked questions
Why did a script that worked last month stop working?
Almost always because the source website changed something — a redesign, new search URLs, or new anti-bot measures. This happens regularly with every script-based downloader. Update your scripts and check the SourceForge forum for a fixed version.
Will reinstalling Album Art Downloader fix my scripts?
No — unless your script files are actually missing. Reinstalling replaces the program but ships the same scripts. Broken scripts need updated scripts, not a fresh copy of the program.
One source returns nothing but others work fine. Is that normal?
Yes. Disable that source for now and use the others. Check back after updating your scripts — broken sources are usually repaired within days or weeks by the community.
Where can I get help with a specific broken script?
The project’s SourceForge discussion forum is where script breakages are reported and fixed scripts are shared. Search there for the source name before posting.
New to scripts? Start with our scripts installation and update guide, or download the latest version to make sure you have the full script set.