Provides the ability to watch tv-channel streams if you are a paying KabelDeutschland customer.
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

KabelDeutschland simple streaming proxy

As all of you KabelDeutschland customers know, there is an existing iOS App that provides full TV-channel streaming if your are a paying customer of both cable internet and tv. Unfortunatly there is no released Android nor Desktop version of this streaming possibility. KabelDeutschland kept us in the dark, if and when there will be such an option.

That's why i built this script to be able to watch all of the channels on my desktop and also with XBMC/KODI.

Beside this script, there is now an even simpler version. You can download the binary from my page This version was build with golang and handles all functions in a simple executable. Mainly the new version was designed for every-day user who do not want to setup their own web-server but simply start the proxy.

The version of the proxy, written in GO, is now also available as open-source on github/edi-design/kd-go.



  • KabelDeutschland Cable TV Package (the smallest one for 2,95€ is enough)
  • KabelDeutschland Internet via cable

The first package is needed because the KD backend ensure with your credentials that you are a paying customer. The cable internet contract is needed cause the final stream link is available only in their network. So you can't connect and watch from any other ip-address outside of the KD network.


  • webserver with php installed
    • php5_curl (`apt-get install php5-curl)


Just copy the content of this repository to your webserver and configure it with your credentials.


  • add your credentials instead of the placeholders. These credentials are the same you use to login into the kd customer-service-center.


Point your browser to your webserver for example http://localhost:8000/kd.php. That call provides you with the download of a playlist file. This m3u-file can opened with vlc and contains the redirect links.

You can also add the url http://localhost:8000/kd.php directly to VLC. This will resolve the playlist automatically.

Once imported into your VLC player, the scripts handle the generation of a licensed stream link and forwards the player automatically to this link.

There is a param named quality which can be low medium and high. This determines the stream bandwidth. Try http://localhost:8000/kd.php?quality=high for the highest quality. Medium is the default if no param was given.

This new version now works with Kodi / XBMC (PVR IPTV Plugin) and also the tv-stream-recorder for Synology based NAS-systems.

The first call of the script will take about a minute to generate the playlist. So please be patient. The next time it will be cached for 24 hours. To use the cache, you web-server needs to have write acces to the folder cache.

If you use the script on a Synology NAS the write access will be controlled with the Control-Panel -> Groups. The http group needs read/write access to the web folder.


There are three steps of debugging included. The simplest one is to call the script with format=txt to get a the textual output of the playlist. http://localhost:8000/kd.php?format=txt

The more detailed version works with log_level=debug and writes al lot of data to logs/*.log. http://localhost:8000/kd.php?format=txt&log_level=debug


  • UDID generation


To learn about how this script works, see