Fanart.tv Enricher
Fanart.tv provides high-quality artist and album artwork including backgrounds, logos, and HD images.
Features
- HD Artist Images: High-resolution artist photos
- Artist Backgrounds: Wide-format background images
- Artist Logos: Transparent logo images
- Album Art: High-quality cover art
Setup
Get API Key
Configure
SPOTTER_METADATA_FANART_API_KEY=your_api_key_here
Enriched Data
Artists
- Artist Thumb: Square profile image
- Artist Background: Wide landscape image
- HD Logo: Transparent logo
- Music Logo: Text-based logo
- Banner: Wide banner image
Albums
- Album Cover: Front cover art
- CD Art: Disc artwork
- Album Back: Back cover (if available)
Image Types
| Type | Dimensions | Usage |
|---|---|---|
| artistthumb | 1000x1000 | Profile pictures |
| artistbackground | 1920x1080 | Page backgrounds |
| hdmusiclogo | ~800x310 | Headers, overlays |
| albumcover | 1000x1000 | Album artwork |
| cdart | 1000x1000 | Disc visualization |
Rate Limiting
Fanart.tv limits depend on your account tier:
| Tier | Requests |
|---|---|
| Free | Limited |
| VIP | Higher limits |
| Project | Unlimited |
For personal use, the free tier is typically sufficient.
MusicBrainz Dependency
Fanart.tv uses MusicBrainz IDs (MBIDs) for lookups:
- Artist/album must have an MBID
- MusicBrainz enricher should run first
- Entities without MBIDs won't get Fanart.tv images
Troubleshooting
"Invalid API key"
- Verify your API key
- Check it's not expired
- Try generating a new key
No Images Found
- The artist/album may not have community submissions
- Fanart.tv is community-contributed
- Consider contributing artwork
MBIDs Required
If images aren't fetching:
- Check that MusicBrainz enricher is enabled
- Verify the entity has an MBID
- Wait for MusicBrainz to process first
Contributing to Fanart.tv
Fanart.tv relies on community contributions:
- Create an account
- Submit high-quality artwork
- Follow their submission guidelines
- Help improve coverage for your favorite artists