# User-defined tool for Cover Lookup
**URL:** https://community.mp3tag.de/t/user-defined-tool-for-cover-lookup/59761
**Category:** Howto
**Tags:** howto
**Created:** [January 22, 2023, 9:41am UTC](https://community.mp3tag.de/t/user-defined-tool-for-cover-lookup/59761 "2023-01-22T09:41:30Z")
**Posts on this page:** 2
**Page:** 1
### Author:  [@Casual\_Tea](https://community.mp3tag.de/u/Casual_Tea)
#### Post date: [January 22, 2023, 9:41am UTC](https://community.mp3tag.de/t/user-defined-tool-for-cover-lookup/59761/1 "2023-01-22T09:41:30Z")
I use this tool to quickly look for album art on [this site](https://covers.musichoarders.xyz) which (in my experience) yields the best overall results and has better performance than [AlbumArtDownloader](https://sourceforge.net/projects/album-art/) for example.
This is the latest version (2025/01/30).
`Name: Cover Lookup`
`Path: C:\Program Files\Mozilla Firefox\firefox.exe`
`Parameter: https://covers.musichoarders.xyz/?artist="$replace(%artist%,'"','%22','#','%23','$','%24','&','%26')"&album="$replace(%album%,'"','%22','#','%23','$','%24','&','%26')"&country=de&sources=deezer,tidal,applemusic,itunes,musicbrainz,bandcamp,soulseek,amazonmusic,discogs`
If your default providers do not yield results and you suspect one of the providers which you usually do not use might, here are 4 more versions of the tool which encompass the 31 total providers.
By calling them one after the other (crtl+2, ctrl+3, ctrl+4, ctrl+5 for example) you will get 4 new tabs, each showing 9, 9, 9 and 4 providers. I wouldn't overuse it tho as there's probably a reason for the site to limit the providers to 9 per call.
> **4 more versions containing all providers**
>
> `Name: Cover Lookup Amazon-Discogs`
> `Path: C:\Program Files\Mozilla Firefox\firefox.exe`
> `Parameter: https://covers.musichoarders.xyz/?artist="$replace(%artist%,'"','%22','#','%23','$','%24','&','%26')"&album="$replace(%album%,'"','%22','#','%23','$','%24','&','%26')"&country=de&sources=amazon,amazonmusic,applemusic,bandcamp,beatport,booth,bugs,deezer,discogs`
>
> `Name: Cover Lookup Fanarttv-Linemusic`
> `Path: C:\Program Files\Mozilla Firefox\firefox.exe`
> `Parameter: https://covers.musichoarders.xyz/?artist="$replace(%artist%,'"','%22','#','%23','$','%24','&','%26')"&album="$replace(%album%,'"','%22','#','%23','$','%24','&','%26')"&country=de&sources=fanarttv,flo,gaana,gracenote,itunes,kkbox,kugou,lastfm,linemusic`
>
> `Name: Cover Lookup Melon-Soundcloud`
> `Path: C:\Program Files\Mozilla Firefox\firefox.exe`
> `Parameter: https://covers.musichoarders.xyz/?artist="$replace(%artist%,'"','%22','#','%23','$','%24','&','%26')"&album="$replace(%album%,'"','%22','#','%23','$','%24','&','%26')"&country=de&sources=melon,metalarchives,musicbrainz,netease,ototoy,qobuz,recochoku,soulseek,soundcloud`
>
> `Name: Cover Lookup Spotify-Vgmdb`
> `Path: C:\Program Files\Mozilla Firefox\firefox.exe`
> `Parameter: https://covers.musichoarders.xyz/?artist="$replace(%artist%,'"','%22','#','%23','$','%24','&','%26')"&album="$replace(%album%,'"','%22','#','%23','$','%24','&','%26')"&country=de&sources=spotify,thwiki,tidal,vgmdb`
You can use different browsers instead of firefox in the "Path" section.
`&country=de` can also be replaced with the ISO code of the country you want to see results from.
The currently available **countries** are:
Australia = au, Canada = ca, China = cn, France = fr, Germany = de, India = in, Italy = it, Japan = jp, Korea = kr, Spain = es, Taiwan = tw, United Kingdom = gb, United States = us
You can also add `&resolution=[size]` if you only want to see images equal to or greater than that size.
Updated update:
A while ago the site updated and now only allows 9 active sources at the same time.
You'll have to select which sources suit your collection best.
The currently available **sources** are:
amazon amazonmusic applemusic bandcamp beatport booth bugs deezer discogs fanarttv flo gaana gracenote itunes kkbox kugou lastfm linemusic melon metalarchives musicbrainz netease ototoy qobuz recochoku soulseek soundcloud spotify thwiki tidal vgmdb
You can add up to 9 of these separated by `,` in `&sources=`.
The order of sources defines in which order they are displayed on the site.
Example: If you want to see the discogs result first, put it in first place in the `&sources=` list.
Not all sources work for all countries.
I've set it as my first tool so I can press strg/ctrl+1 after selecting a track to search for art easily and quickly. Maybe someone else will find this useful as well. Alternatively you can set it as the default tool and use it by double clicking a track.
> **Update history**
>
> Edit: I just did some further testing and this only works well for artists and albums which don't contain reserved characters like '&' (which has to be replaced with %26 for it to work). Is there an easy way to encode %artist% and %album% to be compatible with URLs?
>
> Edit2: Tested reserved characters and added those which broke the links in 2 replace functions. If you find a character I have missed that breaks the URL, let me know so I can edit the parameters.
>
> Edit3: As suggested by Florian I've adjusted the post to be more of a tutorial and less of a question as to where to post the tutorial.
>
> Edit4: Updated the tool to a current version limited to 14 active sources and also updated the list of available sources and countries with respective ISO codes.
>
> Edit5: They once again decreased the amount of active sources, to 12 this time. I've updated my default version again and also added a workaround to still get results from more sources when needed.
>
> Edit6: Now the limit is 9 sources.
---
### Author:  [@LyricsLover](https://community.mp3tag.de/u/LyricsLover)
#### Post date: [January 22, 2023, 11:40am UTC](https://community.mp3tag.de/t/user-defined-tool-for-cover-lookup/59761/2 "2023-01-22T11:40:44Z")
Thanks for your "Cover Lookup Tool" definition, @Casual_Tea
> [@Casual\_Tea](#):
>
> Is there an easy way to encode %artist% and %album% to be compatible with URLs?
There is no function like `$urlencode` for Mp3tag yet.
You need to expand your
`$replace(%artist%,'&','%26')`
manually to
`$replace(%artist%,'&','%26', ,%20,#,%23,$,%24)`
and so on for all the characters you want to be "translated".
`$replace` supports multiple parameter pairs y and z.