TVIP Knowledge Base TVIP Provisioning scheme

TVIP Provisioning scheme

TVIP Provisioning scheme

What you will find:
  • Overview of what provisioning is
  • Overview of the base structure
  • Provisioning options
  • File example

What is Provisioning?

Provisioning gives you the possibility to configure advanced settings to improve the end-user experience and to preconfigure the STB for your clients as needed. Whether you want to personalize your branding on your STB, include a multi-portal, preconfigure security settings, or hide parts of the UI. In the following text you will find the building blocks you need to make this possible and learn how to create a provisioning file. How to use a provisioning file can be found here.

The base structure of a TVIP XML file is the following.
<?xml version="1.0"?>
<provision reload="86400">
  <!-- Modules -->
</provision>
Provisioning reload defines how often the tvip_provision.xml file is checked. The interval is defined in seconds. The default is 86400 seconds, which is 1440 minutes or 24 hours.
Timezone and NTP Server setting
Defines the timezone and NTP server address for the STB.
<time tz="Asia/Singapore" ntp="pool.ntp.org" time_format="12" />
tz – Defines the timezone, in Zoneinfo format
ntp – Defines the NTP server address
time_format – (from fw 4.2.3) Defines the time format, “12” (12-H AM/PM) or “24” (24-H).
Modules and Filtering
Modules are the direct successor of earlier tags.
From fw 5.0.33 it is possible to have different provisioning modules for different devices.
To do so you need to add an additional section.
As an example:
<tv_protocols devices="s605,s530" override="true" default="jsonapi" autostart="true" >
     <protocol type="jsonapi" server="http://example.com" />
</tv_protocols>
<tv_protocols devices="" override="true" default="jsonapi" autostart="true" >
      <protocol type="jsonapi" server="https://example2.com" />
</tv_protocols>
In this example, the S605 and S530 get the middleware address example.com. All other devices get example2.com as address.
STBs with an earlier fw than 5.0.33 get the last middleware server address.
TR-069 Server (ACS)
Supported from fw. 3.8.6
To access your ACS over the CWMP protocol, you need to configure the URL as well as a username and password.
<tr69_server url="http://myacs.net/TR-069" user="test" password="test" />
Syslog Server
Supported from fw. 3.9.13
You need to set an IP address where the syslog messages will be sent.
Syslog uses the UDP protocol on port 514.
<syslog_host name="1.1.1.1"/>

Statistics Server
Supported from fw. 4.0.13
You need to set a URL that will receive the statistics.
<statistics url="http://domain/stbstat/index.php" accum_period="45">
  <media />
  <network period="20" />
</statistics>
Statistics attributes
url – Address of the statistics server.
accum_period – Interval in seconds. Defines how often data is accumulated before it is sent to the server.
Network attribute
period – Interval in seconds. Defines how often the statistics are read from the hardware.
Media attribute
period – Interval in seconds to read from the hardware. If defined, the data will be read periodically and at the end of media playback. If not defined, the statistics will only be read at the end of playback.

Provisioning server
This gives you the possibility to use your own provisioning server. Requests to the new provisioning server will be applied immediately.
<provision_server name="http://tvipstb.net" />
name – Defines the new provisioning server domain.
From fw. 4.0.0 HTTP or HTTPS must be included.
If you need to remove the connection to the provisioning server, leave the name attribute empty.
<provision_server name="" />

Reboot STB on provisioning file change
<restart value="reboot" />
Possible values are
shell – reinitializes the application.
reboot – reboots the STB.
Update server
If you want to use an external update server, the update_server tag is used.
Instructions on how to create an update server are coming soon.
<update_server name="update.tvip.tv" />
name – Defines the domain of the update server.
All official updates are available via the update.tvip.tv server.
Update Types
Defines a list of the different update types that you can find in the settings.
For example, clients can have access to beta and release firmware.
The “release” update type is always available in the menu (named “Default”).
<update_types>
  <device id="s400a">
    <type name="Android/Beta" os="android" type="beta" />
    <type name="Linux-Qt/Release" os="linux-qt" />
  </device>
  <device id="s410" force_type="release" force_os="linux-qt">
  </device>
