; Create the folder "Jumpy > my scripts > testing > hello" on the xmb
; containing an action labeled 'click me' which will run the command
; 'echo hello' when the user clicks on it.
[my scripts/testing/hello]
cmd = pms addCmd "click me" "echo hello"

; Run the command 'echo "foo"' at startup
; (note the '+' which means 'execute at startup').
[+foo]
cmd = echo "foo"

; Run the command 'echo "bar"' at shutdown
; (note the '-' which means 'execute at shutdown').
[-bar]
cmd = echo "bar"

[+flipflop]
cmd = pms addPlayer flipflop "ffmpeg -y -i '${filename}' -vf 'vflip,hflip' -target ntsc-dvd ${outfile}" "f:mpg|vob m:video/mpeg"

import jumpy

pms.addFolder("Hello", "echo hello")

• unix shell:
$pms addFolder Hello "echo hello"

• Windows batch file:
%pms% addFolder Hello "echo hello"

• perl:
`$ENV{'pms'} addFolder Hello "echo hello"`

• unix shell:
ffmpeg=$($pms getProperty ffmpeg.path)

• Windows batch file:
for /f "delims=" %%i in ('%pms% getProperty ffmpeg.path') do set ffmpeg=%%i

• perl:
my $ffmpeg = `$ENV{'pms'} getProperty ffmpeg.path`

• Windows batch file:
%pms% addFolder Hello "[echo , hello world]"

The script is identified as a startup [+] item in jumpy-scripts.ini with a startup command defined by you

[+webreader]
cmd = "${home}/webreader/webreader.py" init

which generates an initial call where the script registers itself as a player by calling pms.addPlayer() to define what formats it accepts and what command to issue for playback. For instance

# create the player
pms.addPlayer(
	name = 'webreader',
	cmd = [sys.argv[0], '${filename}', '${outfile}', '${format}:${userdata}'],
	supported = 'f:webpage|rdb|readability m:video/mpeg',
	mediatype = PMS_VIDEO,
	purpose = PMS_MISC_PLAYER,
	desc = 'Browse snapshots of your webpages.',
	playback = '-1' if len(sys.argv) < 3 else sys.argv[2])

here the playback command cmd is a callback to the same script with runtime variables as arguments, and will produce calls such as

webreader.py http://nytimes.com/ /tmp/ps3mediaserver/1346412874907webreader webpage:

and supported declares that video/mpeg is the mimetype to be broadcast for items matching the formats webpage|rdb|readability. Although supported can include valid formats understood by PMS too, note that these three happen to be psuedo-formats meaningful only to the player itself, and represent custom items that are added to the xmb by calls to pms.addMedia() elsewhere in this or other scripts, e.g.
pms.addMedia('NYT Front Page', 'webpage', 'http://nytimes.com/')

Default icons for the new formats are declared next. Here two predefined icons are being used, but they could be image files too:
pms.setIcon('webpage', '#globe') pms.setIcon('readability|rdb', '#page')

This phase is entirely up to you, the only requirement being that a media stream eventually be written to the designated ${outfile}. For instance given the example above webreader.py ends up doing something like

convert ... | ffmpeg -y ... /tmp/ps3mediaserver/1346412874907webreader

In Windows the ${outfile} names are somewhat shell and escape unfriendly and may end up being mangled. As a workaround the environment variable %OUTFILE% (or $OUTFILE in unix) is also always set to this filename and the more robust method is to retrieve it there directly.

py, sh, pl, rb, php, groovy, vbs, js

python, sh, perl, ruby, php, groovy, (windows:cscript), (windows:cscript mac:jsc unix:rhino)

perl.path = /usr/local/lib/perl-5.10.1/bin/perl

script.filetypes = py,vbs,js,pl
pl.interpreter = perl
perl.path = /usr/local/lib/perl-5.10.1/bin/perl

perl foo.pl arg1 arg2

foo.pl arg1 arg2

pms.addAction('greetings', 'echo Hello', '#smile')

#frown	#smile+f=gold;s	#wink+t=79,79_30; c=160x160+30+30;s;3

pms.vmsg(msg='Not all those who wander are lost.',
	img='c:\bag-end\bilbo.png+v;s',
	background='SpringGreen', imggrav='west')

jumpstart xbmc.py

jumpstart c:\somewhere\myscript.bat

