Skip to end of metadata
Go to start of metadata

If your devices generates and installation shortcut when it starts. You should not add the device manually, please see Device Provisioning section.

To add an installation, from within the Installation tab, click the add button.


A provide a name that allows you to easily distinguish your device.


Provide a simple description of the device for informational purposes.


Layouts allow you to choose how the device utilises the screen to display content. Each Zone is linked to either a piece of Content, a Sequence or a Channel. It is recommended that you link your zones to a a Channel unless you have a particular user case that you need to link the zone to a piece of Content or Sequence.

Single zone layouts

Select the layout you prefer


Although you may specify a layout above, the device must be able to support it. Many Android ROMS built for media boxes do not support orientation changes, and are hard coded to 16:9 portrait. Please attempt to set the orientation in the player settings. If this does not work , your ROM has been hard coded and you will need to talk to your hardware manufacturer.

Multi zone layouts

To select a more complex arrangement, click the drop down arrow beside "Multi zone layouts"


Having selected a layout with multiple zones, you must then select a piece of Content, a Sequence or a Channel to display in this zone.


If you are selecting a zone that has 4:3 layout, you must have Content, a Sequence and or a Channel that has 4:3 content in it. The same applies for all Aspect Ratios. You must first select your Aspect Ratio in Cloud Button drop down, and upload your content accordingly. Uploading 4:3 content while you have selected 16:9 will create stretched content, and will not show up as 4:3.

Proceed by selecting Content, Sequence or Channel as shown below


Active Period

Active period allows you specify when the device should be on, when it is set to scheduled to be off, it will be in a standby mode. The available options are


Always is the default, the screen will always be on.


Never turn on the screen


Mornings will  turn on the display between 00:00:00 and 11:59:59. You can also specify the timezone.


Afternoons  will  turn on the display between 12:00:00 and 17:59:59. You can also specify the timezone.


Evenings  will  turn on the display between 18:00:00 and 23:59:59. You can also specify the timezone.

Office Hours

Office hours will  turn on the display between 08:00:00 and 17:59:59 Monday to Friday. You can also specify the time zone.


Weekends   will  turn on the display between 00:00:00 and 23:59:59 Saturday and Sunday. You can also specify the time zone.

User Defined

User Defined is the most advanced option. Using User Defined you can select periods that the display should be turned on.



The example above will display content from 09:00:00 to 10:59:59 every day and month from Monday to Friday, allowing you to specify a specific user defined active period for when the device should be on.


JscreenFix allows you to prevent pixel burn in on your devices by displaying an inverse of content. Please see for more information. The same period selections apply as to the "Active Period"

Emergency Channel

Emergency Channel allows you to specify a channel or sequence to display if the "Emergency Channel" is turned on. This is useful for displaying warning messages or escape routes for large buildings. The displays will turn on full screen mode with one single zone.

Current Location

Current location allows you to select a physical location the map (provided by Google Maps) for your device. Do not use this option if your device has GPS enabled and is transmitting a GPS location. 

First select "Select installation location" tick box

Using the location marker provided by Google, drag and drop to the exact location of the device. The GPS co-ordinates are provided by Google Maps API and can be shown within the JSON object of the device. This can also be used for GPS based targeting even though the location is static.


Tags allow you to set identifiers on the installation that can be used for Searching Installations. An example is to specify the city, and the street as show below. You could use tags to add your own internal system ID to the installation, allowing you to easily tie this up with your existing inventory management system. This could be a serial number, MAC address, or your existing id system.

Advanced Options

There are a range of advanced options that are not visible to the regular user that can override lower level settings

Connect Box options

Allows you to map a USB based keyboard, or USB based motion sensor that emulates a key stroke to a Sequence or Channel. For example if you plugged a keyboard into your Android device and pressed button 1, so long as you have a channel linked to the device it will change the display to whatever is specified against Button 1. The example below shows Button 1 linked to "example3" channel. If these options are not available to you in your Installation Editor, you must contact your Administrator.

If you are using Connect Box hardware, you might have a motion sensor you can connect. If you are not using Connect Box hardware, you will need to emulate a key stroke (1-9) with motion sensor

Edit advanced options

Server Side

Advanced options can override the players on the device, the next time the device checks in it will inherit the new settings. A player restart will be required before the settings take effect.


These settings will always override the player settings

KeyValue exampleDescription
Maximum image quality. Player will not download or display imagecontent above this value.
Maximum video quality. Player will not download or display video content above this value.
s_srv0 | 1 Run as service
s_int0 | 1Interaction 
s_upwpasswordPassword required to modify settings.
s_fcn0 | 1Fresh content popups 
s_cmg Channel list (group name)
s_smg Sequence list (group name)
s_geo0 | 1 Report location (geolocation) 
s_fc0 | 1 Face counting 
s_udp0 | 1Use UDP
s_sig0 | 1Verify signatures
s_offline0 | 1Offline mode
s_rurperiod in millisecondsRestrict Update Rate
Video file format. ".mp4" is default and will use server side encoded. "" will use native original source video.
s_so[contact us]Screen orientation 
s_grow0 | 1  Stretch content 
s_vps0 | 1 | 2 | 3Video playback strategy 
s_us0 | 1Update strategy.
0 = standard updating. Requires user to approve the update.
1 = silent updating. No approval will be required to install update on the device. The device must be rooted and the player must have root permissions.
Setting to 1 also changes the restart action to restart the whole device, not just the app.
s_fcd0 | 1Face counting test
s_sd0 | 1Enable alternate cache location.
s_storeFile system pathFull path to alternate cache location.
s_pxy0 | 1Enable caching HTTP proxy server.
s_pxh192.168.0.2Host address of HTTP proxy server.
s_pxp3128Port of HTTP proxy server.
s_prime0 | 1Download images and videos into the local cache.
s_ts0 | 1Ability to disable the warning messages displayed on screen
s_nav0 | 1Removes the left and right arrows
s_protected0 | 1Protects the installation from deletion on the server.


Player Initialisation

A number of initialisation options can be specified at player startup. Options are comma separated in a parameter called options, or as the third argument when invoking targetr.install(this, shortcut, options) on a TargetR image. (JavaScript player only).

 jsonpInstructs the browser to use JSON with padding for communications. This is required when embedding a TargetR player on a different domain to the TargetR server.
 nostatsPrevents statistics on the number of displays being counted by the server. This is useful for previews for example in the TargetR Admin Interface.
 notransitionsDisables transitions between content. Useful for low performance players.
 mutedMutes sound used in videos (WebPlayers only)
 180pInstructs the player to only use content at 180p (320 x 180 pixels for 16:9)
 480pInstructs the player to only use content at 480p (854 x 480 pixels for 16:9)
 720pInstructs the player to only use content at 720p (1280 x 720 pixels for 16:9)
 1080pInstructs the player to only use content at 1080p (1920 x 1080 pixels for 16:9)
 2160pInstructs the player to only use content at 2160p (3840 x 2160 pixels for 16:9) 
Note: Server must be configured to support 2160p
 nativeUse unprocessed content (original upload). This option should be used for testing purposes only as the content might not be suitable for all players. Image distortion may occur if the incorrect aspect ratio is uploaded.
 nativevideoUse unprocessed video content (original upload).


  • No labels