View on GitHub


A simple command line to stream media to kodi (aka xbmc)

Download this project as a .zip file Download this project as a tar.gz file

What is it ?

IDOK (kodi reversed name) is a Go program that allows to serve medias to your Kodi plateform (raspbmc, xbmc...)

You may be able to send video, images and music from your computer.

Idok has got two modes:


Install distribution

Linux users can use the auto-install:

bash <(wget -qO -)

Or with curl:

bash <(curl -L

Check that ~/.local/bin is in your PATH. Then try to call:

idok -h

If you want to get yourself the packed file for Linux, FreeBSD, MacOSX and Windows, here are the urls:

(I need help for Mac because I don't have one and cannot be sure of how to install the command at the right path...)

Windows users may know that there is no graphical interface for the idok tool. Maybe one day...

If you have troubles, please fill an issue. But keep in mind that I don't have any Windows or Mac OSX installation.

Stream medias

Youtube URL

Open a youtube url is simple

idok -target=YOUR_KODI_IP ""

This will ask XBMC/Kodi to open this video. This doesn't stream video from your computer, so that's not use port opening and/or ssh tunnel.

Note: you must enable youtube addon on your kodi/XBMC installation.

distant medias

You can open http, rtsp, mms, rtpm... media. That doesn't make usage of ssh or local port. Kodi will connect itself to the stream:

idok -target=YOUR_KODI_IP scheme://url

Where "scheme://url" can be "rtpm://...", "http://...", etc...

For example, to open "Tears of Steel" movie:

idok -target=YOUR_KODI_IP

Open Jamendo rock radio (creative commons musics):

idok -target=YOUR_KODI_IP

Stream your local media through HTTP (default)

To open a media that resides on your computer:

idok -target=IP_OF_KODI_OR_XBMC /path/to/media.mp3

That command open port 8080 (http-alt) to stream media. If you want to use another port:

idok -port=1234 -target=IP_OF_KODI_OR_XBMC /path/to/media.mp3


This solution needs to open port on your firewall.

You must be sure that the port is opened. On Linux, to open firewall port on you linux installation:

firewall-cmd --add-port=8080/tcp

When you will reload firewall, or restart computer, the port will be closed. If you want to keep that port opened:

firewall-cmd --add-port=8080/tcp --permanent

Stream your local media throught SSH Tunnel

Idok can stream media through ssh tunnel. That way, you don't need to configure firewall.

idok -ssh -target=IP_OF_RASPBERRY /path/to/media.mp3

Your kodi should open the file.

Pressing CTRL+C should stop media stream and exit program.


With SSH, idok tries to use your ssh key pair to authenticate. If it fails, it will use login/password to auth. So, there are 2 possibilities:

To copy you key, type this command:

ssh-copy-id USER@KODI_HOST

Where USER is the ssh kodi user ("pi" on raspbmc, "root" for openelec) and KODI_HOST is ip or hotname of the kodi host. By default, raspbmc use "raspberry" as password, "password" for openelec.

Now, should should be able to stream media without the need of password.

Some other streams you can make

The -stdin option is a cool new functionnality that "ianux" (an user on DLFP pages) asked me... I took this feature as a challenge ;) And it works !

Since Idok can now use this option, I discovered that I'm able to make a lot of nice stream to my Kodi installation.

Gstreamer - screencast to kodi

Gstreamer can be used to stream medias to stdout using "fdsink" or "filesink location=/dev/stdout".

If you're using operating system that can be able to launch gstreamer pipelines, here is a nice "screencast stream":

gst-launch-1.0 -q ximagesrc remote=1 ! videoconvert  ! avenc_mpeg4 ! mpegtsmux ! filesink location=/dev/stdout | idok -stdin -ssh -target=YOUR_KODI_IP

Remove "remote=1" on "non fedora 20", this option is needed as far as I know on Fedora 20 (reported bug)

livestreamer - ISS station from space from ustream

Livestreamer is a python tool that is able to fectch streams from some servers and is able to give an url. For some streams, it's impossible to get URL, but we can use "-O" option that dump stream to stdout. So...

livestreamer 480p -Q -O | idok -stdin -ssh -target=YOUR_KODI_IP

That will launch the ISS live video from space (sometimes the image is black because ISS station is on the night side. Wait 5 minutes and you will see...)

Install from source

WARNING - Because there is a problem with dropbear ssh server on raspbmc, you should patch go.crypto/ssh package with the patched I made. See:

You can clone repository and compile source code yourself:

git clone
cd idok
go build idok.go

Then you can put binary in your PATH:

mkdir -p ~/.local/bin
cp idok ~/.local/bin


There are other options that may be usefull: