Windows version

Just download the Octoshape Plug-in executable from the Octoshape website [ here ] and install it. A new protocol (octoshape:XXX.yyy) will be handled by your web browser. To start watching a p2p tv channel, just click on a link or type the URI address in the browser address bar.

Linux version

The installation process for Linux systems is a bit more complicated, but not too hard. Just follow the instructions below:

1. Download the .bin file from the Octoshape website [ here ]
2. Change permissions for the .bin file, using the Linux command:

   chmod u+x octosetup-linux_i386.bin

3. Execute ./octosetup-linux_i386.bin , accept the conditions and answer "yes"
4. Move to the newly created octoshape directory and edit the text file called setup.xml
5. Write the path of the file libjvm.so, which can be found in your system's java directory, and (optionally) the multimedia player you intend to use. Example of the content of setup.cfg:

   <e JavaExec="/usr/lib/jre-1_5_0_08/lib/i386/client/libjvm.so"
   PlayerExec="kmplayer $url" />
   

Now you can launch the Octoshape plugin from command line, from the octoshape diretory:

./OctoshapeClient -url:octoshape:BROADCASTER.channel

(e.g.: ./OctoshapeClient -url:octoshape:ESC08.low)

On the next page I'll show you how to associate the Octoshape protocol with your web browser (in Linux it's not automatic, as in Windows), in order to launch p2p tv station directly from a web page or the address bar

In order to handle correctly the Octoshape protocol you'll need to write a bash script using a text editor, let's call it octo:

#!/bin/sh
exec /home/XXXXX/octoshape/OctoshapeClient -url:"$@"

Change the script according to the location of the OctoshapeClient program in your filesystem. If you have root privileges you can put the script into the /usr/bin directory and give it execution privieges, using chmod 755 octo

Mozilla Firefox

1. type about:config in the address bar
2. right-click on your mouse and select: new string
3. enter the value: network.protocol-handler.app.octoshape and press OK
4. enter the value: octo, or the complete path where you put the script

Opera

1. From the menu, select Preferences - Advanced - Programs
2. add a new protocol, call it octoshape
3. enter the path where you put the script (e.g. octo, if it's in the /usr/bin directory or /home/XXXX/octo)

Now you can watch all the Octoshape channels directly from your web browser, with no need to open a terminal window