Skip navigation

Note! This feature is available only for the STBs of MAG family running Linux.

Ministra TV platform interface since version 5.0.4, is based on three components:
  • Meta-package defines a set of applications and their order in the main menu.
  • Theme allows you to change the colour, background, visual sizes of app elements and fonts.
  • Launcher configuration allows you to set logo and create a list of categories in the main menu (standard categories - Media, Apps, Games).

Ministra TV platform branding is done in two ways:

  1. Creation/modification of themes, application meta-package and change of launcher configuration.
  2. Manual images replacement on the specific paths, colour editing in CSS files the theme, installing a custom set of applications via Ministra Administrative Panel.

This document contains the abbreviation "{0}" - the current screen height (1080, 720, 576, 480), is set depending on the device resolution.

Applications meta-package

A set and order of application is defined in the meta-package, according to the dependencies in the file package.json . Standard meta-package is called stalker-apps-base .

In order to change the set and order of applications in the main menu, you need to develop your own applications meta-package or edit the list in the corporate meta-package manually.

We recommend using the source files of our corporate meta-package to develop your own meta-package.

How to develop and activate your own meta-package using standard meta-package:

  1. In package.json file change the name of the stalker-apps-base package on your own.

  2. Specify the name of the meta-package in configuration file custom.ini. (Field value launcher_apps_base_metapackage ).

  3. Publish the package using npm system. In the catalogue of this package, run the command

    npm publish
  4. Install published package via the administrative panel. More details here.

To edit the corporate meta-package, browse to the admin panel and follow these steps:

1. Open the tab Applications.
2. Select Smart Launcher Apps.
3. Click List of installed and choose the Save the list.
4. Edit the saved list (change the order of applications, remove the applications, add your own set applications).
5. Click List of installed and select Upload the list.
6. Click Select file, uploading your edited list of applications.
7. Click Send.

If you have added your own applications while editing the list, they must be published on npm-server. In the catalogue package, run the command

npm publish

Applications themes of Ministra TV platform 5.x

The meta-package stalker-launcher-base includes the following themes:

  • Stalker 5x - graphite (magcore-theme-graphite)
  • Stalker 5x – chocolate (magcore-theme-chocolate)

To change the visual appearance of the theme, create your own theme or modify installed.

A theme standard is developed to support compatibility of different versions of applications and themes. The theme standard is a set of CSS classes, necessary for the correct display of applications.

The theme standard is described in npm-package magcore-theme in readme.md file.

Creating a theme

To create your own theme using only CSS, it is enough to publish npm-package, with a recommended prefix magcore-theme-, in which must contain four CSS-file: 480.css , 576.css , 720.css , 1080.css for four resolutions respectively.

These files must comply with the requirements of theme standard of the current version. To view the current version of the standart, browse to the admin panel and filter the applications by type System. Package version magcore-theme will be the current.

The source files of any theme are available upon request, support@infomir.eu.

Modification of an existing theme

A simplified version of theme customization - manual. To change colour scheme of the app, manually replace the colour values in the CSS files.

The following example shows the path to the theme: /stalker_launcher_apps/magcore-theme-name_theme .

At the root of the theme lies file, which is responsible for the theme background: /img/{0}/bg The colours are made in HEX format. For example, blue background of the focus button of Stalker 5x theme - graphite has a value of "# 2c60c6".

Please note that if you have customized the theme, you must disable auto-update. Otherwise, after the theme update, you should repeat the modification.

The structure of the file paths

By default, all packages are located in stalker_launcher_apps directory .

After installation in this directory will appear directories with the packages' names. In these directories of the packages will be the directories with their versions, that contain app files.

An example of the full path to the package content for the tv version 1.2.4: stalker_launcher_apps / magcore-app-tv / 1.2.4 ,
where
magcore-app-tv
- is the package name.

Basic information about icons

Application icons are displayed in the main menu, task manager list, and while loading an application.

All icons are declared in package.json file of the application package.

The path to the icons by default regarding the contents of the package: /app/img/{0}/normal.png .

An example of the full path to the icons: /stalker_launcher_apps/magcore-app-tv/1.0.6/img/720/normal.png .

The icons have two modes: normal and active (icon in focus).

Icon sizes for different screen sizes

480

normal - 64x64, active - 96x96

576

normal - 80x80, active - 120x120

720

normal - 100x100, active - 150x150

1080

normal - 150x150, active - 225x225

Main Menu Branding

The list of branding elements in the main menu:

1. Logo.
2. Category list (a standard set of categories - Media, Apps, Games).

The launcher package is called magcore-app-launcher .

The launcher configuration file is located on the following directory: /stalker_launcher_apps/magcore-app-launcher/ current version /app/config.json .

To change the logo put in the directory  img/{0}/ file logo.png .

If the file name does not match, change the line img/{0}/logo.png with your file name in the configuration.
When you change the category list, the display of applications in the main menu is not guaranteed because of the possible disappearance of the whole set of the corresponding category. The list is contained in the field "categories". An example of a category:

{
   "name": "Media",
   "icons": "img/{0}/icons/media.png"
}

where
name
- the name of the category, which is used in the lower case for sorting applications for this category (the application of "media" type falls into this set).
icons
- template path to the application icon.

There are two ways of using your own configuration:

  1. In the options of the package, you set the path to the config file. The package options are specified in administrative panel Ministra.
  2. Replace the configuration file of launcher to your own.

Please note that if you have customized the launcher, you need to disable the auto-update. Otherwise, after the launcher update, you should repeat the configuration file replacement.

Icon Customization

Option 1

Replace the icons manually. The path to the icons described above.

Please note that if you have customized the icons, you need to disable the auto-update. Otherwise, after the application update, you should repeat the icons replacement.

Option 2

1. Add your own application with your own icons. To do this, in the standard application replace the icons with your own and publish under a different name.

2. Delete the standard application.

Need Help

Cindy is an expert on the Ministra TV platform and the author of this article.

Was this article helpful?

Yes No

Sorry to hear that.
How can we improve this article?

We use cookies in order to optimise our website, provide you with the best possible user experience and help us promote our products. Please read our Cookie Policy to find out how we use cookies and how you can control cookies.
By using this website or closing this message, you acknowledge our Privacy Policy and agree to our use of cookies as described in our Cookie Policy.