</update_types>
Device Attribute
id – Defines which device type is configured (e.g. s410, s500).
Type Attribute
name – Defines the update type that is visible to the end user in Display configuration.
os – Defines the OS type, e.g. “linux”, “linux-qt”, “android”.
type – Defines the update type, e.g. “release”, “beta”.
If the os attribute is not defined, the installation will use the current OS.
In this example, the S400 STB (Android) will have access to “android/beta” firmware by default. The S400 can also switch to “linux-qt/release”.
The S410 STB only has access to the “release” version with “linux-qt”. The S410 will also be forced to use the “release” update type on each startup.
Software Update
<updates>
  <update_background force="true" value="true" />
  <update_force force="true" value="true" />
  <update_period force="true" value="60" />
</updates>
update_background – Defines whether a timer will be forced when the “New Software is available” window pops up, to confirm an update.
update_force – Defines whether the “Cancel” button will be hidden in the “New Software is available” window.
update_period – Defines an interval in seconds (60 to 86400) for how often a software update check is performed.
force – Can be used to override user-defined settings.
TVIP App Store Server URL
Supported only for Android OS and from fw. 4.4.1+
Defines the URL of the TVIP App Store.
Example
<appstore_server url="https://operator.com/appstore/appstore.json" />
For instructions on how to install the TVIP App Store, click here.
Add/Hide Web Applications
This allows you to add custom web applications and hide default installed applications.
<webapps>
  <app name="lk" title="User Account" icon="account" uiwidth="1280" uiheight="720" url="http://private.provider.com" api="mag" />
  <app name="plex" />
  <app name="youtube" hidden="true" />
</webapps>
This code hides all default web applications and adds YouTube and the operator’s User Account page.
When the override attribute is “true”, all default apps will be hidden. When the attribute is “false”, the custom app will be added to the default apps. From fw. version 5.0.33, the override attribute is no longer recommended (outdated). For system applications, the hidden attribute is recommended instead.
When the reordering attribute is “true”, it is possible to move web applications using the menu buttons. (Supported from fw. 5.0.48).
Webapp Attribute
name – An individual app name (a-z characters, no spaces). It must not be a duplicate name.
title – A user-visible name in the main menu.
hidden – Allows you to hide a system application.
icon – Icon codename.
uiwidth, uiheight – Defines the UI resolution.
bgr – URL of a PNG image that will be used instead of the default banner. Width: 320px, height: 180px (from fw. 4.0.11).
url – Defines the web application URL.
api – STB API type (e.g. tvip, mag, html5, youtube, blink).
proxy – Defines the HTTP/HTTPS proxy (if required).
dial_origin – Uses the DIAL protocol to launch this application from a second-screen app with a defined origin (from fw. 4.0.19).
dial_title – The name of the application when DIAL is used with multicast.
search_script – Address of a special Javascript code that contains the implementation of the system search logic for the current app (from fw. 4.1.4).
Required attributes are name, title, uiwidth, uiheight, url, api. When icon isn’t specified, name will be used as the icon codename. If no icon is found, the “vod” icon will be used instead.
Reserved Application Names
tvplayer (Watch TV), dvr (DVR), mediaplayer (Mediaplayer), vod (Movies), cctv (CCTV), preferences (Settings), allapps (All android apps)
Default App Name
account (for operator’s User Account page), youtube, plex, kodi
From fw. 5.0.33, reserved applications cannot be changed (URL, icon, etc.). If a system application needs to be replaced, you need to hide the application and create your own application with a different name.
Default path for the config file: /home/tvip/profiles/<profile>/tvip_webapps.xml
Pay attention: For the YouTube app from firmware 4.2.x, it is required to use HTTPS and api=”youtube”.
To return to the main menu, the application must go to the about:back page when exiting.
Disable ALL Webapps
<webapps override="true">
</webapps>
Add/Hide Android Applications
This module can only be used on Android OS STBs (supported from fw. 5.0.30).
This allows you to change the order of applications and hide installed applications.
<android_apps>
  <app name="MediaCenter" title="MyMediaCenter" package="com.droidlogic.mediacenter" hidden="false" bgr="http://tvip.com/myMediaCenter.png" />
  <app name="VideoPlayer" title="MyVidoPlayer" package="com.droidlogic.videoplayer" hidden="true" icon="http://tvip.com/icon.png" />
