#Git clone or paste above into a blank file, name it iplayer, save it to your home dir, make it executable
#in terminal cd to your home dir and run some commands, like so ... 

./iplayer --update
./iplayer --refresh --type=all
./iplayer --refresh-exclude="cbeebies,cbbc" --type=tv --refresh
#searching
./iplayer football
./iplayer motd
./iplayer crime
./iplayer sport
./iplayer --channel="BBC One" --category=News
./iplayer --channel="BBC One" --category=Crime
./iplayer --channel="BBC One" --category=Scotland
./iplayer --channel="BBC Two" --category=Crime
./iplayer --list=categories --type=tv
./iplayer --info ****
#downloading
./iplayer --get ***
./iplayer --pid b002a23a   #edit to suit, pid can be found using browsers url bar
./iplayer --stream *** --player="mplayer -cache 3072 -"
./iplayer --stream 123 | mplayer -cache 3072 -
#live tv
./iplayer --stream --type=livetv --pid="p00db24v" | mplayer -cache 512 -   #bbc2
./iplayer --stream --type=livetv "BBC Two" --player="mplayer -cache 512 -"
./iplayer --stream --type=livetv "BBC One" --player="mplayer -cache 512 -"
./iplayer --stream --type=livetv "BBC Three" --player="mplayer -cache 512 -"
./iplayer --stream --type=tv "http://www.bbc.co.uk/iplayer/playlive/bbc_two"
  --player="mplayer -cache 512 -"
./iplayer --stream --type=tv --pid="bbc_two" | mplayer -cache 512 -
#stream+download together
./iplayer --stdout --get *** | mplayer -cache 3072 -
#using proxy
./iplayer --proxy=http://[username:password@]<server>:<port>
#show prefs
./iplayer --prefs-show
./iplayer --prefs-clear
#subtitles
./iplayer --subsonly --get ***
#preset
./iplayer --preset=my_preset Crime
./iplayer -z my_preset Crime