Add-on:VideoScreensaver

Introduction
VideoScreensaver is a screensaver that will play a video file when the screensaver starts. It will support playing either a user specified video file, or one of several pre-defined video files.

Forum And Issue Report Pages
If you have any questions, found an issue to report or would just like to know a little more you can take part in the forum discussions at:

VideoScreensaver Forum

Built-In Screensaver Videos
The following screensaver videos are supplied with the addon.

Aquarium 1 - [846MB] - 400p

 * Aquarium001.png

Aquarium 2 - [2.7GB] - 720p

 * Aquarium002-720p.png

Aquarium 3 - [2.4GB] - 720p

 * VideoScreensaver-Aquarium003.PNG

Aquarium 4 - [780MB] - 720p

 * VideoScreensaver-Aquarium004.JPG

Beach 1 - [2.5GB] - 720p

 * VideoScreensaver-Beach001.JPG

Beach 2 - [838MB] - 720p

 * VideoScreensaver-Beach002.JPG

Beach 3 - [3.4GB] - 720p

 * VideoScreensaver-Beach003.JPG

Christmas 1 - [777MB] - 1080p

 * VideoScreensaver-Christmas001.JPG

Fireplace 1 - [965MB] - 720p

 * Fireplace001-720p.png

Fireplace 2 - [827MB] - 480p

 * Fireplace002.png

Fireplace 3 - [2.1GB] - 1080p

 * Fireplace003-1080p.png

Fireplace 4 - [2.7GB] - 720p

 * VideoScreensaver-Fireplace004.PNG

Johnny Castaway 1 - [75MB] - 480p

 * VideoScreensaver-JohnnyCastaway001.JPG

Matrix 1 - [909MB] - 720p

 * VideoScreensaver-Matrix001.JPG

Ocean 1 - [1.1GB] - 720p

 * VideoScreensaver-Ocean001.JPG

Retro Sci-Fi 1 - [200MB] - 1080p

 * VideoScreensaver-RetroSciFi001.JPG

Snow 1 - [1.3GB] - 720p

 * VideoScreensaver-Snow001.JPG

Snow 2 - [677MB] - 1080p

 * VideoScreensaver-Snow002.JPG

Snow 3 - [1.2GB] - 720p

 * VideoScreensaver-Snow003.JPG

Space 1 - [970MB] - 720p

 * VideoScreensaver-Space001.PNG

Space 2 - [563MB] - 1080p

 * VideoScreensaver-Space002.JPG

Star Trek TNG 1 - [54MB] - 720p

 * VideoScreensaver-StarTrekTNG001.JPG

Waterfall 1 - [1.3GB] - 720p

 * VideoScreensaver-Waterfall001.JPG

Waterfall 2 - [1.3GB] - 720p

 * VideoScreensaver-Waterfall002.JPG

Waterfall 3 - [2.4GB] - 720p

 * VideoScreensaver-Waterfall003.JPG

Watermill 1 - [549MB] - 1080p

 * VideoScreensaver-Watermill001.JPG

Woodland 1 - [1.3GB] - 720p

 * VideoScreensaver-Woodland001.JPG

Built-In Overlay Images
The following overlay images are supplied with the addon.

Picture Frame 1

 * [[File:PictureFrame1.png]]

Window Frame 1

 * WindowFrame1.png

Window Frame 2

 * WindowFrame2.png

Settings
This section details all the settings options for VideoScreensaver

Detecting If VideoScreensaver Is Running
The way that VideoScreensaver has been implemented in order to play a video as a screensaver, it will not be recorded via the normal "xbmc.Monitor" onScreensaverActivated or onScreensaverDeactivated method. In fact when the screensaver starts you will get both an onScreensaverActivated and onScreensaverDeactivated message before the VideoScreensaver starts playing.

If you wanted to work out if VideoScreensaver is active from another script then you can check for the "VideoScreensaverRunning" property being set: This will return the value "true" if it is running.

It is also worth noting, that while the screensaver is starting up it will set the "VideoScreensaverStarting" property, that can be checked as follows: This will return the value "true" if it is currently starting.

Auto-Shutdown Will Not Activate While VideoScreensaver Is Running
If you enable Kodi Auto-Shutdown options in Kodi System Settings they will not trigger while VideoScreensaver is active - this is because the video being played as part of the screensaver will make Kodi "active". The impact of this can be lessened by enabling "Stop Screensaver Automatically"

Changing Screensaver volume will not work when using audio Pass-Through
If you have Audio-Passthrough enabled in your audio settings then the ability to reduce the volume of the screensaver will not function. This is because you have removed Kodi's control of the audio. If you wish to set the volume to zero, then there is an option to "Suspend The Audio Engine"

Where are the built in videos stored after download?
The location of the video files will vary depending on the OS where Kodi is installed. The location can be retrieved by switching the "Video Selection" option in settings to "User Defined". This will then display the full path in the "Select Videos Folder/File" setting.

Can Kodi play music or radio while showing a screensaver video?
Unfortunately this is not possible. This is because Kodi can only play one media type at a time.

Debugging
If reporting a problem, please also provide a debug log. To do this you need to enable BOTH: Please do not paste the log into the forum thread, just link to it.
 * Kodi logging from the main setting menu
 * VideoScreensaver debug from the VideoScreensaver addon settings menu

Donations
If you have found the VideoScreensaver Addon 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 VideoScreensaver Forum