</android_apps>
Application Attributes
name – A specific app name.
title – A user-readable name for the main menu.
package – The name of the package in the system.
hidden – Allows you to hide applications when set to “true”.
icon – Allows you to replace the icon via URI.
bgr – Allows you to replace the background via URI.
Required Attributes are: package
Stream Source Type Setup
This allows you to choose the stream source type for your IPTV streams: multicast or UDP proxy.
<tv_stream type="multicast" tsbuffer="100" tsboost="false" hls_version="4" />
type – Defines the stream type: “multicast” or “udpxy”.
tsbuffer – Defines the MPEG-TS buffer in msec (default: 0ms).
tsboost – If false, it prevents the “cutting” of excess audio at MPEG-TS startup.
hls_version – Allows you to change the HLS protocol version.
<tv_stream type="udpxy" server="http://user:pwd@host.tv:4022" />
In this example, a UDP proxy is used. The UDPXY server address is specified as server_address:port or user:password@server_address:port using the server attribute.
The attribute speedtest_url defines the URL of the speed test configuration (supported from fw. 4.2.20/4.3.4).
IPTV/OTT Protocol Settings
This defines the different content sources for IPTV/OTT streams.
<tv_protocols default="jsonapi" force="jsonapi">
</tv_protocols>
default – Default middleware type.
force – Forces the middleware type.
autostart – If true, starts the Watch TV app after reboot or sleep (enabled by default).
Supported Middleware types
jsonapi – TVIP JSON API middleware (TVIP TMS).
m3u – M3U playlist.
browser – Web application (portal) middleware.
androidapp – Android app as content source (supported only with Android OS).
TVIP JSON API Middleware setup
<tv_protocols default="jsonapi">
  <protocol type="jsonapi" server="http://api.domain.com" hidden="true" />
</tv_protocols>
server – Defines the URL of the API servers.
hidden – Allows you to hide the middleware server address (from fw. 5.0.7).
M3U-Playlist and XMLTV/JTV EPG Setup
<tv_protocols default="m3u">
  <protocols type="m3u" m3u="http://operator.com/channels.m3u" epg="http://operator.com/epg.zip" />
</tv_protocols>
The URL of the M3U playlist is defined via the m3u attribute. The URL of the EPG file (XMLTV/JTV) is defined via the epg attribute.
Web Portal Middleware Setup
This content source replaces the TVIP IPTV application with a web portal application.
<tv_protocols default="browser">
  <protocol type="browser" server="http://provider.net/stalker_portal" />
</tv_protocols>
server – Defines the URL of the portal (middleware).
api – Defines the Javascript API for the portal (“tvip”, “mag”, “html5”).
If noui is true, the whole UI is replaced by the web portal (whole system mode). If false, the web portal only replaces the Watch TV app (TV only mode). If the combined attribute is true and noui is false, combined mode is used (from firmware 4.0.23).
⚠️ Whole system mode is now deprecated and will be removed in later updates. Use combined mode instead. If you need to block a long press of the Home button, use home_uri with the value tvplayer inside the appearance tag.
Application as Content Source (Android)
This mode works only with Android OS and allows you to use an application as a content source.
<protocol type="androidapp" package="xxxxx" autostart="false" />
package – Defines the name of the package in the system.
autostart – Allows you to automatically start the application when the value is true (supported from firmware 5.0.25).
Media Playback Setup
Supported from Firmware: 4.0.19
Allows you to configure media playback settings.
<media>
  <default_audio_language force="true" value="bul bg eng en" />
  <default_subtitle_language force="true" value="en eng" />
