How to Integrate Album Art Downloader with Mp3tag
Stop searching for covers manually. By linking Album Art Downloader (XUI) as a custom tool within Mp3tag, you can fetch high-resolution artwork for any album with a simple right-click. This guide shows you the 2026 optimized configuration.
Highlight your music files
Auto-passes Artist & Album
Choose the best 1000px art
- Ensure Album Art Downloader XUI is installed.
- Ensure Mp3tag v3.0 or higher is installed.
- Have at least one music folder with basic “Artist” and “Album” tags filled.
Step-by-Step Tool Setup
1 Access Mp3tag Options
Open Mp3tag, navigate to the top menu and select File > Options (or press Ctrl+O). From the left sidebar, click on Tools.
2 Create a New Custom Tool
Click the “New” (Star icon) button on the right. In the popup window, enter the following details precisely:
3 Enter Command Line Parameters
This is the most critical part. Copy and paste the string below into the Parameter field. This tells AAD to automatically use the Artist and Album tags from your selected file.
Parameter Explained:
/ar – Specifies Artist
/al – Specifies Album
/p – Defines the save path and filename (auto-renames to folder.jpg in the same directory).
[System] Initializing XUI Engine…
[Search] Querying 30+ Sources…
[Status] Success: Artist/Album Passed.
Testing Your Configuration
If Album Art Downloader opens but the Artist or Album fields are blank, the link is broken. Here is how to verify:
-
✓
The Quote Rule: Always wrap
"%artist%"in double quotes. This prevents the command from breaking when an artist name contains spaces. -
✓
The Path Filter: Use
%_folderpath%instead of%_path%if you want AAD to look at the directory rather than the specific file.
How to Trigger the Search
Once the tool is configured, you never need to open Album Art Downloader manually again. It becomes an extension of your Mp3tag workflow.
Single Album Search
Right-click any track from an album > Tools > Album Art Downloader. The search window will pop up with Artist and Album already filled.
Batch Search (Pro Tip)
Select multiple tracks from different albums. When you trigger the tool, AAD will open separate search instances for each unique album, allowing you to quickly cycle through and save covers.
Keyboard Shortcuts
Efficiency is key. Use these Mp3tag shortcuts to speed up your metadata tagging:
- Open Tool Menu Alt + T
- Save Tag Ctrl + S
- Refresh Directory F5
Advanced Syntax & Custom Filenames
Want to save covers as cover.jpg instead of folder.jpg? Or dealing with complex folder structures? Use these advanced strings.
| Naming Objective | Recommended Parameter String |
|---|---|
| Save as cover.jpg | /ar “%artist%” /al “%album%” /p “%_folderpath%cover.jpg” |
| Artist-Album Filename | /ar “%artist%” /al “%album%” /p “%_folderpath%%artist% – %album%.jpg” |
| Handling “/” in Tags | /ar “$replace(%artist%,/,_)” /al “$replace(%album%,/,_)” |
⚠️ AAD Won’t Launch?
Double-check your Path in Mp3tag. If you installed AAD in a non-standard directory, ensure the .exe path is enclosed in double quotes " " if it contains spaces.
⚠️ Empty Search Fields?
This happens if the Artist or Album tag is empty in Mp3tag. AAD needs these variables to initiate a query. Make sure your files are tagged first!
⚠️ Image Not Saving?
Ensure Mp3tag has “Write” permissions for the music folder. If you are using a NAS or network drive, map it to a local drive letter (e.g., Z:\) for better compatibility.
Still having trouble with specific scripts or search results?
Get the latest 2026 Script Fixes →Foobar2000 Integration
Prefer playing over tagging? Link AAD directly to your player.
Using the “Run Services” component (foo_run), you can trigger an Album Art search directly from your Foobar2000 playlist. This is the fastest way to fix missing covers while listening to your library.
1. Get foo_run
Download and install the Run Services component for Foobar2000. Restart the player to activate.
2. Add Service
Go to Preferences > Tools > Run services. Add a new entry named “Find Album Art”.
Note: Foobar2000 uses its own tagging syntax. The $replace function is used here to ensure slashes in artist names don’t create unwanted subfolders.
Optimizing Search Performance
Don’t settle for default settings. Fine-tune the XUI engine to find 1000px+ high-resolution covers faster and more accurately.
Force High-Resolution Only
Tired of blurry 300px thumbnails? Set the Minimum Size filter in the bottom bar of AAD to 600 or 1000.
Increase Concurrent Searches
Go to File > Options in AAD. Increase “Concurrent Searches” to 10 or 15 if you have a fast broadband connection.
The “Ultimate” Workflow Summary
By combining Mp3tag for metadata, Album Art Downloader for visual discovery, and these Optimization Tweaks, you have the fastest music organization system available in 2026.