Requirements for Basic SmartTUBE Apps Customization
The basic customization of SmartTUBE apps is carried out by SmartLabs.
For this purpose, please send us — at sales@smartlabs.tv or Support ticket — the information and image archives described below.
Please create simple, high-contrast images with recognizable shapes and minimal details for optimal visibility.
Note:
This information and materials are only necessary for the app branding. To publish apps to stores, additional images are required. Their specifications are sent on request.
Common Information
- Backend host
e.g. https://fe.lime.clients.some.tv/ - Operator name
- List of UI languages to support
- List of languages the content search to support
- Default app’s UI language
- Default Android UI language (only for languages supported by Android 9+)
Only for Android AOSP STB with firmware delivered by SmartLabs - Do you need a language selection page, when the user starts the application for the first time?
Only for Smart TV and STB devices - Default time zone
- Operator’s official website
- Operator’s Tech Support phone
- E-mail (optional)
- License agreement text (optional)
With localization for UI languages - Application Privacy Policy
See the example - HEX-color of the selector
Highlights UI elements with a background color on hover - STB firmware update URL prefix (optional):
-
- for Android AOSP STB with firmware delivered by SmartLabs: http://… (e.g. http://upgrade.some.tv/default-versions)
- for Linux-based STBs: http://… or multicast (norm://…)
- Applications packages repository (optional)
e.g. http://upgrade.some.tv/android-packages
Only for Android AOSP STBs
Apps for Smart TV
Please add all images to the ZIP archive using the specified paths below.
All Smart TVs
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Status Bar Logo (Screens left top corner) |
|
PNG Size Variations:
|
Transparent background |
|
Splash Screen Logo |
|
PNG Size Variations:
|
Transparent background |
Android TV
Requirements for the SmartTUBE Android TV app inherit all image requirements from the All Smart TVs section above.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Splash Screen Logo |
AndroidTV/splashScreenLogo.png |
PNG 550×181 px |
Transparent background |
|
App banner for the Applications rail |
|
PNG Size Variations:
|
Opaque background |
|
App icon for the Android system menus (in-app location) |
|
PNG Size Variations:
|
Opaque background |
App for Linux STB
Please add all images to the ZIP archive using the specified paths.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Status Bar Logo |
|
PNG Size Variations:
|
Transparent background |
|
Splash Screen Logo |
|
PNG Size Variations:
|
Transparent background |
|
System upgrade/startup splash screen |
|
PNG Size Variations:
|
Opaque background |
|
Bootloader for STBs Arris VIP1003/1903 and VIP1113 |
stbui/bootloaderArris.bmp |
Recommended format: BMPv3 with RLE 8-bit color (256 color palette, 32 MiB max) Size: 720×576 px (scaled from scale the initial 960×576 px) Aspect ratio: 16:9 sсaled to 4:3 (i.e. you need to scale the initial 960×576 px image to the 720×576 px one) Some image areas are reserved for animations (see the safe zone mockup) |
Transparent background |
App for Linux STB Using Web Browser
Requirements for the Linux STBs using web-based SmartTUBE App inherit all image requirements from the All Smart TVs section above.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
System upgrade/startup splash screen |
|
PNG The logo must be fitted in the white rectangle shown on examples below. Size Variations: |
Opaque background |
App for Android AOSP STB
Requirements for the Android AOSP STB with firmware delivered by SmartLabs inherit all image requirements from the All Smart TVs section above.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Splash Screen for Android AOSP STB with firmware delivered by SmartLabs |
AndroidAOSP/splashScreenForSmlAospStb.png |
BMP RGB565 and PNG 24bit 1920×1080 px |
Opaque background |
App for Web Browsers
Please add all images to the ZIP archive using the specified paths.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Favicon for the web portal (in-app location) |
web/favicon.ico |
PNG Size Variations:
|
Transparent background |
Apps for iOS/iPadOS (iPhone, iPad)
Use these units when creating images:
- px: Physical pixels (device-specific).
- pt: Resolution-independent points. Scaling depends on screen density:
- @1x: 1 pt = 1 px
- @2x (Retina): 1 pt = 2 px
- @3x (Super Retina): 1 pt = 3 px
Please add all images to the ZIP archive using the specified paths.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Splash Screen and Sign In screens Logo |
iOS/logoBig.imageset/logoBig.pdf |
Vector in PDF Tolerance zone size: 354×170 pt |
Transparent background The logo should be in contrast to the black background |
|
Status Bar Logo |
iOS/logo.imageset/logo.pdf |
Vector in PDF Tolerance zone size: 30×30 pt |
Transparent background The logo should be in contrast to the dark background |
|
Main App Icon (App Icon) |
iOS/AppIcon.appiconset/Icon-1024.png |
PNG 1024×1024 px |
Opaque background No rounded corners (iOS applies its own mask) See also the Apples requirements (App icon attributes paragraph) |
Apps for Android Mobile
Please add all images to the ZIP archive using the specified paths.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Splash Screen and Sign In screens Logo |
Android_Mobile/splashScreenLogo.png |
PNG 300×327 px |
Opaque background |
|
Main App Icon |
|
PNG Size Variations:
|
Opaque background |
|
Status Bar Logo (Screens left top corner) |
Android_Mobile/statusBarLogo.png |
PNG 63×60 px |
Transparent background |
In-App Loading Animation (optional)
Sprite animation is used to illustrate waiting states in the player, buttons and general waiting states. For this purpose, a sequential animation storyboard packed into a single image is used. Please, see the sample images here. Default animation speed — 18 frames per second.
|
Image purpose |
Filename & path |
Format & size |
Other requirements |
|
Loading animation for the player and general waiting states (in-app location) |
loader/general/fhd.png |
PNG 1944×108 px |
Transparent background 18 frames aline Frame size 108×108 |
|
loader/general/hd.png |
PNG 1296×72 px |
Transparent background 18 frames aline Frame size 72×72 |
|
|
loader/general/sd.png |
PNG 1044×58 px |
Transparent background 18 frames aline Frame size 58×58 |
|
|
Loading animation for buttons (in-app location) |
loader/buttons_normal/fhd.png |
PNG 972×54 px |
Transparent background 18 frames aline Frame size 54×54 |
|
loader/buttons_normal/hd.png |
PNG 666×37 px |
Transparent background 18 frames aline Frame size 37×37 |
|
|
loader/buttons_normal/sd.png |
PNG 360×20 px |
Transparent background 18 frames aline Frame size 20×20 |
|
|
Loading animation for selected buttons (in-app location) |
loader/buttons_inversed/fhd.png |
PNG 972×54 px |
Transparent background 18 frames aline Frame size 54×54 |
|
loader/buttons_inversed/hd.png |
PNG 666×37 px |
Transparent background 18 frames aline Frame size 37×37 |
|
|
loader/buttons_inversed/sd.png |
PNG 360×20 px |
Transparent background 18 frames aline Frame size 20×20 |
Android Boot Animation (optional)
You can customize the visual experience of the boot up process.
You should modify the reference bootanimation-default-500×300.zip file in order to customize the boot animation. Instructions below:
- Unzip bootanimation-default-500×300.zip
- Add new top level folders
These folders represent sections of the boot animation. Each folder has a series of PNGs arranged alphabetically.
- The first line of desc.txt represents the animation width and height in pixels followed by the frames per second:
Example: 1080 720 60.
Be mindful of these numbers — they are specific for each animation. Changing the numbers may create unpredictable visual effects.
- Edit the following lines of the desc.txt file. Keep in mind, each of the bolded characters represent different sections of the boot animation.
Example: c 1 0 part1
The first letter (in the example above, “c”) is always “c” or “p”. “c” means the boot animation will play to completion, no matter what. “p” means the boot animation will play unless interrupted by the end of the boot.
The first number (in the example above, “1”) indicates how many times the animation will play — this must always be greater than zero for any partner-added folders. Only one animation can be marked as “0”, and that animation will play on an infinite loop.
The second number (in the example above, “0”) indicates the amount of frames to delay after the animation section ends. This is usually set to “0”.
The final argument (in the example above, “part1”) is the name of the folder inside the zip file.
- Re-zip the file
Be careful not to compress the files when doing this — using the zip as a concatenation method is recommended: zip ../bootanimation-default-500×300.zip * -0 -r
- Send the resulting zip file to SmartLabs representatives via SmartLabs issue tracking system.
Change Log
18.04.2025
- Update on image requirements for SmartTUBE Apps for various platforms without changes to animation requirements.