898ec78a6f
* Add a schema extension API and several extensions * Update graphql-markdown to use new diffSchema function * Update Node support
9.7 KiB
Extension: fanart.tv
Retrieve high quality artwork for artists, releases, and labels from fanart.tv.
This extension uses its own cache, separate from the MusicBrainz loader cache.
Configuration
This extension can be configured using environment variables:
FANART_API_KEY: The fanart.tv API key to use. This is required for any fields added by the extension to successfully resolve.FANART_BASE_URL: The base URL at which to access the fanart.tv API. Defaults tohttp://webservice.fanart.tv/v3/.FANART_CACHE_SIZE: The number of items to keep in the cache. Defaults toGRAPHBRAINZ_CACHE_SIZEif defined, or8192.FANART_CACHE_TTL: The number of seconds to keep items in the cache. Defaults toGRAPHBRAINZ_CACHE_TTLif defined, or86400000(one day).
Table of Contents
Objects
Artist
🔹 This type has been extended. See the base schema for a description and additional fields.
| Field | Argument | Type | Description |
|---|---|---|---|
| fanArt | FanArtArtist |
Images of the artist from fanart.tv. This field is provided by the fanart.tv extension. |
|
FanArtAlbum
An object containing lists of the different types of release group images from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| albumCovers | [FanArtImage] |
A list of 1000x1000 JPG images of the cover artwork of the release group. |
|
| discImages | [FanArtDiscImage] |
A list of 1000x1000 PNG images of the physical disc media for the release group, with transparent backgrounds. |
|
FanArtArtist
An object containing lists of the different types of artist images from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| backgrounds | [FanArtImage] |
A list of 1920x1080 JPG images picturing the artist, suitable for use as backgrounds. |
|
| banners | [FanArtImage] |
A list of 1000x185 JPG images containing the artist and their logo or name. |
|
| logos | [FanArtImage] |
A list of 400x155 PNG images containing the artist’s logo or name, with transparent backgrounds. |
|
| logosHD | [FanArtImage] |
A list of 800x310 PNG images containing the artist’s logo or name, with transparent backgrounds. |
|
| thumbnails | [FanArtImage] |
A list of 1000x1000 JPG thumbnail images picturing the artist (usually containing every member of a band). |
|
FanArtDiscImage
A disc image from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| imageID | ID |
The ID of the image on fanart.tv. |
|
| url | URLString |
The URL of the image. |
|
| size | FanArtImageSize |
The size of the image to retrieve. |
|
| likeCount | Int |
The number of likes the image has received by fanart.tv users. |
|
| discNumber | Int |
The disc number. |
|
| size | Int |
The width and height of the (square) disc image. |
|
FanArtImage
A single image from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| imageID | ID |
The ID of the image on fanart.tv. |
|
| url | URLString |
The URL of the image. |
|
| size | FanArtImageSize |
The size of the image to retrieve. |
|
| likeCount | Int |
The number of likes the image has received by fanart.tv users. |
|
FanArtLabel
An object containing lists of the different types of label images from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| logos | [FanArtLabelImage] |
A list of 400x270 PNG images containing the label’s logo. There will usually be a black version, a color version, and a white version, all with transparent backgrounds. |
|
FanArtLabelImage
A music label image from fanart.tv.
| Field | Argument | Type | Description |
|---|---|---|---|
| imageID | ID |
The ID of the image on fanart.tv. |
|
| url | URLString |
The URL of the image. |
|
| size | FanArtImageSize |
The size of the image to retrieve. |
|
| likeCount | Int |
The number of likes the image has received by fanart.tv users. |
|
| color | String |
The type of color content in the image (usually “white” or “colour”). |
|
Label
🔹 This type has been extended. See the base schema for a description and additional fields.
| Field | Argument | Type | Description |
|---|---|---|---|
| fanArt | FanArtLabel |
Images of the label from fanart.tv. This field is provided by the fanart.tv extension. |
|
ReleaseGroup
🔹 This type has been extended. See the base schema for a description and additional fields.
| Field | Argument | Type | Description |
|---|---|---|---|
| fanArt | FanArtAlbum |
Images of the release group from fanart.tv. This field is provided by the fanart.tv extension. |
|
Enums
FanArtImageSize
The image sizes that may be requested at fanart.tv.
| Value | Description |
|---|---|
| FULL |
The image’s full original dimensions. |
| PREVIEW |
A maximum dimension of 200px. |