From Official Kodi Wiki
Revision as of 14:26, 1 October 2016 by Rob webset (talk | contribs)
Jump to navigation Jump to search


Author: robwebset

Type: Screensaver

License: GPL v3.0
Source: Source code
Summary: Plays your themes while showing images for each TV Show or Movie
Home icon grey.png   ▶ Add-ons ▶ TvTunesScreensaver
Attention talk.png Need help with this add-on? See here.

The TvTunes Screensaver makes use of the themes configured in your library to use them as a screensaver.


You can install this addon from: Repository:robwebset

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 TvTunes but can also be used to just display images if you would rather theme audio was not played in the background.

Screensaver Formats

The following formats are available within TvTunes Screensaver

Slider - This will slide the images into view from either the left, right, top or bottom of the screen. TvTunes-Screensaver-Slider.JPG
Crossfade - will fade one image in over the top of the next image TvTunes-Screensaver-Crossfade.JPG
TableDrop - will drop each image onto the screen at random overlaps and angles TvTunes-Screensaver-Tabledrop.JPG
StarWars - will show a stream of images similar to the Star Wars intro sequence TvTunes-Screensaver-Starwars.JPG
RandomZoomIn - will randomly zoom in to each image in turn TvTunes-Screensaver-RandomZoomIn.JPG
AppleTVLike - like the Apple TV Screensaver, will scroll a mix of images up from the bottom of the screen TvTunes-Screensaver-AppleTVLike.JPG
GridSwitch - will show several images at the same time in a grid format TvTunes-Screensaver-GridSwitch.JPG
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.



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


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 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

File System

Enable debug logging
Enables TvTunesScreensaver debug logging (Required if reporting a problem) - for this to work, system-wide Kodi logging must also be enabled


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.


If you have found TvTunesScreensaver useful and would like to help support future development and bug fixes, then please feel free to make a small donation.

Please use the link on the top of the TvTunesScreensaver Forum