Instrumenting HbbTV / Freeview Play apps

Suitest can automatically instrument HbbTV / Freeview Play applications or, if necessary, you can make changes manually. At this point you should have a working HbbTV / Freeview Play device in your Suitest account.


Your HbbTV / Freeview Play app needs to be hosted on an URL for this to work. Broadcast-only HbbTV applications are not currently supported.

Automatic instrumentation with Suitestify

Suitestify is a proxy able to automatically insert the Suitest instrumentation library into your application or website. With Suitestify you do not need to make any physical changes to your app.

To use Suitestify for instrumentation, select the Use Suitestify to inject the library automatically option, then specify all domain names from which your app is getting its resources. Please note that the app's URL needs to be publicly accessible for Suitestify to work.

Use Suitestify - specify domains of resources needed
Use Suitestify - specify domains of resources needed

Save the configuration and try running your app on a device. If everything went well, you should see your app start. On top of your app you should see the Suitest badge.

Suitest badge with *Connected* status when app is running
Suitest badge with Connected status when app is running

In rare cases if your app starts but appears to be broken, you will need to configure a few more things.

Manual instrumentation

You should only fallback to manual instrumentation if you are sure that Suitestify is not suitable for your type of project.

Copy and paste the code snippet from the Suitest configuration page into every HTML file of your application. For best results put it as the first script element in your HTML file right after the opening <head> tag.

Inserting Suitest instrumentation library for HTML apps
Inserting Suitest instrumentation library for HTML apps

For apps hosted on HTTPS replace http with https in the code snippet above.

When inserting the library you must make sure, that you don't accidentally release the app to production with Suitest code in it. Suitest code is intended for testing and could damage the user experience of your app's users.