Using URL Bookmarks to display Content



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:

  1. In a Text Editor, create a URL file, with the extension “.url”. For file contents requirements, refer to the URL file Syntax Guide, below.
  2. Place the .url files in your media folder. For further information about playback, refer to [Controlling Playback, p. 1]

URL file Syntax Guide

[InternetShortcut] Section identifier Required
URL Identifies the url value
Valid Values:Any valid url address
Example: URL=http://www.burningthumb.com/
Required
TIMEOUT Indicates how long, in seconds, Video Kiosk will display the web content.
Valid Values:Default is 30 secondsAny valid floating point number
Example: TIMEOUT=45
Optional
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
Example: CACHE-MODE=default
Optional
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
Example: LAYER-TYPE=software
Optional
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
Optional
MUTE-ON-PRELOAD

 

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
Example: MUTE-ON-PRELOAD=true
Optional
SHOW-AFTER-PRLOAD

 

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
Example: SHOW-AFTER-PRELOAD=true
Optional

 

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

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

  • Overlays.
    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.


More Information

Buy it now
$14.95 / device

Get it on Google Play

Download the
FREE trial

Download Now