[[https://github.com/latts9923/screensaver.tvtunes/raw/master/icon.png]]

== Introduction ==
You can install this addon from: [https://www.urepo.org URepo Repository]
<br />
<br />
TvTunes Screensaver is a versatile screensaver that can be used to:
* View artwork for TV Shows and Movies
* Play TV or Movie themes while showing artwork
* Show a set of different images in various display formats

It was originally designed to work well with [https://github.com/latts9923/script.tvtunes TvTunes] but can also be used to just display images if you would rather theme audio was not played in the background.

<br />

== Screensaver Formats ==
The following formats are available within TvTunes Screensaver
{| border="0"
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-Slider.JPG|400px]]
|'''Slider''' - This will slide the images into view from either the left, right, top or bottom of the screen.
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-Crossfade.JPG|400px]]
|'''Crossfade''' - will fade one image in over the top of the next image
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-Tabledrop.JPG|400px]]
|'''TableDrop''' - will drop each image onto the screen at random overlaps and angles
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-Starwars.JPG|400px]]
|'''StarWars''' - will show a stream of images similar to the Star Wars intro sequence
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-RandomZoomIn.JPG|400px]]
|'''RandomZoomIn''' - will randomly zoom in to each image in turn
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-AppleTVLike.JPG|400px]]
|'''AppleTVLike''' - like the Apple TV Screensaver, will scroll a mix of images up from the bottom of the screen
|- valign=top
| [[https://github.com/latts9923/repository.latts9923/raw/master/screensaver.tvtunes/images/TvTunes-Screensaver-GridSwitch.JPG|400px]]
|'''GridSwitch''' - will show several images at the same time in a grid format
|- valign=top
| 
|'''Random''' - will randomly show one of the above screensaver formats
|}

There are several options for each of the different screen saver that control the speed images move or how frequently the image changes.
<br />

== Settings ==
=== Screensaver ===
{| border="0"
|- valign=top
|
:'''Screensaver'''
::Select which format of screensaver to use
:'''Image Source'''
::Select if the Movie, TV Show or custom path is used to show images for the screensaver
:'''- Image Type'''
::Which type of images to use for the screensaver i.e. Fanart, Thumbnails, Cast
|}
<br />
=== Themes ===
{| border="0"
|- valign=top
|
:'''Play Themes During Screensaver'''
::If a theme is available, play it while showing the images for the given Movie or TV Show
:'''- Only Show Images When A Theme Exists'''
::Only add a Movie or TV Show to the screensaver if it has a theme
:'''- Repeat Rules'''
::When to move to the next set of images for a different Movie or TV Show
:'''Include Artwork Downloader Images'''
::If the [http://kodi.wiki/view/Add-on:Artwork%20Downloader Artwork Downloader Addon] is installed and has stored images with the Movie or TV Show, also show those images
:'''Dim Level'''
::If to dim the screen when the screensaver runs
|}
<br />
=== File System ===
{| border="0"
|- valign=top
|
:<u>'''''Debugging'''''</u>
::
:'''Enable debug logging'''
::Enables TvTunesScreensaver debug logging (Required if reporting a problem) - for this to work, system-wide Kodi logging must also be enabled
|}
<br />
== Debugging ==
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH:
* Kodi logging from the main setting menu
* TvTunesScreensaver debug from the TvTunesScreensaver addon settings menu
Please do not paste the log into the forum thread, just link to it.
<br />