[#+hello.bat]
cmd = ${home}/examples/hello.bat

jumpstart c:\path\to\hello.bat

• jumpy/xbmc.py
• jumpy/webreader/webreader.py
• jumpy/examples/httpserver.py

import sys, os, jumpy

# initial call:
if len(sys.argv) == 1:
	# add some folders
	pms.addFolder('Examples/python/Hello', [sys.argv[0], 'hello'])
	pms.addFolder('Examples/python/Version', [sys.argv[0], 'jumpy version'])
	# set the environment variable $foo
	pms.setEnv('foo', 'This is a test')
	# and add an action to retrieve it later
	pms.addFolder('Examples/python/Test Env', [sys.argv[0], 'env'])
	# add an action to display the output of a command
	pms.addConsoleCmd('Examples/python/Date', 'date')
	# add an action to start a background process
	# note also the custom icon and message
	if sys.platform.startswith('win32'):
		cmd = 'cmd /c start "jumpy async example" netstat 10'
	else:
		cmd = 'xterm -title "jumpy async example" -e netstat -c &'
	pms.addCmd('Examples/python/netstat', cmd, \
		'#two-way', 'netstat console launched on computer')

# callbacks:
elif sys.argv[1] == 'hello':
	# add a video item
	pms.addVideo('World', 'world.mpg')
elif sys.argv[1] == 'jumpy version':
	# add an action specifying an api command in array notation syntax
	# to stream jumpy's version as a video message
	pms.addAction('show', ['pms', 'info', 'Jumpy version %s' % pms.version()])
elif sys.argv[1] == 'env':
	# stream a video message showing the value of '$foo'
	pms.info("foo = '%s'" % os.getenv('foo'))

#!/bin/sh

case "$1" in
	# initial call:
	("")
		# add some folders (note the embedded quotes: '$0')
		$pms addFolder Examples/sh/Hello "'$0' hello"
		# add a folder using array notation syntax
		# instead of embedded quotes
		$pms addFolder Examples/sh/Version "[$0 , jumpy version]"
		# set the environment variable '$foo'
		$pms setEnv foo "This is a test"
		# and add an action to retrieve it later
		$pms addAction "Examples/sh/Test Env Var" "'$0' env"
		# add an action to display the output of a command
		$pms addConsoleCmd Examples/sh/Date date
		# add an action to start a background process (note the final '&')
		# note also the custom icon and message
		$pms addCmd "Examples/sh/netstat" \
			"xterm -title 'jumpy async example' -e netstat -c &" \
			"#two-way" "netstat console launched on computer"
		;;

	# callbacks:
	(hello)
		# add a video item
		$pms addVideo World world.mpg ;;
	("jumpy version")
		# add an action specifying an api command in array notation syntax
		# to stream jumpy's version as a video message
		$pms addAction show "[pms , info , Jumpy version $($pms version)]" ;;
	(env)
		# stream a video message showing the value of '$foo'
		$pms info "foo = '$foo'" ;;
esac

#!/usr/bin/perl

our $pms = $ENV{"pms"};

# initial call:
if (not @ARGV) {
	# add a folder (note the embedded quotes: '$0')
	`$pms addFolder Examples/perl/Hello "'$0' hello"`;
	# add a folder using array notation syntax
	# instead of embedded quotes
	`$pms addFolder Examples/perl/Version "[$0 , jumpy version]"`;
	# set the environment variable $foo
	`$pms setEnv foo "This is a test"`;
	# and add an action to retrieve it later
	`$pms addAction "Examples/perl/Test Env Var" "'$0' env"`;
	# add an action to display the output of a command
	`$pms addFolder Examples/perl/Date "'$0' date"`;
	# add an action to start a background process
	# note also the custom icon and message
	my $cmd = ($^O eq 'MSWin32' ?
		"cmd /c start \"jumpy async example\" netstat 10" :
		"xterm -title 'jumpy async example' -e netstat -c &");
	`$pms addCmd "Examples/perl/netstat" "$cmd" "#two-way" "netstat console launched on computer"`
}

# callbacks:
elsif ($ARGV[0] eq 'hello') {
	# add a video item
	`$pms addVideo World world.mpg`;
}
elsif ($ARGV[0] eq 'jumpy version') {
	# get jumpy's version
	my $ver = `$pms version`;
	# and add an action specifying an api command in
	# array notation syntax to stream it as a video message
	`$pms addAction show "[pms , info , Jumpy version $ver]"`;
}
elsif ($ARGV[0] eq 'env') {
	# stream a video message showing the value of '$foo'
	`$pms info "foo = '$ENV{'foo'}'"`;
}

@echo off
setlocal ENABLEDELAYEDEXPANSION

:: initial call:
if "%~1" == "" (
	:: add a folder (note the embedded quotes: ""%~0"")
	%pms% addFolder Examples/bat/Hello """%~0"" hello"
	:: add a folder using array notation syntax instead of embedded quotes
	%pms% addFolder Examples/bat/Version "[%~0 , jumpy version]"
	:: set the environment variable 'foo'
	%pms% setEnv foo "This is a test"
	:: and add an action to retrieve it later
	%pms% addAction "Examples/bat/Test Env Var" """%~0"" env"
	:: add an action to display the output of a command
	%pms% addConsoleCmd "Examples/bat/Date" "date"
	:: add an action to start a background process
	:: note also the custom icon and message
	%pms% addCmd "Examples/bat/netstat" ^
		"cmd /c start ""jumpy async example"" netstat 10" ^
		"#two-way" "netstat console launched on computer"
	exit
)

:: callbacks:
if "%~1" == "hello" (
	:: add a video item
	%pms% addVideo World world.mpg

) else if "%~1" == "jumpy version" (
	:: get jumpy's version
	for /f "delims=" %%i in ('%pms% version') do set ver=%%i
	:: and add an action specifying an api command in
	:: array notation syntax to stream it as a video message
	%pms% addAction show "[pms , info , Jumpy version !ver!]"

) else if "%~1" == "env" (
	:: stream a video message showing the value of 'foo'
	%pms% info "foo = '%foo%'"
)