</media>
Force Mount SMB and NFS shares
This forces the mounting of remote storage.
<mountpoints>
  <mountpoint type="smb" mountname="SMB Share">
    <address value="192.168.1.1" />
    <folder value="Movies" />
    <password value="pass" />
    <username value="login" />
  </mountpoint>
  <mountpoint type="nfs" mountname="NFS Share">
    <address value="nfs.operator.com" />
    <folder value="/home/sharing/Movies" />
  </mountpoint>
</mountpoints>
The protocol is set through the type attribute (“smb” or “nfs”), and mountname defines the resource name.
In this example, two shares are mounted:
– SMB directory with name “Movies” on the SMB server with the IP 192.168.1.1, with username “login” and password “pass”.
– NFS directory “/home/sharing/Movies” on the NFS server with the domain name “nfs.operator.com”.
Force add CCTV sources
This sets up sources for the CCTV app. Content sources can be direct URLs in UDP, HTTP, or RTSP formats, or M3U playlists over HTTP.
<cctv_sources>
  <source name="Cameras" url="http://cam.operator.com/cameras.m3u" />
  <source name="Our Office" url="rtsp://cam.operator.com/office" />
</cctv_sources>
name – This attribute sets the name in the CCTV list.
url – Defines the URL of a stream or playlist.
“Cable TV” Mode over Provisioning
Supported from Firmware 4.2.33
This option allows playback of a single stream without a UI.
<system_locks>
  <ctv enabled="true" url="http://your_stream.com" volume="30" />
</system_locks>
Operator Information Settings
This defines basic information, such as the operator name.
<operator name="Operator_Name" />
The following attributes are supported from firmware 3.8.11.
  • tv_app_name – Defines the name of the Watch TV app.
  • tv_app_icon – Defines the icon of the Watch TV app.
Operator Logo Settings
This defines the URL of your logo image, which will be displayed in the main menu.
Limits: The image format must be PNG, and the maximum size is 300 x 300 px. To force an updated logo, a URL change is required.
<logo url="http://tvipstb.net/prov/logo.png" />
url – Defines the URL of the image.
Operator Banner Settings
Supported from firmware version 4.0.11
This defines the URL of the image that will be used as a banner at the top of the main menu.
Limits: The image format must be PNG, and the maximum size is 1920 x 180 px. RGBA is allowed. On some TV sets, parts of the banner may be hidden due to overscan. This should be considered when designing a banner.
Areas that may be hidden:
  • Left and right: up to 145 px.
  • Top: up to 45 px.
<banner url="http://tvipstb.net/prov/banner.png" uri="tvplayer/?channel=1"/>
  • url – Defines the image URL;
  • uri – Defines the system URI that will be executed when a user clicks on the banner (from firmware 4.1.9).
Bootloader Logo
This defines the URL for a special image that is displayed during STB boot.
Limits: The image format must be BMP, and the exact size is 1280 x 720 px. The color depth is 24 bpp. To force an updated logo, a URL change is required.
<bootlogo url="http://tvipstb.net/prov/tvip_splash.bmp" />
url – Defines the image URL.
Background Picture Settings
Defines a colorful background image for the home screen (supported from firmware 4.2.33).
<main_menu_background url="https://www.my_background.png" refresh="3600" />
main_menu_background attributes:
  • url – The server address from which the background image will be loaded.
  • refresh – Update interval in seconds.
Allowed Main Menu Apps
This gives you the option to disable access to different Media Center apps such as DVR, CCTV, VOD, and Mediaplayer.
App Codes:
  • mediaplayer – Mediaplayer
  • dvr – DVR
  • cctv – CCTV
  • vod – Movies
  • tv – TV
  • navigator – Web Browser
  • settings – Settings
  • apps – (All Android) Apps
  • search – The search function
