Tech Cape Town

Everything about technology from Cape Town

Development: SuperSport Kodi Add-on


Please do NOT contact me regarding this, I will not make it public no matter what you are willing to offer me. I appreciate the polite requests I have received for this, however recently I have been receiving many rude emails saying “How dare I not make this public.” I am astounded by some people’s stupidity and no, swearing at me will not make me suddenly hand this over to you. I made this as a proof of concept. That is all this will ever be. Thanks.

Original Post

The Plan: Make a nice wrapper for SuperSport’s online streaming for my Kodi Media Centre.

This is quite a difficult topic due to piracy. So I’ll start out by saying, I will NOT make this public. I do have login credentials to legally access SuperSport’s web streams. I DO NOT condone people using similar plugins for Plex or Kodi to bypass authentication.

Now that that is out of the way, lets have a look at what I managed to get done. This was never meant to be pretty, it was meant to be a proof of concept. This was my first Python Script and my first Kodi Add-on. As it turns out, it was a lot easier than I expected.

I used Paw to dig through a few “unofficial” API endpoints that SuperSport uses for streaming within their mobile apps. I then signed in and pulled an authentication token out to use for my add-on. Once I had all of that, I was ready to start building the add-on.

The first step was to replicate the HTTP GET request in Python and then parse the response. This was very easy with a minimal amount of googling. This I had to populate the user interface. I find the way Kodi does things to be a little bit difficult to wrap my head around. I’ve worked with the API before and it took me ages to get basic tasks working. A few basic tutorials later and I was up and running. Then all I had to do was mark the stream links as playable in Kodi and it was done.

This was a lot easier than I had ever imagined. It took me less than 2 hours from start to finish. I do however have a fair amount of experience from being a developer. I also managed to slim the code down to a mere 30 lines. (Including everything, even imports and spacing)

Screen Shot 2015-06-08 at 10.30.13Screen Shot 2015-06-08 at 10.30.30 Screen Shot 2015-06-08 at 10.30.45

I could modify this some more and make it look a bit nicer and add more actual information to the info displays. I doubt I will as I really don’t need this. As a proof of concept, this was a success.

I used a Mac for development, once done I zipped the add-on and managed to install it on Ubuntu 15.04. It worked flawlessly there too.


  1. plz can i get the supersport addon..i will really appreciate..

  2. how do you get this addon on

  3. where do you get this addon from

  4. please can you tell me where i can get this addon?

  5. Does the web stream auto adjust the streaming bitrate ? And what’s the highest resolution you’ve seen (imagine it’s around 720P?). Excellent work. Well done.

  6. Being a legitimate subscriber with the ability to stream, i would like to do this as well. I am a developer (of sorts) and would like to get access to your code or coding process if possible. Please note: I do not want access to YOUR stream, but to my own, but using your code…


  7. Is it necessary to build a plugin/addon? can’t you do the same if you properly compose a .strm file, using the parameter data that you’ve gathered using your method ?

  8. Guy if you can find it in your hear of hearts to email me pls 🙂

  9. Here’s another legitimate user crying for an app like this to be made available. If the login authentication is required (ie, only legitimate account holders can view) what’s the harm in sharing it?

    • The reason some people don’t release things is because when they do, the providers catch on and change things. It becomes cat and mouse and I personally believe the author wants to use this with his/her setup and it carry on working without extra programming. Fair play to him/her for figuring it out.

      Why not instead of whining and moping about try having a go at programming a script and see how easy/difficult it can be.

  10. Well done on your effort!

    I am trying to replicate your attempt. 30 lines of code is quite a little though. Can you give some more info on Supersports unofficial API. I’ve got mine pretty set up already. I just have a problem getting it to play with my authentication token.


    • Byron Tudhope

      19th October 2015 at 14:34

      Unfortunately, this isn’t repeatable any more. SuperSport has added encryption to their streams. All the information still pulls through but no video plays.

      • Once again, they keep changing the way they stream, every time someone figures out a way to get their streams running on Kodi they just go and make it even harder to do. I don’t see why DSTV themselves cannot just make a plugin for Kodi for people that legally own it. Supersport is literally the only reason why I still have DSTV.

  11. Im not going to ask you for the plugin.

    I am willing to go to DSTVs offices (down the road from me) and one man protest for them to allow your plugin to be official, and perhaps include their own DRM nonesense. I have a connect account.

    I also have a way of setting up an Ubuntu distro to allow chrome to be launched from Kodi, and then use Unified Remote to navigate the website. Its really ugly. But it works damn well.

    I have also (as an experiment) set up another Ubuntu box which opens and navigates the website for me (xdotool) and then streams the entire screen via OBS to an nginx instance running on my kodi box. The “launch ss1” script on the streamer box is initiated over ssh. The kodi box then opens up the OBS stream after a timer, and viola, SS in kodi itself, with authentication. When i stop the stream, another script is run and returns the streamer box to the home page. This also allows my little brother in law to watch the same stream, while we are actually only using BW for one stream.

    Anyway, enough blabbing. Well done man. One day i will have the skills necessary to do what you did.


    • Byron Tudhope

      20th November 2015 at 23:49

      Well they encrypted the streams so this no longer works. 🙁 I don’t blame them for not allowing/releasing something like this as it is simply too easy to bypass the security when you have access to the code. As Kodi add-ons are written in Python, no matter how they release the code, it can be reverse engineered.

    • Mark, I like your idea, not pretty but it works! Could you maybe please share your set up with me. My email:

      Thanks a lot

  12. How about creating an addon where you need to put your creds in? I have creds for the site but its a mission when i need to watch sports ect.

    You can even pitch to SS and try make it an official plex app?

  13. anonymouscoward

    20th May 2016 at 01:44

    excellent work, well done 🙂

  14. Is there no way you could put together a tutorial as to how to do this to use legitimate streaming credentials?

    The whole idea on my side is that I dont want to run cables to the other side of the house etc, or be bound by web browser… the end goal is Kodi on a Raspberry pi, using it to stream video which I can legitimately access…

    • Byron Tudhope

      7th September 2016 at 13:06

      The fact is that this post is now outdated. This method doesn’t work any more so even if I wanted to I couldn’t. The second issue is that if you saw the code, you would see how easy it is to bypass the authentication. And any tutorial that would work with authentication could also work without it.

      I understand what you are trying to achieve as I wanted something similar. I currently use an old iPad to AirPlay sport from the SuperSport App. Would be nice if they made an AppleTV app.

      As far as I’m concerned, Kodi is also outdated and the developers are stuck in their old ways. I’ve moved on to Plex and couldn’t be happier.

  15. Simplest non-technical way I have found is to stream screen capture at 30fps to an obs server from a windows PC then send that from there to the Kodi on a Pi.

Leave a Reply

Your email address will not be published.


© 2020 Tech Cape Town

Theme by Anders NorenUp ↑