Add-on:Artwork Downloader: Difference between revisions
>Martijn No edit summary |
>Martijn |
||
Line 96: | Line 96: | ||
This add-on support different kind of skin integration methods. This allows skins to use buttons to download different kinds of artwork for a single media item or in bulk mode. | This add-on support different kind of skin integration methods. This allows skins to use buttons to download different kinds of artwork for a single media item or in bulk mode. | ||
== Solo mode | == Solo mode == | ||
This downloads for a single media item depending from what section of XBMC this is gonna be used from. | This downloads for a single media item depending from what section of XBMC this is gonna be used from. | ||
'''Runs script in solo mode''' | '''Runs script in solo mode''' | ||
This downloads all available artwork that has been enable in the add-on settings. | This downloads all available artwork that has been enable in the add-on settings. | ||
Script command: | |||
XBMC.RunScript(script.artwork.downloader, mediatype=?, medianame=?) | |||
Skin example: | |||
<item id="8"> | |||
<description>Get Artwork</description> | |||
<label>$LOCALIZE[31316]</label> | |||
<onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle])</onclick> | |||
<onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> | |||
<onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mediatype=musicvideos, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> | |||
<visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> | |||
</item> | |||
'''Runs script in GUI dialog mode''' | '''Runs script in GUI dialog mode''' | ||
A menu is displayed with available artwork type. When a artwork type is selected the image list with available images will be displayed. The selected image will automaticly overwrite the current one when present. | A menu is displayed with available artwork type. When a artwork type is selected the image list with available images will be displayed. | ||
The selected image will automaticly overwrite the current one when present. | |||
Script command: | |||
XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=?, medianame=?) | |||
Skin example: | |||
<item id="8"> | |||
<description>Get Artwork</description> | |||
<label>$LOCALIZE[31316]</label> | |||
<onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle])</onclick> | |||
<onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> | |||
<onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=musicvideo, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> | |||
<visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> | |||
</item> | |||
'''Runs script in custom mode''' | |||
In this mode you can specify an artwork type that you want to download for a specific media item. | |||
When only one image is found it will be just downloaded. When multiple images are found the image selection dialog will be shown for user selection. You can specify multiple artwork types for downloading however this won't show the image selection dialog. | |||
The image dialog is also disabled for ''extrathumbs'' and ''extrafanart''. | |||
Script command: | |||
XBMC.runscript(script.artwork.downloader, mode=custom, mediatype=?,medianame=?, <art_type>) | |||
XBMC.runscript(script.artwork.downloader, mode=custom, mediatype=?,medianame=?, <art_type>, <art_type>, <art_type>) | |||
Skin example: | |||
<item id="8"> | |||
<description>Get Artwork</description> | |||
<label>$LOCALIZE[31316]</label> | |||
<onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle], extrafanart)</onclick> | |||
<onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path], extrafanart)</onclick> | |||
<onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=musicvideo, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path], extrafanart)</onclick> | |||
<visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> | |||
</item> | |||
---- | ---- | ||
[[Category:Pre-Eden add-on repository]] | [[Category:Pre-Eden add-on repository]] |
Revision as of 16:54, 3 February 2012
Artwork Downloader | ||||||||||
|
Add-ons | Artwork Downloader |
Downloads all available artwork for TV shows, Movies and Musicvideos in your library. Check the options for supported artwork
Artwork sources:
www.fanart.tv
www.thetvdb.com
www.themoviedb.org
Remark:
Check your skin to see what type of artwork is supported!
Each TV Show/Movie must have its own folder!
Skin integration:
See readme file
Installing
This add-on is installed from the Add-on browser located in Kodi as follows:
- Settings
- Add-ons
- Install from repository
- Program Add-ons
- Artwork Downloader
- Install
Summary:
This add-ons searches through your library for all your currently added Movies, TV Shows and Musicvideos and then searches for avaiable artwork. This then is downloaded to the folder location where that media is stored.
Current Features
Download artwork
- Movies
- TV Shows
- Musicvideos
Limit artwork
- Maximum extrafanart
- Minimum rating
- Preferred language (fall-back is always English)
- Exclude fanart that has text (only available on thetvdb.com)
- Minimum fanart size Movies (also for Musicvideos)
- Minimum fanart size TV Shows
Overwrite all
- This will overwrite all current files with the ones that fit the limiter. This option will automatic reset after a download run.
Artwork sources:
Please show your support to these sites by donating or contributing new artwork!
Filenaming conventions
Movies:
- Poster (poster.jpg)
- Fanart (fanart.jpg)
- Extrafanart (<image ID from provider>.jpg)
- Extrathumbs (thumb1.jpg to thumb4.jpg)
TV Shows:
- Poster (poster.jpg)
- Season Posters (season-all.jpg / seasonxx.jpg / season-specials.jpg)
- Fanart (fanart.jpg)
- Extrafanart (<image ID from provider>.jpg)
- Clearart (cleart.png)
- Characterart (character.png)
- Logo (logo.png)
- Banner (banner.jpg)
- Season Banners (seasonbannerxx.jpg)
Musicvideos:
- Poster (poster.jpg)
- Fanart (fanart.jpg)
- Extrafanart (<image ID from provider>.jpg)
- Extrathumbs (thumb1.jpg to thumb4.jpg)
Limit artwork on (when available):
- Maximum number of extrafanart
- Rating
- Without text
- Language
- Image size
- Automaticly deleted extrafanart below the set limits (when available)
Skin integration
This add-on support different kind of skin integration methods. This allows skins to use buttons to download different kinds of artwork for a single media item or in bulk mode.
Solo mode
This downloads for a single media item depending from what section of XBMC this is gonna be used from.
Runs script in solo mode
This downloads all available artwork that has been enable in the add-on settings.
Script command:
XBMC.RunScript(script.artwork.downloader, mediatype=?, medianame=?)
Skin example:
<item id="8"> <description>Get Artwork</description> <label>$LOCALIZE[31316]</label> <onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle])</onclick> <onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> <onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mediatype=musicvideos, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> <visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> </item>
Runs script in GUI dialog mode
A menu is displayed with available artwork type. When a artwork type is selected the image list with available images will be displayed.
The selected image will automaticly overwrite the current one when present.
Script command:
XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=?, medianame=?)
Skin example:
<item id="8"> <description>Get Artwork</description> <label>$LOCALIZE[31316]</label> <onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle])</onclick> <onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> <onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mode=gui, mediatype=musicvideo, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path])</onclick> <visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> </item>
Runs script in custom mode
In this mode you can specify an artwork type that you want to download for a specific media item. When only one image is found it will be just downloaded. When multiple images are found the image selection dialog will be shown for user selection. You can specify multiple artwork types for downloading however this won't show the image selection dialog. The image dialog is also disabled for extrathumbs and extrafanart.
Script command:
XBMC.runscript(script.artwork.downloader, mode=custom, mediatype=?,medianame=?, <art_type>) XBMC.runscript(script.artwork.downloader, mode=custom, mediatype=?,medianame=?, <art_type>, <art_type>, <art_type>)
Skin example:
<item id="8"> <description>Get Artwork</description> <label>$LOCALIZE[31316]</label> <onclick condition="Container.Content(tvshows)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=tvshow, medianame=$INFO[ListItem.TVShowTitle], extrafanart)</onclick> <onclick condition="Container.Content(movies)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=movie, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path], extrafanart)</onclick> <onclick condition="Container.Content(musicvideos)">XBMC.RunScript(script.artwork.downloader, mode=custom, mediatype=musicvideo, medianame=$INFO[ListItem.Title],mediapath=$INFO[ListItem.Path], extrafanart)</onclick> <visible>[Container.Content(tvshows)|Container.Content(movies)|Container.Content(musicvideos)]+system.hasaddon(script.artwork.downloader)</visible> </item>