By default, all apps are allowed.
<features>
  <mediaplayer enabled="true" />
  <dvr enabled="true" />
  <cctv enabled="true" />
  <vod enabled="false" />
  <timeshift enabled="false" />
  <appstore enabled="false" />
</features>
The tag name defines the app code, and the enabled attribute defines access: enabled (true) or disabled (false).
  • timeshift – When set to “true”, it enables local timeshift; when set to “false”, it is disabled.
  • appstore – Available only for the 7xx models and defines the App Store.
Security Settings
This allows you to set up channel and app blocking.
Example:
<security>
        <enabled value="true" force="true" />
        <password value="0000" force="true" />
        <autolock_timeout value="600" force="true" />
        <channel_default_locked value="true" />
        <channel_adult_lock value="true" />
        <operator_forced_age value="18" />
        <disabled_apps force="true" value="vidimax,youtube" />
</security>
  • enabled – Activates security mode, which forces the user to use an unlock code (password). To force security mode even if the user tries to disable it, use the force attribute.
  • autolock_timeout – Sets the time period (in seconds) after which the user must enter the unlock code again.
  • channel_default_locked – Blocked-channel mode: When true, only channels in the blacklist are blocked. To block all channels that are not on the whitelist, use false.
  • operator_force_age – Blocks channels with an age tag equal to or greater than the value (firmware 4.0.11+).
  • channel_adult_lock – Blocks adult channels (adult channels should be set by the middleware; from firmware 3.8).
  • disabled_apps – Blocks apps. To block multiple apps, use a comma between the app names.
Display Settings
<display>
  <hd_format value="720p50" />
  <hdmi_autofr value="false" />
  <sd_format value="auto" />
  <aspect value="box" />
  <cec value="false" force="true" />
  <sync_standby value="true" />
  <cec_name value="anyName" />
</display>
  • hd_format – HDMI output resolution (auto, 2160p50, 1080p50, 1080p60, 1080i50, 720p60, 720p60, 576i50).
  • sd_format – A/V output (auto, pal, ntsc).
  • hdmi_autofr – HDMI output.
  • cec – Enables HDMI-CEC.
  • aspect – Default aspect ratio (box, zoom, full). To use the default, set an empty value =””
  • sync_standby – The STB goes to sleep/wake when the TV goes to sleep/wake (not supported by all Media Centers and TVs; from fw. 4.0.13).
  • cec_name – Allows you to choose a device name via HDMI on compatible TVs. Character format (Aa – Zz, -, _, 0-9) (supported from fw. 5.1.26).
  • To force certain settings to apply, use the force attribute with the value =”true”.
Auto Standby Mode Setup
Supported from fw. v.3.8.6
<auto_standby timeout="3600" force="true" />
  • timeout – Defines the time in seconds until the STB goes into standby mode (possible values: 60 to 2500000 seconds, or 0 to disable it).
  • force – When true, overrides the user’s settings.
Appearance Settings
<appearance>
  <uialpha value="50" />
  <animation value="true" force="true" />
  <listlooped value="true" />
  <uipadding value="large" />
  <tv_preview_mode value="true" force="true" />
  <display_channel_numbers value="true" />
  <channel_icons_aspect value="1.777"/>
  <display_channel_has_archive value="true" />
  <background_picture value="Custom" force="true">
  <picture name="Custom" url="http://domain/Custom.png"/>
  </background_picture>
  <media_freeze_animation value="false" />
  <back_as_recall value="true" />
  <menu_as_home value="true" />
  <menu_as_audio_track value="true" />
