Dev. FAQ

This list provides helps and where possible solutions for problems that a developer may encounter.

Problems:

• Streams language names displayed with wrong/incomplete descriptions on Kodi OSD settings

Errors:

• HTTP error 403
• License request - HTTP error 400

Streams language names displayed with wrong/incomplete descriptions on Kodi OSD settings

Most video services usually provide streams with language code in ISO 639-1 format, well accepted in Kodi (example es Spanish). But nowadays a new standard is being adopted the IETF BCP 47, which provides subtags (like region code) for example es-ES for Spanish-Spain, but this new format is not supported in Kodi, leading to some problems.

All Kodi versions until v19 (Matrix) are affected by the worst problem and will results in wrong display of language names, for example:

• es-ES will be displayed on Kodi OSD settings as Spanish-Spanish
• pt-BR will be displayed on Kodi OSD settings as Portuguese-Breton
• and so on...

but the situation has been improved a bit from Kodi v20 (Nexus), see below.

Solutions for Kodi v19 and older

For these Kodi versions, the only workaround is to use a proxy to intercept the manifest and rename the language codes of each audio/subtitle stream, so you have to set a custom subtag to something that does not exist, for example:

• es-ES renamed to es-Spain will be displayed as Spanish-Spain
• pt-BR renamed to pt-Brazil will be displayed as Portuguese-Brazil
• and so on...

as you can see the final result is that the custom subtags are kept as is, but still there will always be problems with the Kodi language selection done by Kodi when playback starts.

Solutions for Kodi v20 and newer

From this Kodi version has been improved the support for language code with subtags, then unrecognized language codes are displayed in Kodi GUI menus as is without descriptions, for example:

• es-ES will be displayed as Spanish-es
• pt-BR will be displayed as Portuguese-br
• and so on...

therefore no manifest alterations are required, but if the final user want a better language descriptions and selection when playback starts, must perform one of these operations:

• Install skin language packs of each language code you need (if are available)
• Provide to Kodi the missing language code with description by using Advancedsettings.xml. Read Kodi Wiki to know how to do https://kodi.wiki/view/Advancedsettings.xml#languagecodes

HTTP error 403

We know two common reasons that can lead to an HTTP error 403:

Server protected by Cloudflare

You can recognise this type of protection by analysing HTTP requests/responses which should contain the word Cloudflare. This anti-bot protection does not allow us to download files, there is currently no known solution.

Verified Media Path (VMP) CDM protection

There is currently no known solution. For more info see Verified Media Path (VMP) page.

License request - HTTP error 400

We suggest you to verify the headers set to the inputstream.adaptive.license_key parameter, may be missing or URL encoded in an incorrect way.