Video Kiosk supports .url files (web shortcuts). This feature is typically used to display live web content, like an Instagram feed, but you can reference any URL on the web as well as locally stored html content and images. To use URL Bookmarks, create a .url file and put the .url files in the media folder.
- If your media folder includes .url files, the content will be displayed for the duration of time specified in the .url file. (The default is to display the web content for 30 seconds.)
- If Video Kiosk encounters an invalid URL, it will skip the file and will play the next media file. (A URL is considered invalid if the URL is incorrectly formed or if the page doesn’t exist.)
How to use URL Bookmarks
To use a URL bookmark to display content, follow these steps:
- In a Text Editor, create a URL file, with the extension “.url”. For file contents requirements, refer to the URL file Syntax Guide, below.
- Place the .url files in your media folder. For further information about playback, refer to [Controlling Playback, p. 1]
URL file Syntax Guide
|URL||Identifies the url value
Valid Values:Any valid url address
|TIMEOUT||Indicates how long, in seconds, Video Kiosk will display the web content.
Valid Values:Default is 30 secondsAny valid floating point number
|CACHE-MODE||Indicates whether to cache the web content
Valid Values:default is no-cacheno-cache – web content is not cacheddefault – web content is cached
|LAYER-TYPE||Indicates where to render the web content
Valid Values:Default is hardwarehardware – web content is rendered on the hardware accelerated layersoftware – web content is rendered on the software layer
|USER-AGENT||Allows you to specify the user agent sent to the web server.
Example: USER-AGENT=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.4
|If the web page contains audio content, the content volume can be muted during background pre-loading of the content
Valid Values:Default is falsetrue – the volume will be mutedfalse – the volume will not be muted
|Normally the web page will be displayed when the previous item finishes playing. You can specify that the web page should be shown as soon as the preloading is complete.
Valid Values:Default is falsetrue – the page will be displayed as soon as the preload completesfalse – the page will be displayed when the previous item is finished playing
Examples: URL Files
The following example shows the content of a .url file that instructs Video Kiosk to play the BurningThumb Studios home page for 30 seconds without caching the web page content:
[InternetShortcut] URL= http://www.burningthumb.com/ TIMEOUT=30 LAYER-TYPE=software CACHE-MODE=no-cache
The following example shows the content of a .url file that instructs Video Kiosk to auto play a YouTube video for 138 seconds while caching the web page content. Notice that a desktop (Mac OS X) USER-AGENT is specified so that the video will auto play even though the real user agent is on a mobile device which would result in auto play not working:
[InternetShortcut] URL=https://www.youtube.com/embed/lYQWiQJJ4lE?rel=0&autoplay=1 TIMEOUT=138 LAYER-TYPE=hardware CACHE-MODE=default USER-AGENT=Mozilla/5.0 (Macintosh; Intel Mac OS X 10_12_5) AppleWebKit/603.2.4 (KHTML, like Gecko) Version/10.1.1 Safari/603.2.
Customizing URL Bookmark display
Customizing Playback – what is played and when
- Changing playback order.
To learn how to display the contents of the Media folder in a different order, refer to the Controlling Playback Order Tutorial.
- Scheduling playback.
To learn how to schedule playback for different times of the day, refer to the Playback Scheduling Tutorial.
Using Split-screen playback mode
- Using multi-panel display mode.
To learn how to play video in Panel A of Video Kiosk’s Digital Signage multi-panel Widget Mode, refer to the Digital Signage Widget Mode Tutorial.
Controlling the Display
- Fade time between url files.
To change the fade time between url, go to Video Kiosk Settings > Timers > Web fade time and change the display time
- Screen orientation.
Video Kiosk allows you to set the screen orientation for just the media playback screen. The other views, such as settings, are not affected. The supported orientations are: Default (set by the device manufacturer), Landscape, Portrait, Reverse Landscape, Reverse Portrait. To change the screen orientation, go to Video Kiosk Settings > View Options. (To change all the view orientations, use the device System Settings)
Overlays and Backgrounds
Video Kiosk supports using an overlay, often used to overlay content with a company logo in the corner of the screen. For more information, refer to the Overlay Tutorial.
- Background Images.
Video Kiosk supports background images that will be displayed behind your media as it is playing and behind digital signage. You can use no background image (the default), one background image, or cycle between a number of background images.