</appearance>
  • uialpha – UI transparency (0-100 %) not available after firmware version 4.0.
  • animation – Enables (true) or disables (false) UI animations.
  • listlooped – Enables or disables looping of the channel list.
  • uipadding – Overscan setup (“small”, “medium”, “large”).
  • tv_preview_mode – Enables or disables preview mode in the channel list.
  • false – No preview mode.
  • true – Preview mode for the currently active stream.
  • hybrid – Preview window displays the channel currently selected by the cursor.
  • tv_cursor_mode – Allows simple TV control mode. In this mode, the cursor keys control the volume and channel switching.
  • display_channel_numbers – Enables (true) or disables (false) the display of channel numbers (supported from fw. 4.0.17).
  • channel_icons_aspect – Channel icon aspect ratio (aspect = width/height). Can be used to optimize the UI for the channel layout (supported from fw. 4.0.20).
  • home_uri – Defines the system URI that will be executed when pressing the Home key instead of launching the home screen (supported from fw. 4.2.12).
  • display_channel_has_archive – When true, shows an archive-active icon in the channel list (supported from fw. 4.2.16).
  • background_picture – Defines a monochrome image in the main menu (and some other apps). value sets an identifier for this image. The identifier can be internal (e.g. waves, triangles) or can be a <picture> tag. Attributes of the <picture> tag: name – Background identifier; url – URL of an 8-bit monochrome PNG image (supported from fw. 4.2.16).
  • media_freeze_animation – Controls “freeze” animations: true disables animations and false enables animations (supported from fw. 4.2.33).
  • back_as_recall – Allows you to assign the Back button to return to the previous channel (supported from fw. 5.0.67).
  • menu_as_home – Allows you to use the menu button to trigger the home action, except when used for its intended purpose. This functionality works only in the TV application (supported from fw. 5.1.45).
  • menu_as_home – Allows you to use the menu button to switch audio tracks.
  • To force certain features, use the force attribute with the value =”true”.
Userinterface Setup, with Color Schematics
Supported from firmware 4.0.17
<appearance>
  <color_schemes value="true" override="true" default="Berries" force="Berries">
    <scheme name="TVIP brand color">
      <color name="CL_MAIN" value="#ff2A50A3" />
      <color name="CL_BACKGROUND" value="#ff14A2DC"/>
      <color name="CL_CONTRAST_MAIN" value="#ffCAE2F5"/>
      <color name="CL_CONTRAST_BACKGROUND" value="#ffCAE2F5"/>
      <color name="CL_SECOND" value="#ffF37121"/>
      <color name="CL_button_casual" >CL_BACKGROUND</color>
    </scheme>
    <scheme name="Berries">
    </scheme>
  </color_schemes>
