OTT Navigator

OTT Navigator FAQ

What is OTT Navigator?

OTT Navigator is a video player dedicated to work with streamed and vod content, usually provided by OTT/IPTV providers

Which IPTV service should I use, or which is used by the app?

The app is just a player and neither has any content, nor can provide you any. In order to use it, you need having an IPTV provider and configuring it within the app.

How can I contribute to the app development?


Installation

How to install

How to install on my Windows PC/Mac

There is no special version dedicated to be used on Windows PC or Mac, however, there is a solution to use the app with negligible side effects. Install NoxPlayer app on your PC - it allows running Android apps and is highly optimized and recommended. Just use it like it was a native app.Some users are running the app on different emulators, like BlueStacks emulator and report that it also works quite well, and supports later Android versions.
Please note, that hardware acceleration might not be available when using emulator, so you might need selecting software codecs to watch your content.

Will the app work on my TV? Why not WebOS/Tizen?

The app only works on Android, so if your TV is running Android TV / Google TV then it will run perfectly. We have investigated the tech and even did some proof-of-concept, but WebOS/Tizen are simply not powerful enough to make a really good app. It’s suitable for simple web pages that pretend to be apps, but lack real power to do complex under-the-hood tasks. So if you choose an LG/Samsung TV (the only 2 major vendors that do not use Android these days) - then it’s highly recommended to purchase an Android / AndroidTV / GoogleTV / Chromecast(2021+ model) / FireTV / etc box or stick to be attached, to make it really smart (not pretending to be one).


Provider (playlist) configuration

Which provider template should I choose?

What playlist formats are supported

Playlist setup

Your options are one of the following (it’s always preferred to use links over files):

Getting IP blocked by provider (or 403 error)

These issues might be caused by different provider paranoid flood settings/connection restrictions that can affect access to service. Here are some recommendations if you experience such a problem:

EPG setup

You can check whatever EPG is provided and alive from your IPTV provider by navigating to Settings - EPG - Reload, and watching the status of reload process (looking for the number of sources processed, each sources processing result).

If your provider has an EPG source but for some reason does not specify it in playlist, then it’s recommended to configure it in Settings - Provider - (your provider) - Parameters - EPG. This way the channels mapping will be searched by both channel names and tvg-id fields. If you configure EPG source in Settings - EPG - User-provided then matching by name is only used.

Want easier way to input characters on my Android TV device (from Phone)

Some of the control apps recommended to serve as a secondary output to your TV/box:

Fail to connect to the portal, however it works well in the other app


General issues

Part of the screen is being cut by my TV (fighting against overscan)

Some TVs are coming with overscan enabled in their configuration (especially for HDMI ports). Possible solutions (better to worse sorted):

Want to stream video from phone to my TV, how to do it?

App supports 2 ways of sending a stream to a TV (when both are located in the same WiFi network). Both are not very reliable and cannot be used if your provider requires some DRM tags or specific attributes being passed in addition to the stream url. The options are:

Having multiple providers, how to manage channels?

The app has many options on how to manage channels from multiple providers.
One the best that suits most use cases (when you need max channels from all providers and do not want to mess on them is):

Note, that the app sorts providers alphabetically and applies a list of channels from these providers in the order, providers are. So if you have sorting mode by provider being set, naming a provider alphabetically before others will cause their channels be higher in the list.

Also quite popular is the quick provider switch option that adds a button on the main screen to enable/disable filters by a single/multiple provider you are currently interested in.

Other, less popular, but still valuable options are to disable category merging between different providers, so “Sports” from provider A will not be merged with “Sports” from provider B, creating different categories instead. Also you can enable showing provider name in the channel name (either as a prefix or as a suffix of a channel)

My list of channels messed up when I added a new provider

Providers are sorted and applied alphabetically. So if you had a provider named BBB in the app and made modifications to the groups, channels, etc, and then added a provider named AAA then some of the modifications will apply to the new provider AAA, since the provider list (as being sorted alphabetically) is now AAA, BBB.
To preserve your metadata, ensure that new providers are AFTER the current ones. For example, you can add a prefix to the provider name like 1 BBB, and 2 AAA so alphabetically they will be 1 BBB, 2 AAA and channels/categories from the second provider will not be used for modifications made for the first one.

Time is shown incorrectly on EPG, how to fix that?

Almost always when you see incorrect time it’s incorrect device setting (selected incorrect timezone), so go to the device settings and setup the time and time zone that correctly matches your region.

If this does not help, here are some options available to you to make a virtual time shift:

After any of these changes you need to do manual EPG reload (settings - epg - reload) in order to apply the changes.

How to protect some content from other users (parental control)

There are multiple ways to achive this

Want to use Studio mode (up to 9 videos at the same time) or Picture-in-Picture, but cannot find how to enable them

Studio and PiP mode requires you either having multiple providers, or having a provider that allows more than a single connection at the same time. App tries to detect number of connections via provider API, but sometimes might not be able to detect it correctly. To set a number of connections your provider allows manually:

After changing, your will have studio mode option available on the main screen, as well as PiP menu option available from a playback menu screen if these modules are not been disabled. To enable if you previously disabled:

I want to use my own background wallpaper image

You can use any image service you like, here is a quick sample to get idea how to get link to the image:


Playback

Buffering way too much

There might be multiple reasons for buffering - starting from poor Internet connection to some firmware specifics. Here comes a list of actions that usually helps if the cause is hardware/firmware, rather than the network issues:

If the solutions above did not resolve your issue, then it’s definitely a connectivity issue to your IPTV provider. You should contact him to fix the issue. You can also try setting buffer size to maximum.

Problems with video/audio playback

Since the streams of your provider can be different, your hardware used for playback has different capabilities and your device firmware has bugs, there is no best configuration. App comes with hardware decoders, software decoders, and support for external player, defaulting to software codecs in most cases as being less dependent on firmware bugs.

Please try using these settings in the suggested order and test which works best for you:

App remembers which codec was previously selected for channel and will reuse it in the future (unless disable this in settings)

Horizontal scrolling text is unreadable

When app is using hardware codecs it has no control whatever deinterlacing will happen or not - it’s fully dependant on your device firmware. In order to insist on deinterlacing you should switch the channel to use software codecs that uses one of 3 different deinterlacing algorithms depending on what software codecs quality is selected.

Audio track selection / Subtitles enabling

Sometimes hardware codecs are unable to detect different audio tracks availability (especially in some incorrect HLS streams) and may not support subtitles. In this scenario you can use player menu to switch to software codecs, so you will be able to select a different audio and subtitles track.

Trying PiP / Studio Mode, but app says that connections limit reached

App tries to detect the number of connections your provider allows to protect you against ban by your provider. Some providers do not allow the detector to work so app defaults to a single connection in that case. You can override auto-detected connections limit yourself.
Go to Settings - Provider - (select your provider) - Parameters - Number of connections. Bear in mind, that you still can use multiple screens (PiP / Studio) using 1-connection providers, if you have a couple of them, since each provider is counted separately.

Hostname … not verified / Chain validation failed / SSL error when trying to playback

This error means that your provider is using invalid SSL certificates (either self-signed or without a trusted root). Your solution might be:

The app does not see all audio tracks

This usually means that your provider incorrectly encodes the stream (quite common when the provider is using HLS but actually sending all tracks in the same file while they should be split to different ones).

Best option would be to ask the provider to give instructions how to setup one of the following:

When it’s not possible, you can also try one of the following:

Playing DRM content and it’s not playing

In order to play DRM-protected contents you need to pass the correct DRM keys and extra data in the playlist. Check the M3U playlist structure on clues how to setup it.
Please note, that DRM playback is only supported using hardware codecs - so using software VLC, system or external player has no way to pass these license data.

Experiencing ENOENT (FileNotFoundException) while trying to play a channel

It is a provider issue meaning that master playlist for the stream contains a link for one of the tracks in invalid format - instead of providing full url to the file with the domain, path, etc, it just only gives the path that is considered a local (like /videos/12345/segment12345.mpg) - of course, there is no such file on your current device.


Premium

How many devices does Premium allow

Premium will be active on all your devices that, as long, as they:

For non-Google devices, please check FAQ.
PS: Sometimes Play Store takes a while to sync purchases. Check FAQ how to speed up the process.
PPS: Fair use policy is insisted, using same Google Account and using it on tons of devices are a clear violation.

Enable premium on a Firestick (or other device without play market)

Recommended solution:

Purchased a premium but it’s not active

Sometimes it takes a while for Play Store to sync purchases (due to long caching). Steps to guarantee that sync will happen instantly:

Unable to process purchase (Error DF-PDP-3)

Recently Play Market stopped processing purchases when the app was not installed from it. Install application from play market and payment should work.

Premium and multiple accounts on a single device

Play Market: When the device has several Google accounts, then it might switch between accounts by Google services itself, meaning that in-app purchases / subscriptions might be taken from one or other account with almost no user control. Best way to reactivate all purchases to correct account:

Will the premium purchase work for Family Library?

No, family library only apply to paid apps. Free apps with in-app purchases are not eligible for this. You can still use the app on several devices that share the same account.

Currently subscribed to premium, willing to purchase via single payment forever

The app protects users from purchasing premium while he has active subscriptions (since it might lead to a person having both subscription and purchase), so you should cancel your subscription (it will continue working for the rest of subscribed period). And after some time an option to buy the app using a single payment will become available.


Partnership / Reseller

Branded app with customizations

If interested in whitelabel package (custom logo, background, providers, etc), then contact us via email ottnav.partners@gmail.com or reach us on Telegram (contact @FlavusV)

Preparing devices for other users and wish to hide provider details

You can configure the app and then hide provider details.


Technical staff (playlist edit)


M3U Playlist file sample (brief info on supported tags)

#EXTM3U

Playlist header, marks playlist start
Supported attributes:

#EXTINF:0 tag1="value1" tag2="value2"...,Channel name

Channel declaration. Supported attributes:

#EXTGRP: Sports - alias for group-title tag

#EXTVLCOPT:parameter="value" Allows setting some custom parameters for the current channel:

#KODIPROP:parameter=value Allows setting some custom parameters for the current channel. Supported parameter are:

The app also accepts extra stream headers configured after | character in license_key (v1.6.4.1+)

A basic M3U file format sample

#EXTM3U url-tvg="http://example.com/epg.xml.gz"
#EXTINF:-1 group-title="Music", Music 1
http://example.com/channel/01
#EXTINF:-1 group-title="Sports", Sports News
http://example.com/channel/02

Media library file (json)

App supports multiple formats for media library, but preferred format is json:

Inner structure of the item (“info” field of movie/series/season/episodes)

Outer structure of the json file

So resulting file would be something like: [ {item1}, {item2}, {item3}, {item4} ]

where items are described in previous section, and can include also an info field described in the first section


More information

Changelog

Changes are published on Telegram or on web

Availability

Contacts