</appearance>
color_scheme – Defines the color scheme of the UI. Attributes: override – If true, all preinstalled schemes are overridden by the operator’s schematics. default – Name of the default scheme; force – Forces the color scheme. scheme – Single operator scheme. name – Defines the name of the scheme. color – Defines a color variable; name – Defines the color ID of the scheme. Value defines an ARGB color like: #AARRGGBB.
Base Scheme Colors:
CL_MAIN – The main color of the scheme. It will be used for non-transparent elements at the top and bottom of the screen (default: #ff37363c).
CL_BACKGROUND – Background color for elements in the center of the screen and the background of tables (default: #73aaaaaa).
CL_CONTRAST_MAIN – Item color (text, images) displayed on the main color. This should contrast with CL_MAIN (default: #ff282832).
CL_CONTRAST_BACKGROUND – Item color (information) displayed in the center of the screen (e.g., pop-up menus and transparent windows). This should contrast with CL_BACKGROUND (default: #ffffffff).
CL_SECOND – Secondary scheme color. This is used for active control elements (selectors, buttons) (default: #ffffffff).
Extended Colors
These optional colors can be defined. If they are not defined, they will be calculated automatically.
Color Dependency Transparency Description
CL_on_main_casual CL_CONTRAST_MAIN 1,00 General color for elements on top of the main color.
CL_text_on_main_casual CL_on_main_casual 1,00 Base text color displayed on top of the main color.
CL_text_on_main_active CL_on_main_casual 1,00 Active/selected text color displayed on the main color.
CL_text_on_main_dimmed CL_on_main_casual 0,55 Dimmed text color displayed on top of the main color.
CL_on_background_casual CL_CONTRAST_BACKGROUND 1,00 General color for elements in the center or inside a table.
CL_text_on_background_casual CL_on_background_casual 1,00 Base text color inside a table.
CL_text_on_background_active CL_on_background_casual 1,00 Active/selected text color inside a table.
CL_text_on_background_dimmed CL_on_background_casual 0,55 Dimmed text color for inactive elements in tables and some secondary text.
CL_wallpaper CL_BACKGROUND 0,90 Background color for most UI widgets.
CL_fade CL_BACKGROUND 0,90 Video overlay color for fullscreen elements.
CL_additional CL_BACKGROUND 0,40 Additional color for active widgets and active table columns.
CL_bgr_color CL_MAIN 1,00 Color of the background image in the home screen (when no video) and for some other elements.
CL_bumper CL_MAIN 0,94 Color of the top and bottom panels.
CL_header CL_bumper Background color of elements at the top of the screen.
CL_footer CL_bumper Background color of elements at the bottom of the screen.
CL_popup CL_MAIN 1,00 Color of dialog windows, extended settings, and system messages.
CL_popup_contrast CL_CONTRAST_MAIN 1,00 Content color inside dialog windows.
CL_plate CL_MAIN 1,00 “Plates” (home screen, VoD elements, etc.) color.
CL_plate_contrast CL_CONTRAST_MAIN 1,00 Content (text, buttons) color inside “plates”.
CL_selector CL_SECOND Selector color for active/selected control elements: cursor, active buttons, etc.
CL_empty CL_SECOND 1,00 Color of the inactive part of the progress bar.
CL_inactive CL_SECOND 0,35 Color for disabled UI elements (buttons).
CL_full CL_CONTRAST_MAIN 1,00 Color of the active part of a progress bar.
CL_button_selected CL_selector 1,00 Color of a selected button.
CL_button_casual CL_selector 0,35 Color of a disabled button.
CL_on_button CL_on_background_casual Text and icon color for a button.
Preinstalled scheme names are the following:
Default Deep Purple Indigo Teal Blue Light Green Berries Chocolate Medusa
Restrict Access to Media Center Settings
It is possible to hide or disable almost any setting. Note: This does not set any values. It controls access to the settings for the end user. To use this, you should define the ID of the setting.
Possible values:
visible=”false/true” enabled=”false/true”
Root Settings Tabs:
  • pref_system – System
  • pref_appearance – Appearance
  • pref_network – Network
  • pref_display – Display
  • pref_tv – TV
  • pref_security – Security
  • pref_os – Restrict access to Android OS settings (for Android OS devices).
Example
<preferences>
  <pref_network visible="false" />
</preferences>
In this example, the “Network” tab is completely hidden.
System tab IDs
  • pref_system_language – System language
  • pref_system_updatetype – Update type
  • pref_system_updateperiod – Update period
  • pref_system_updatebackground – Background installation
  • pref_system_timezone – Timezone
  • pref_system_timeserver – NTP server address
  • pref_system_timeformat – Time format
  • pref_system_auto_standby – Auto standby
  • pref_system_audiolanguage – Default audio language
  • pref_system_subtitlelanguage – Default subtitle language
  • pref_system_digitalsoundmode – Digital sound
  • pref_system_dial – Multiscreen
  • pref_system_button_bluetooth_remote – Bluetooth setup
  • pref_system_button_checkupdates – Check updates
  • pref_system_button_info – Info button
Appearance tab IDs
  • pref_appearance_alpha – UI transparency
  • pref_appearance_anim – Animated UI
  • pref_appearance_channel_numbers – Channel numbers
  • pref_appearance_channel_icons – Display channel icons
  • pref_appearance_listlooped – Looped channel list
  • pref_appearance_padding – Overscan
  • pref_appearance_tv_preview_mode – TV preview mode
  • pref_appearance_tv_cursor_mode – TV cursor mode
  • pref_appearance_color_preset – UI color preset
  • pref_appearance_background – UI background
Network tab IDs
  • pref_network_iface – Interface type (Eth/Wlan)
  • pref_network_iface_enabled – Network interface enabled
  • pref_network_wlan_ssid – Wi-Fi access point
  • pref_network_config – Config (DHCP/Manual)
  • pref_network_ip – IP address
  • pref_network_mask – Mask
  • pref_network_gateway – Gateway
  • pref_network_dns1 – DNS1
  • pref_network_dns2 – DNS2
  • pref_network_router_mode – Network sharing
Display Tab IDs
  • pref_display_hdformat – HD format
  • pref_display_hdhdmienable – HDMI enable
  • pref_display_hdcomponentenable – Component enable
  • pref_display_sdformat – SD format
  • pref_display_sdrcaenable – RCA enable
  • pref_display_sdsvideoenable – S-Video enable
  • pref_display_aspect – Aspect ratio
  • pref_display_cec – HDMI-CEC
TV Tab IDs
  • pref_tv_streamtype – Stream type
  • pref_tv_udpxyaddress – UDPXY address
  • pref_tv_mpegts_buffer – MPEG-TS buffer
  • pref_tv_dvr_deviceid – DVR storage
  • pref_tv_timeshift_deviceid – Timeshift storage
  • pref_tv_autotimeshift – Autotimeshift
  • pref_tv_middleware – Content source
  • pref_tv_button_midd_setup – Content source setup
  • pref_tv_inter_apps – Interactive apps
Security Tab IDs
  • pref_security_enable – Enable security
  • pref_security_timeout – Autoblock timeout
  • pref_security_tvfiltertype – Filtering type (blacklist/whitelist)
  • pref_security_operatorlock – Adult channel block
  • pref_security_allowtv – Enable/disable Watch TV
  • pref_security_allowmediaplayer – Enable/disable Mediaplayer
  • pref_security_allowdvr – Enable/disable DVR
  • pref_security_allowcctv – Enable/disable CCTV
  • pref_security_allowwebapps – Enable/disable web apps
  • pref_security_allowapps – Enable/disable Android apps
Example
<preferences>
  <pref_network visible="false" />

  <pref_tv>
    <pref_tv_streamtype visible="false" />
    <pref_tv_udpxyaddress visible="false" />
    <pref_tv_middleware disabled="true" />
  </pref_tv>
</preferences>
In this example, the Network tab is fully hidden. In the TV tab, Stream Type and UDPXY Address are also hidden. In the TV tab, changes to the middleware setting are prohibited.

tvip_provision.xml Example:

<?xml version=”1.0″?>
<provision reload=”3600″><!–Update time in seconds –>

 <!– Update server setup –>
 <update_server name=”update.tvip.tv” />

 <!– Logo setup –>
 <logo url=”http://operator.com/prov/logo.png” />

 <!– Hider DVR App –>
 <features>
   <dvr enabled=”false” />
 </features>

 <!– UDP-proxy setup –>
 <tv_stream type=”udpxy” server=”login:pass@udpxy.operator.com” />

 <!– M3U and EPG setup –>
 <tv_protocols default=”m3u”>
   <protocol type=”m3u” m3u=”http://operator.com/channels.m3u” epg=”http://operator.com/epg.zip” />
 </tv_protocols>

 <!– Add video source –>
 <mountpoints>
  <mountpoint  type=”smb” mountname=”SMB Share”>
    <address value=”192.168.1.1″ />
    <folder value=”Movies” />
    <password value=”pass” />
    <username value=”login” />
  </mountpoint>
 </mountpoints>

 <!– CCTV setup –>
 <cctv_sources>
  <source name=”Cameras” url=”http://cam.operator.com/cameras.m3u” />
 </cctv_sources>

 <!– Disable network user-preference. Middleware change restriction. –>
 <preferences>
   <pref_network visible=”false” />
   <pref_tv>
     <pref_tv_streamtype visible=”false” />
     <pref_tv_udpxyaddress visible=”false” />
     <pref_tv_middleware disabled=”true” />
   </pref_tv>
 </preferences>

</provision>