Archive:Web Server HTTP API and Archive:Team Kodi/Members: Difference between pages

From Official Kodi Wiki
(Difference between pages)
Jump to navigation Jump to search
>Nad
 
>Phi2039
 
Line 1: Line 1:
==HTTPAPI DOC==
__NOTOC__
 
{| border=0 cellspacing=0 cellpadding=5 style="width:100%"
This document provides information on XBMC’s Application Programming Interface (API). The API operates over the HyperText Transfer Protocol and hence is called the HTTPAPI.
| style="background: #ffffff;" |
 
The same set of commands is also available over ASP and from Python (see later section).
 
Apart from where indicated by a date indicating when a command was added/modified this documentation describes what's available in XBMC 2.0.0.
 
===Getting started===
 
The XBMC HTTP API provides a mechanism for a networked device (e.g. a PC or a PDA with WiFi) to interact with XBMC. The API provides access to XBMC status information and control of XBMC functions.
 
The API can be called from and results displayed in a standard web browser which is probably the easiest way to experiment with these commands. Fire up your browser and enter the following into the address field:
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=getcurrentlyplaying
</nowiki></pre>
 
Information about the media currently being played by XBMC will be displayed, if nothing is being played then "[Nothing Playing]" will be displayed.
 
If you want to control the volume of XBMC enter the following into your browser’s address field:
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=setvolume&parameter=80
</nowiki></pre>
 
"OK" will be displayed and the volume will be set to 80% which you will probably find is rather quiet.
 
If you find that the above commands don’t work then check that:
 
* The address "xbox" is understood by your browser to point to your Xbox’s address. You may need to enter the full IP address e.g. 192.168.0.1
* The XBMC web server has been turned on. This setting can be found in Settings, Network, Server.
* You didn’t mistype the command.
 
 
Note: If you are a Windows user, you can configure a name for your Xbox's IP address.
Edit with your favorite text editor the file “hosts” inside C:\WINDOWS\system32\drivers\etc\ and add a line at the end with your xbox ip address.
 
<pre><nowiki>
192.168.0.1 xbox
</nowiki></pre>
 
Save it (don't need to restart) and test if the command “ping xbox” works. You should now resolve your Xbox IP address
 
If you still can’t get them working, try:
 
<pre><nowiki>
http://xbox
</nowiki></pre>
 
This should display the default XBMC web page. If this does not work then check out other XBMC documentation on the web server and come back when it is working.
 
Once you have the above working we can look at the structure of the http command line.
 
All API commands start with the following:
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=
</nowiki></pre>
 
(Remember you may need to swap “xbox” for the IP address.)
 
The next part of the line is the command itself, which in the two examples above are "getCurrentlyPlaying" and "setVolume". The command is not case sensitive: "SetVolume", "setvolume" and "SETVOLUME" can also be used.
 
If the command takes parameters then "&parameter=" is added after the command.
 
Finally comes the parameter values. If there are multiple parameters then each value is separated by a semi-colon ";". The following is an example of a command with 4 parameters.
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=takescreenshot&parameter=test.jpg;300;200;90
</nowiki></pre>
 
To pass a semi-colon as a parameter (rather than a seperator) use two semi-colons ";;".
 
To pass an empty paramter insert a space between the semi-colons "; ;".
 
To pass an empty parameter as the last (right most) parameter use "%20" (if just a space is appended to the end, the browser will remove it and xbmc will not detect the final parameter).
 
As of 18th Nov 2006 a more usual function calling syntax is also available. Instead of using the "&parameter" syntax to specify parameters the parameters can be enclosed within brackets. Note that the parameters must still be separated by semic-colons. The above example takescreenshot command would be presented in the new syntax as:
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=takescreenshot(test.jpg;300;200;90)
</nowiki></pre>
 
The rest of this document uses the original "&parameter" syntax which of course is still supported.
 
===Response Structure===
 
The API returns information in a consistent form but which is dependent on the type of information returned. Those commands which:
 
* don’t return a value e.g. SetVolume return the standard response OK
* return a single value e.g. GetVolume return just the value
* return multiple values e.g. GetCurrentlyPlaying return multiple lines with each line having the format
** name:value
 
An error in the execution of a command, for example a missing parameter, is indicated by the response:
 
<pre><nowiki>
Error[:Reason]
</nowiki></pre>
 
i.e. all errors are indicated by returning "Error" and depending on the error there may be additional information provided.
 
e.g.
<pre><nowiki>
Error:Missing parameter
</nowiki></pre>
 
The following is the default response format. To change the format see the command SetResponseFormat.
 
Every line in the response is prefixed by the HTML tag <nowiki><li></nowiki>. The only exception to this is the GetThumb command where a prefix is not included. The use of this prefix means that the responses are displayed clearly within a browser but the <nowiki><li></nowiki> tag does not require a corresponding close tag i.e. <nowiki></li></nowiki> is not required.
 
Finally, and to create a valid HTML response, the whole response is top and tailed with the web server’s default header and footer.
 
 
===Sample Code===
 
Probably the easiest way to get up to speed with a new API is to have a look at code. Several of the applications that can be found here: [http://sourceforge.net/project/showfiles.php?group_id=87054&package_id=198866 HTTPAPI client apps] come with source code. In particular look for the file XBMCHttpInterface.vb which wraps up the majority of the HTTP API within a .Net class. The file can be found within the package XBMCControl. There are also examples that show how to call the HTTP API from an Excel spreadsheet and from Visual Basic 6.
 
==ASP==
 
The commands are also available as ASP commands using the command "xbmcAPI" just as the current "xbmcCommand" works now (see default.asp in the XBMC web directory). All xbmcAPI commands have an identical name and the same parameters as the commands listed in the document. The response structure is also identical apart from the web server’s default header and footer which will not be present.
 
e.g.
<pre><nowiki>
Response = xbmcAPI("GetCurrentlyPlaying");
</nowiki></pre>
 
 
==Python==
 
The commands are also callable from Python scripts through the function executehttpapi imported from the xbmc module. All xbmcAPI commands have an identical name and the same parameters as the commands listed in the document. The response structure is also identical apart from the web server’s default header and footer which will not be present.
 
e.g.
 
<pre><nowiki>
import xbmc
 
response = xbmc.executehttpapi("TakeScreenShot(q:\\test.jpg,0,false,200,-1,90)")
</nowiki></pre>
 
==Broadcast==
 
Added 18th Nov 2006
 
The Broadcast functionality is not strictly speaking part of the HttpApi in that it does not use the HTTP protocol. However, it is controlled via HttpApi commands and would typically be used as an adjunct to the HttpApi and so is presented here.
 
The HttpApi is a “pull” architecture – HttpApi interacts with XBMC by making calls to XBMC. For an HttpApi client to maintain a dynamic up-to-date display, e.g. of the currently playing song, the client needs to continually poll XBMC for its status.
 
The Broadcast facility provides the opposite approach – XBMC makes calls out (i.e. broadcasts or "pushes") indicating significant events to anything that just happens to be listening.
 
The Broadcast facility uses the UDP broadcast protocol with a default port setting of 8278. (8278 was chosen for no other reason than it was the first unregistered port that I stumbled across.) For a client to receive these broadcasts, the client must register to receive the broadcasts (the method of doing so will depend on the language/technology of the client). XBMC broadcasts on the IP address 255.255.255.255 which is the limited broadcast address. Sending a UDP datagram to this address delivers the message to any host on that broadcast network. Because routers never forward messages sent to this address, only hosts on the connected network see these broadcasts, i.e. the client will need to be on the local network to receive the broadcasts.
 
The actual broadcasts are delimited by <nowiki><b></b></nowiki> and may consist of a numerical or textual description of the event (depening on the event) followed by ";" and the level of the event (e.g. 1 or 2).
 
An example Windows client (with source code), XBMC Listener, that listens to these broadcasts can be found [http://sourceforge.net/project/showfiles.php?group_id=87054&package_id=198866 here]
 
==The Commands==
 
This section presents a complete list of HTTP API commands. In the list, after the command name is presented, the text between the parentheses is the list of semi-colon separated parameters for the command.
 
Remember to use the syntax:
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=setvolume&parameter=80
</nowiki></pre>
 
and not
 
<pre><nowiki>
http://xbox/xbmcCmds/xbmcHttp?command=setvolume(80)
</nowiki></pre>
 
 
A parameter in square brackets is optional. An optional parameter typically specifies an alternative to a default value.
 
In the following list the Playlist parameter identifies one of the four available playlists by using the values 0..3:
 
<pre><nowiki>
0. Music playlist
1. Temporary music playlist
2. Video playlist
3. Temporary video playlist
</nowiki></pre>
 
As of 26 Nov 2006 the available playlists and identifiers have changed to:
 
<pre><nowiki>
0. Music playlist
1. Video playlist
</nowiki></pre>
 
 
These playlists should not be confused with:
 
The slideshow playlist. The slideshow commands implicitly refer to the latter.
Playlist files e.g m3u files.
 
 
The commands are presented in five sections. Those commands that:
 
* retrieve information
* set/modify information
* perform/initiate an action
* perform an action on a file
* don’t fit into one of the above and hence are miscellaneous
* HTTPAPI commands and examples
 
 
Assuming you have XBMC running and configured appropriately, clicking on the example link should load the link in your browser window. Then edit the link (if necessary): changing ''xbox'' to your Xbox IP (e.g. 192.168.1.101). As an example:
http://xbox/xbmcCmds/xbmcHttp?command=GetCurrentlyPlaying -> http://192.168.1.101/xbmcCmds/xbmcHttp?command=GetCurrentlyPlaying
 
However, the most straightforward approach is to add xbox to your hosts file as described in the Getting Started section, after which you would not need to substiture your Xbox IP for ''xbox''.
 
Some of the examples will work straight off, others, which for example refer to a specific file, will need you to manually modify the link to appropriate values for your environment.
 
'%20' is used in some of the examples which is just an alternative way of indicating a space (' '). The reason for using %20 is just to ensure that the document formatting keeps the entire http:// string as one object. If you are typing the command in manually or using it from your own code then you can either use %20 or a space.
 
 
===Retrieving information commands===
 
<center>
<center>
{| border="1" cellpadding="5"
===List of people officially involved with XBMC development, (likely incomplete, so give us a nudge if we forgot you)===
!width="10%"|Command
'''(PLEASE DON'T E-MAIL OR PM ANYONE DIRECTLY ABOUT SUPPORT! INSTEAD USE THE [[XBMC:Community Portal|COMMUNITY FORUM]] OR [[XBMC:Community Portal|IRC-CHANNELS]]!)'''
!width="60%"|Information
!width="30%"|Example
|-
| GetMediaLocation(type; [path]; [option])
| ''Type'' is one of music, video, pictures, files.
 
''path'' is the path.
 
''option'' is one of pathsonly, showdate
| http://xbox/xbmcCmds/xbmcHttp?command=GetMediaLocation&parameter=files;f:\;pathsonly
|-
| GetShares(type; [option])
|  ''Type'' is one of music, video, pictures, files.
 
''option'' is one of pathsonly, appendone
| http://xbox/xbmcCmds/xbmcHttp?command=GetShares&parameter=music
|-
| GetCurrentPlaylist
| Retrieves the current playlist identifier.
| http://xbox/xbmcCmds/xbmcHttp?command=GetCurrentPlaylist
|-
| GetCurrentlyPlaying
| Retrieves the filename, details and status of the currently playing media.
| http://xbox/xbmcCmds/xbmcHttp?command=GetCurrentlyPlaying
|-
| GetCurrentSlide
| Retrieves the file name of the image currently being displayed.
| http://xbox/xbmcCmds/xbmcHttp?command=GetCurrentSlide
|-
| GetDirectory(directory;[mask];[option])
| Retrieves the contents of the directory specified by directory. If the option parameter = 1 then file modified dates will be appended. The mask parameter can take the following form: .mp3 returns just the matching files "*" return just folders all files and folders.
| http://xbox/xbmcCmds/xbmcHttp?command=GetDirectory&parameter=F:\music\;.mp3;1
|-
| GetGuiDescription
| Retrieves various GUI values. (Currently just the screen resolution)
| http://xbox/xbmcCmds/xbmcHttp?command=GetGUIDescription
|-
| GetGuiSetting(type; name)
| Retrieves the value of GUI setting name. ''type'' specifies whether the setting is of type integer (0), boolean (1) or float (2) which must be set correctly or could cause a crash. ''name'' is the name of the setting to get the value of. For a list of setting names see GUISettings.cpp.
| http://xbox/xbmcCmds/xbmcHttp?command=getguisetting&parameter=0;system.shutdowntime
|-  
| GetPercentage
| Retrieves the current playing position of the currently playing media as a percentage of the media’s length.
| http://xbox/xbmcCmds/xbmcHttp?command=getpercentage
|-
| GetPlaylistContents([playlist])
| Retrieves the contents (file names) of the current playlist or the playlist specified by ''playlist''. Playlist takes one of the following values: 0 – Music playlist, 1 – Temporary music playlist, 2 – Video playlist, 3 – Temporary video playlist. (Since 26 Nov 2006: 0 - Music playlist, 1 - Video playlist)
| http://xbox/xbmcCmds/xbmcHttp?command=GetPlaylistContents&parameter=1
|-
| GetPlaylistLength([playlist])
| Retrieves the length of the current playlist or the playlist specified by ''playlist''. [Added 27 Feb 07.]
| http://xbox/xbmcCmds/xbmcHttp?command=GetPlaylistLength&parameter=0
|-
| GetPlaylistSong([position])
| Retrieves the currently playing song number in the playlist. If the optional parameter ''position'' is provided the command will return the file name of the media at location ''position'' in the playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=GetPlaylistSong
|-
| GetPlaySpeed
| Retrieves the current playing speed.
| http://xbox/xbmcCmds/xbmcHttp?command=GetPlaySpeed
|-
| GetMusicLabel(item)
| Retrieves audio information relating to the currently playing media. The specific information to retrieve is specied by ''info'' which is an integer corresponding to one of the MUSICPLAYER_* constants that can be found in GUIInfoManager.h The example retrieves the codec currently being used. [Added  4 Nov 07.]
| http://xbox/xbmcCmds/xbmcHttp?command=GetMusicLabel&parameter=217
|-
| GetVideoLabel(item)
| Retrieves video information relating to the currently playing media. The specific information to retrieve is specied by ''info'' which is an integer corresponding to one of the VIDEOPLAYER_* constants that can be found in GUIInfoManager.h The example retrieves the rating of the video currently being played. [Added  4 Nov 07.]
| http://xbox/xbmcCmds/xbmcHttp?command=GetVideoLabel&parameter=270
|-
| GetSlideshowContents
| Retrieves the contents (file names) of the slideshow playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=GetSlideshowContents
|-
| GetSystemInfo(InfoIds)
| Retrives System Information by id number(the information on the system info page in xbmc). You can supply multipal numbers if you wish to retreive a bunch at a time. This sample will get Version of XBMC & Build Date. For a full list of Id's see GUIInfoManager.h.
| http://xbox/xbmcCmds/xbmcHttp?command=GetSystemInfo&parameter=120;121
|-
| GetSystemInfoByName(InfoNames)
| Retrives System Information by name (the information on the system info page in xbmc). You can supply multipal names if you wish to retreive a bunch at a time. Go down to the "CGUIInfoManager::TranslateSingleString" section in GUIInfoManager.cpp and you will find all the InfoNames values
| http://xbox/xbmcCmds/xbmcHttp?command=GetSystemInfoByName&parameter=weather.location;weather.temperature
|-
| GetTagFromFilename(filename)
| Retrieves information for the audio file ''filename''
| http://xbox/xbmcCmds/xbmcHttp?command=GetTagFromFilename&parameter=F:\music\test.mp3
|-
| GetThumbFilename(album;location)
| Retrieves the file name of the corresponding thumbnail for the music media file with file name ''album'' and path ''location''
| http://xbox/xbmcCmds/xbmcHttp?command=GetThumbFilename&parameter=test.mp3;F:\music\
|-
| GetVolume
| Retrieves the current volume setting as a percentage of the maximum possible value.
| http://xbox/xbmcCmds/xbmcHttp?command=GetVolume
|-
| QueryMusicDatabase
| [Added 22 Oct 06] Provides a SQL interface to the XBMC Music Database. While this command is described in this section (Retrieving Information) it is possible to use it to modify the data base.
WARNING: The commands that modify the data base can obviously damage and/or lose information within it; but also some of the read commands can be so complex or retrieve so much data that it can impact the operation of XBMC e.g. retrieving all songs from a reasonably large data base can bring xbmc to its knees.
| http://xbox/xbmcCmds/xbmcHttp?command=querymusicdatabase&parameter=select%20strArtist%20from%20artist%20order%20by%20strArtist
 
http://xbox/xbmcCmds/xbmcHttp?command=querymusicdatabase&parameter=select%20*%20from%20artist%20where%20strArtist%20LIKE%20'%%the%%'
|-
| QueryVideoDatabase
| [Added 23 Feb 07] Provides a SQL interface to the XBMC Video Database. See QueryMusicDatabase for further information.
| http://xbox/xbmcCmds/xbmcHttp?command=queryvideodatabase&parameter=select%20path.strpath%20from%20path
 
|}
</center>
</center>
===Setting commands===
{| border=1 cellspacing=0 cellpadding=5
| <strong>Command</strong>
| <strong>Information</strong>
| <strong>Example</strong>
|-
| AddToPlayList(media;[playlist];[mask])
| Adds a file or folder (media is either a file or a folder) to the current playlist or the playlist specified by ''playlist''. To specify a file mask use ''mask'' e.g. *.mp3.
| http://xbox/xbmcCmds/xbmcHttp?command=AddToPlayList&parameter=F:/music/test2.mp3;1 
|-
| AddToSlideshow(media)
| Adds a file or folder (media is either a file or a folder) to the slideshow ''playlist''. 
| http://xbox/xbmcCmds/xbmcHttp?command=AddToSlideshow&parameter=F:\apps\xbmc\media\ 
|-
| ClearPlayList([playlist])
| Clears the current playlist or the playlist specified by ''playlist''. 
| http://xbox/xbmcCmds/xbmcHttp?command=ClearPlayList&parameter=1 
|-
| ClearSlideshow
| Clears the slideshow playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=ClearSlideshow 
|-
| RemoveFromPlaylist(filename,[playlist])
| Removes the file filename from the current playlist or from playlist ''playlist''. 
| http://xbox/xbmcCmds/xbmcHttp?command=RemoveFromPlaylist&parameter=f:\test2.mp3,1
|-
| SeekPercentage
| Sets the playing position of the currently playing media as a percentage of the media’s length. 
| http://xbox/xbmcCmds/xbmcHttp?command=SeekPercentage&parameter=50 
|-
| SeekPercentageRelative
| Adds/Subtracts the current percentage on to the current postion in the song 
| http://xbox/xbmcCmds/xbmcHttp?command=SeekPercentageRelative&parameter=-10 
|-
| SetCurrentPlaylist(playlist)
| Sets the current playlist to ''playlist''. 
| http://xbox/xbmcCmds/xbmcHttp?command=SetCurrentPlaylist&parameter=1 
|-
| SetGUISetting(type; name; value)
| Sets the value of GUI setting name to value. ''Type'' specifies whether the setting is of type integer (0), boolean (1) or float (2) which must be set correctly or could cause a crash. For a full list of setting names see GUISettings.cpp.
| http://xbox/xbmcCmds/xbmcHttp?command=SetGUISetting&parameter=0;system.shutdowntime;10
|-
| SetPlaylistSong(position)
| Sets the media at playlist position ''position'' to be the next item to be played. The example sets the position to the 6th song in the playlist
| http://xbox/xbmcCmds/xbmcHttp?command=SetPlaylistSong&parameter=5 
|-
| SetPlaySpeed(speed)
| Sets the playing speed to the integer ''speed''.
| http://xbox/xbmcCmds/xbmcHttp?command=SetPlaySpeed&parameter(speed) 
|-
| SlideshowSelect(filename)
| Sets the slideshow playlist position by specifying the file name of the next image to show. 
| http://xbox/xbmcCmds/xbmcHttp?command=SlideshowSelect&parameter=filename
|-
| SetVolume
| Sets the volume as a percentage of the maximum possible. 
| http://xbox/xbmcCmds/xbmcHttp?command=SetVolume&parameter=50 
|-
| SetAutoGetPictureThumbs
| If set to True then media thumbnails will be automatically created when required. (Default: True.)
| http://xbox/xbmcCmds/xbmcHttp?command=SetAutoGetPictureThumbs&parameter=false 
|}
===Action commands===
{| border=1 cellspacing=0 cellpadding=5
| <strong>Command</strong>
| <strong>Information</strong>
| <strong>Example</strong>
|-
| Action
| Sends a raw Action ID (see key.h) to xbmc. Be careful with this one since it runs the action on the webserver thread and depending on the action could lock the GUI thread. The example sends ACTION_MOVE_DOWN. [Added 19th June 2007]
| http://xbox/xbmcCmds/xbmcHttp?command=Action&parameter=4
|-
| Exit
| Reboots to dashboard
| http://xbox/xbmcCmds/xbmcHttp?command=Exit 
|-
| Move(deltaX, deltaY)
| Moves the currently displayed and ZOOMed (see zoom command below) image by the distance specified by deltaX and deltaY. The zoom magnification must be greater than 0 or the command has no effect.
| http://xbox/xbmcCmds/xbmcHttp?command=Move&parameter=50;20 
|-
| PlayListNext
| Starts playing the next media in the current playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlayListNext 
|-
| PlayListPrev
| Starts playing the previous media in the current playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlayListPrev 
|-
| PlayNext
| Starts playing/showing the next media/image in the current playlist or, if currently showing a slidshow, the slideshow playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlayNext 
|-
| PlayPrev
| Starts playing/showing the previous media/image in the current playlist or, if currently showing a slidshow, the slideshow playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlayPrev 
|-
| PlaySlideshow([directory];[recursive])
| Starts the slideshow. Directory specifies a folder of images to add to the slideshow playlist. If recursive has a value of True then all directories beneath ''directory'' are searched for images and added to the slideshow playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlaySlideshow&parameter=F:\pictures;true 
|-
| PlayFile(filename)
| Starts playing the media file ''filename'' on the current playlist.
| http://xbox/xbmcCmds/xbmcHttp?command=PlayFile&parameter=F:\music\test.mp3
|-
| Reset
| Resets XBMC
| http://xbox/xbmcCmds/xbmcHttp?command=Reset 
|-
| Restart
| Restarts XBOX
| http://xbox/xbmcCmds/xbmcHttp?command=Restart 
|-
| Rotate
| Rotates the currently displayed image by 90 degree clockwise.
| http://xbox/xbmcCmds/xbmcHttp?command=Rotate 
|-
| SendKey(buttoncode;[LeftTrigger];[RightTrigger];[LeftThumbX];[LeftThumbY] ;[RightThumbX];[RightThumbY])
| Initiates a button, key or mouse event. Buttoncode specifies the type of event and the other parameters specify additional information that is specific to each buttoncode value. See key.h for the the list of keycodes. The example raises the A button event.
* To send a button event just set buttoncode to the appropriate value from Key.h
* To send a keyboard event set buttoncode to F100 (hex) and add the required key’s ASCII value.
* (Experimental) To send a mouse event set buttoncode to EFFF (hex) , then set the following parameters:
** LeftThumbX – mouse x position
** LeftThumbY – mouse y position
** LeftTrigger – indicates a single mouse click and takes a value of one of 1-left button, 2-right button, 3-middle button.
** RightTrigger– indicates a double mouse click and takes a value of one of 1-left button, 2-right button, 3-middle button.
| http://xbox/xbmcCmds/xbmcHttp?command=SendKey&parameter=256 
|-
| ShowPicture(filename)
| Displays the image ''filename''.
| http://xbox/xbmcCmds/xbmcHttp?command=ShowPicture&parameter=F:\apps\xbmc\media\splash.png 
|-
| Shutdown
| Shutdown XBOX
| http://xbox/xbmcCmds/xbmcHttp?command=Shutdown 
|-
| TakeScreenshot([filename];[flash];[rotation];[width];[height];[quality];[download];[imgtag]) 
| Captures the current contents of the Xbox screen.
If no parameters then the action is the same as initiating a regular screenshot command with the image being saved in the screenshot directory.
If filename is provided then the image is saved to ''filename''.
If flash=True the screen will flash as the command executes.
If resolution, width, height and quality are given then those values are used to define the rotation (in degrees), resolution and jpeg quality of the saved image.
If download = True then the image is downloaded to the client as a base64 encoded stream.
The command must conform to one of:
No parameters
Filename, flash, rotation, width, height, quality
Filename, flash, rotation, width, height, quality, download
Filename, flash, rotation, width, height, quality, download, imgtag
NEW: imgtag is new it will put a Convert Base64 to image tag with the Base64 code so in firefox browsers it will show the image instead of the Base64 code.
| http://xbox/xbmcCmds/xbmcHttp?command=takescreenshot&parameter=test.jpg;true;0;300;200;90;true;imgtag 
|-
| Zoom(magnification)
| Zooms the currently displayed image to a level specified by magnifaction. A magnification of 0 is the standard zoom level of none. Magnification can take values up to 8. 
| http://xbox/xbmcCmds/xbmcHttp?command=Zoom&parameter=4 
|}
|}
{| border=0 cellspacing=0 cellpadding=5 style="width:100%"
| valign="top" style="background: #ffffff;"|


===File Commands===
==Active Members==
 
{| border=1 cellspacing=0 cellpadding=5
| <strong>Command</strong>
| <strong>Information</strong>
| <strong>Example</strong>
|-
| FileCopy(sourceFilename, destinationFilename)
| Copies the Xbox file ''sourceFilename'' to the Xbox file ''desitinationFilename''. 
| http://xbox/xbmcCmds/xbmcHttp?command=FileCopy&parameter=F:\apps\xbmc\media\splash.png;E:\pictures\ 
|-
| FileDelete(filename)
| Deletes the Xbox file ''filename''.
| http://xbox/xbmcCmds/xbmcHttp?command=FileDelete&parameter=F:\pictures\kim-smith-1024x768–22677.jpg 
|-
| FileDownload(filename)
| Download a file specified by ''filename'' from the Xbox to the client as a base64 stream. 
| http://xbox/xbmcCmds/xbmcHttp?command=FileDownload&parameter=F:\apps\xbmc\default.xbe 
|-
| FileDownloadFromInternet(URL;[filename])
| Downloads the file with address ''URL'' to the client as a base64 encoded stream. If the filename parameter is present, the downloaded file is also saved on the Xbox as the file ''filename''. 
| http://xbox/xbmcCmds/xbmcHttp?command=FileDownloadFromInternet&parameter=http://wallpapers.skins.be/kim-smith/kim-smith-1024x768–22677.jpg;F:\pictures\kim-smith-1024x768–22677.jpg <br>
To test quickly: http://xbox/xbmcCmds/xbmcHttp?command=ShowPicture&parameter=F:\pictures\kim-smith-1024x768–22677.jpg 
|-
| FileExists(filename)
| Returns True if the Xbox file ''filename'' exists otherwise returns False. 
| http://xbox/xbmcCmds/xbmcHttp?command=FileExists&parameter=F:\pictures\kim-smith-1024x768–22677.jpg 
|-
| FileSize(filename)
| Returns the file size of ''filename''.
| http://xbox/xbmcCmds/xbmcHttp?command=FileSize&parameter=F:\pictures\kim-smith-1024x768–22677.jpg 
|-
| FileUpload(filename, contents)
| Uploads a file encoded as a base64 string ''contents'' to the file ''filename'' on the Xbox. The example creates on the xbox the file f:\test.txt with the contents ''hello''.
| http://xbox/xbmcCmds/xbmcHttp?command=fileUpload&parameter=f:\test.txt;aGVsbG8%3d
|}
 
===Miscellaneous commands===
 
{| border=1 cellspacing=0 cellpadding=5
| <strong>Command</strong>
| <strong>Information</strong>
| <strong>Example</strong>
|- 
| ChooseAlbum(URL)
| Retrieves the cover image and review text of the album with URL ''URL'' as returned by the LookupAlbum command. The URL must be encoded using the standard %xx format([http://www.rfc-editor.org/rfc/rfc1738.txt RFC1738]) before being passed to the API. The example here is passing the URL http://www.allmusic.com/cg/amg.dll?p=amg&sql=10:7vz1z87a6yvn
| http://xbox/xbmcCmds/xbmcHttp?command=choosealbum&parameter=http%3a%2f%2fwww%2eallmusic%2ecom%2fcg%2famg%2edll%3fp%3damg%26sql%3d10%3a7r6cmpea9f8o 
|-
| Config(command; parameters)
| Provides access to the ASP configuration commands. ''command'' is the ASP command and ''parameters'' is a semi-colon separated list of parameters to accompany the command. ''command'' is one of bookmarksize, getbookmark, addbookmark, savebookmark, removebookmark. For further information see: XBMCConfiguration.cpp. Note that the WebServer must be running to use this command. [Since 10 Nov 2007 the WebServer does not need to be running]
| http://xbox/xbmcCmds/xbmcHttp?command=Config(bookmarksize;20)
 
http://xbox/xbmcCmds/xbmcHttp?command=Config(getbookmark;music;name;1)
 
http://xbox/xbmcCmds/xbmcHttp?command=Config(getbookmark;music;path;1) 
 
|-
| ExecBuiltIn(function)
| Executes the XBMC ‘built-in’ function ''function''. For the list of available functions see: [[List_of_Built_In_Functions]] OR ExecBuiltIn Functions
| http://xbox/xbmcCmds/xbmcHttp?command=ExecBuiltIn&parameter=Notification(WARNING,SHUTTING%20DOWN%20SYSTEM!) 
|-
| Help
| Displays a list of some (NOT ALL) of the HTTPApi commands
| http://xbox/xbmcCmds/xbmcHttp?command=Help 
|-
| LookupAlbum(album[;artist;boolRelevance])
| [the form with the optional parameters added 11 Aug 07]
Looks up the album with name ''album'' on an Internet music site and returns the resulting matches as a list with the format: album_name<@@>album_URL
 
If boolRelevance has a value of ''1'' a relevance score (ranging from 1 (perfect) to 0) will also be returned with the following format: album_name<@@>album_URL<@@@>score
 
When requesting releveance scores it is best to include a value for the artist but it is not necessary.
| http://xbox/xbmcCmds/xbmcHttp?command=lookupalbum&parameter=On%20an%20Island
http://xbox/xbmcCmds/xbmcHttp?command=lookupalbum&parameter=On%20an%20Island;david%20gilmour;1
|-
|SetResponseFormat(format; value) 
|Sets the format of the response from HTTPApi. Format takes one of the following:
 
WebHeader – if True then the default web server header will be prepended to the response (ignored for Python and ASP responses).
 
WebFooter – if True then the default web server footer will be appended (ignored for Python and ASP responses).


Header – A user definable string that will be added after the WebHeader (if present) and before the main body of the response.
==XBMC Foundation Voting Board Members and Non-Voting Officers==
*[[User:Jmarshall|Jmarshall]] - Board Member (President)
*[[User:Yuvalt|Yuvalt]] - Board Member (Secretary)
*[[User:elupus|elupus]] - Board Member
*[[User:Pike|Pike]] - Board Member
*[[User:Spiff|Spiff]] - Board Member
*[[User:theuni|theuni]] - Board Officer (Business Relations Manager)
*[[User:malloc|malloc]] - Board Officer (Treasurer)


Footer – A user definable string that will be before after the WebFooter (if present) and after the main body of the response.
==Project Managers==
*[[User:Pike|Pike]] - The Bossman
*[[User:theuni|theuni]] - Business Relation Manager
*[[User:Natethomas|Natethomas]] - Community Manager


OpenTag – A user definable string that will be inserted before each element of the main response.
==Liason==
*[[User:theuni|theuni]] - All Around PR Stunts


CloseTag – A user definable string that will be inserted after each element of the main response. Whether to insert this tag after the final element is defined by the CloseFinalTag setting.
==Developers (General)==
*[[User:AlTheKiller|AlTheKiller]] - Fixer of broken things, build system
*[[User:amet|amet]] - python
*[[User:Anssi|Anssi]]
*[[User:Arnova|Arnova]] - General Developer
*[[User:bobo1on1|bobo1on1]] - Video Playback, General Bugfixes
*[[User:Chadoe|Chadoe]] - last.fm, general bug fixes
*[[User:dushmaniac|dushmaniac]] - PVR, EPG
*[[User:dteirney|dteirney]] - MythTV Integration
*[[User:elupus|elupus]] - XBMC video player (DVDPlayer) god
*[[User:firnsy|firnsy]] - Database
*[[User:Fneufneu|Fneufneu]] - BSD Developer
*[[User:freezy|freezy]] - Android Remote Developer
*[[User:garbear|garbear]]
*[[User:jfcarroll|jfcarroll]] - swig integration, binary addon developer
*[[User:Jmarshall|Jmarshall]] - Jedi-Master
*[[User:Malard|Malard]] - Web
*[[User:Memphiz|Memphiz]] - vfs, zeroconf and general stuff
*[[User:Montellese|Montellese]] - JSONRPC
*[[User:phi2039|phi2039]] - Audio, Assembly, and anything that sounds like it might be challenging...
*[[User:pieh|pieh]] - General code tinkering
*[[User:Spiff|Spiff]] - Will chop your head off!, think twice before you speak ;-)
*[[User:Topfs2|Topfs2]] - JSONRPC, ARM, power, storage, dbus
*[[User:the_alien|the_alien]] - Android Remote Developer
*[[User:VDRfan|VDRfan]] - General


CloseFinalTag – if True then the final element will have a closing tag.
==Developers (Linux)==
*[[User:AlTheKiller|AlTheKiller]]
*[[User:Anssi|Anssi]]
*[[User:bobo1on1|bobo1on1]]
*[[User:ceros|ceros]] - debian, etc.
*[[User:davilla|davilla]]
*[[User:dushmaniac|dushmaniac]]
*[[User:Erhnam|Erhnam]] - XBMCFreak creater, Live Distro developer
*[[User:firnsy|firnsy]]
*[[User:l.capriotti|l.capriotti]] - LiveUSB Distro
*[[User:malloc|malloc]]
*[[User:monkeyman 67156|monkeyman 67156]]
*[[User:Phaeodaria|Phaeodaria]]
*[[User:Spiff|Spiff]]
*[[User:sraue|sraue]] - OpenELEC.tv Developer
*[[User:Topfs2|Topfs2]]
*[[User:VDRfan|VDRfan]]


==Developers (Mac and iOS)==
*[[User:amet|amet]] - tester and limited coding
*[[User:Beenje|Beenje]] - PowerPC (PPC) specialist
*[[User:davilla|davilla]]
*[[User:gimli|gimli]]
*[[User:Jmarshall|Jmarshall]]
*[[User:Memphiz|Memphiz]] - dark side padawan


The default format values are:
==Developers (Windows)==
*[[User:a11599|a11599]] - primarily windows video and dxva
*[[User:blinkseb|blinkseb]]
*[[User:bobo1on1|bobo1on1]]
*[[User:Chadoe|Chadoe]]
*[[User:CrystalP|CrystalP]]
*[[User:jhsrennie|jhsrennie]]
*[[User:Jmarshall|Jmarshall]]
*[[User:tiben20|tiben20]] - butcher by day, coder by night
*[[User:WiSo|WiSo]]


WebHeader=True
==Developers (ARM)==
*[[User:davilla|davilla]]
*[[User:McGeagh|McGeagh]]
*[[User:Phaeodaria|Phaeodaria]]
*[[User:Topfs2|Topfs2]]


WebFooter=True
==Skinners==
*[[User:Jezz_X|Jezz_X]] - Team skinner & Project Manager of the [http://sourceforge.net/projects/xboxmediacenter XBMC Skinning Project]
*[[User:freezy|freezy]]
*[[User:ronie|ronie]]


Header=<nowiki>””</nowiki>
==Addon Developers==
*[[User:amet|amet]] - python addons
*[[User:Clumsy|Clumsy]]
*[[User:dushmaniac|dushmaniac]] - PVR, EPG
*[[User:Jmarshall|Jmarshall]] - on an as-needed basis
*[[User:Spiff|Spiff]] - on an as-needed basis


Footer=<nowiki>””</nowiki>
==Q/A Testers==
*[[User:keith|keith]] - QA for iOS and OSX projects
*[[User:kricker|kricker]]


OpenTag<nowiki>=”<li>”</nowiki>
==Forum and Online Manual (wiki) Moderators==
*[[User:Clumsy|Clumsy]] - Forum Moderator
*[[User:DonJ|DonJ]] - Server and Mirror Contact
*[[User:Gamester17|Gamester17]] - Moderates a little bit of everything
*[[User:joebrady|joebrady]] - Forum Moderator
*[[User:Ned Scott|Ned Scott]] - Wiki and forum Moderator
*[[User:Prae5|Prae5]] - Forum Moderator
*[[User:Sho|Sho]] - WIKI Structure Guru
| valign="top" style="background: #ffffff;"|


CloseTag=[carriage return]
==Inactive Members==


CloseFinalTag=False
==Project Founders (All Retired)==
*[[User:Frodo|Frodo]] - now [http://www.team-mediaportal.com MediaPortal] head programmer/founder
*[[User:RUNTiME|RUNTiME]] - now [http://www.runtime360.com runtime360.com] & [http://www.runtime360.com/projects/transcode-360/ Transcode 360]
*[[User:d7o3g4q|d7o3g4q (a.k.a. Duo Egaq)]] M.I.A. (Missing In Action)


==Developers (Currently Inactive or Retired)==
*[[User:MaestroDD|MaestroDD]] - Mac OS X, and Apple TV
*[[User:wattazoum|wattazoum]] - XBMC for Linux packaging specialist
*[[User:AreaScout|AreaScout]]
*[[User:Alcoheca|Alcoheca]]
*[[User:oldnemesis|oldnemesis]]
*[[User:motd2k|motd2k]]
*[[User:Rudd|Rudd]]
*[[User:Alwinus|Alwinus]] - XBMC PVR Frontend Programmer
*[[User:Kraqh3d|Kraqh3d]]
*[[User:C-Quel|C-Quel]]
*[[User:Agathorn|Agathorn]]
*[[User:Tut-ankh-amon|tut-ankh-amon]]
*[[User:nad|nad]] - [[WebServerHTTP-API|XBMC HTTP API Mastermind]]
*[[User:MrC|MrC]] - XBMC Visualisation/Screensaver Mastermind
*[[User:c0diq|c0diq]] - UPnP (Universial Plug And Play) Mastermind
*[[User:Yuvalt|Yuvalt]] - XBMC Linux port specialist
*[[User:Vulkanr|Vulkanr]] - XBMC Linux and Mac port specialist
*[[User:D4rk|D4rk]] - XBMC Linux and Mac port specialist
*[[User:Bobbin007|Bobbin007]]
*[[User:Tslayer|Tslayer]]
*[[User:GeminiServer|GeminiServer]] - Low-level Hardware Guru
*[[User:Darkie|Darkie]]
*[[User:Forza|Forza]] - M.I.A. (Missing In Action)
*[[User:Butcher|Butcher]]
*[[User:Ysbox|Ysbox]]
*[[User:Guybrush|Guybrush]] - M.I.A. (Missing In Action)
*[[User:Kreet|Kreet]] - M.I.A. (Missing In Action)
*[[User:monkeyhappy|monkeyhappy]] - M.I.A. (Missing In Action)
*[[User:elan|elan (a.k.a. leafmuncher)]] - XBMC for Mac port specialist
*[[User:LiquidIce629|LiquidIce629]] - [[The Web Interface|XBMC Web GUI control-interface]]


[Added 22 Oct 2006]  
([http://www.cliqklabs.com/xbmcwebgui/ Website])


Additional tags added and their default values (formats the response from the QueryMusicDatabase command):
==Skinners / Graphic-artists (Retired)==
*[[User:CHI3f|CHI3f]] - XML Guru and all round Good Guy
*[[User:SmokeHead|SmokeHead]] - Photoshop Guru (Missing In Action)
*[[User:Chokemaniac|ChokeManiac]] - Project Mayhem


OpenRecordSet=<nowiki>””</nowiki>
==Python Scripters (Retired/Inactive)==
*[[User:Voinage|Voinage]] - Python Plugin coder
*[[User:rwparris2|rwparris2]] - Python Plugin coder
*[[User:Nuka1195|Nuka1195]] - Python Script coder


CloseRecordSet=<nowiki>””</nowiki>
==Web Services (Retired/Inactive)==
*[[User:Granqvist|Granqvist]] - Web Developer
*[[User:blittan|blittan]] - Web and Python Developer


OpenRecord=<nowiki>””</nowiki>
==Testers (Retired/Inactive)==
 
*[[User:DDay|DDay]] - [http://forums.xbox-scene.com/index.php?showforum=180 Xbox-Scene.com Forum Mod God]
CloseRecord=<nowiki>””</nowiki>
*[[User:TeknoJuce|TeknoJuce]] CrAzY Canuck
 
*[[User:Modhack|Modhack]] - French Guru [http://manuel.xboxmediacenter.fr .fr manuel]
OpenField=<nowiki>”<li>”</nowiki>
*[[User:Donno|Donno]] - 1337 d00d
 
*[[User:SandmanCL|SandmanCL]] - Quality Assurance
CloseField=<nowiki>””</nowiki>
*[[User:ShortySco|ShortySco]] - Quality Assurance
 
*[[User:Scape|sCAPe]] - Beta-Tester
It is now possible to specify multiple formats in a single call to SetResponseFormat.
 
SetResponseFormat without any parameters returns the formatting to the default values (as would restarting xbmc).
| http://xbox/xbmcCmds/xbmcHttp?command=SetResponseFormat&parameter=WebHeader;False
 
[[Added 22 Oct 2006]
 
The following sets up an XML formatted response (if viewing the output in a browser you will neeed to use the view source command to see the xml tags).
 
<nowiki>http://xbox/xbmcCmds/xbmcHttp?command=setresponseformat&parameter=webheader;false;webfooter;false;header;<xml>;footer;</xml>;opentag;<tag>;closetag;</tag>;closefinaltag;true</nowiki>
 
Then the same for the QueryMusicDatabase response:
 
<nowiki>http://xbox/xbmcCmds/xbmcHttp?command=setresponseformat&parameter=openRecordSet;<recordset>;closeRecordSet;</recordset>;openRecord;<record>;closeRecord;</record>;openField;<field>;closeField;</field></nowiki>
 
Now set everything back to the default:
 
http://xbox/xbmcCmds/xbmcHttp?command=SetResponseFormat
|-
| getXBETitle(path)
| [Added 16 Jan 07] Return the Title/Description of the specifed XBE
| http://xbox/xbmcCmds/xbmcHttp?command=getxbetitle&parameter=Q:\default.xbe
|-
| getXBEid(path)
| [Added 16 Jan 07] Returns the id of a specifed XBE
| http://xbox/xbmcCmds/xbmcHttp?command=getxbeid&parameter=Q:\default.xbe
|}
 
===Broadcast Commands===
 
{| border=1 cellspacing=0 cellpadding=5
| <strong>Command</strong>
| <strong>Information</strong>
| <strong>Example</strong>
|- 
| Broadcast(message;port)
| Not sure if there is much point to this command - probably could be used to test a client listening for broadcasts. If the port parameter is not specified then the currently set default port will be used.
| http://xbox/xbmcCmds/xbmcHttp?command=Broadcast&parameter=hello_from_xbmc
|-
| SetBroadcast(level;port)
| Sets the brodcast level and port. Level currently only takes three values: 0 - no broadcasts, 1 - media playback and startup & shutdown events, 2 - "OnAction" events (e.g. buttons) as well as level 1 events. Port is optional and if specified sets the default broadcast port value.
| http://xbox/xbmcCmds/xbmcHttp?command=SetBroadcast&parameter=1
|-
| GetBroadcast()
| Returns the current level and port settings.
| http://xbox/xbmcCmds/xbmcHttp?command=GetBroadcast
|}


===Name Changes===
==#XBMC (FreeNode) IRC Support==
*[[User:Bizzeh|Bizzeh]] - Mr. Hater ("I want to be in all sections") ([http://www.bizzeh.com Blog])
*[[User:Cocoliso|Cocoliso]] - Spanish
*[[User:DOS4GW|DOS4GW]] - Multi-lingual
*[[User:Jedi79|Jedi79]]
*[[User:MattAAron|MattAAron]]
*[[User:No1CaNTeL|No1CaNTeL]]
*[[User:xLoial|xLoial]] - Seasoned newbie


To make the names of the commands more logical some have been changed. The old names are still recognised but it is strongly advised that the new names are now used.
==Forum and Online Manual (WIKI) Moderators (Retired/Inactive)==
*[[User:Dankula|Dankula]] - WIKI Editor
*[[User:Loto_Bak|Loto_Bak]] - Al'round support man
*[[User:nimbles|nimbles]]
*[[User:No_Good|No Good]]


{| border=1 cellspacing=0 cellpadding=5
<br><br>
| <strong>Old Name</strong>
If your link is missing and/or faulty, contact [[User:Pikestaff|Pike]] or [[User:Gamester17|Gamester17]]
| <strong>New Name</strong>
|-
| CopyFile
| FileCopy
|-
| DeleteFile
| FileDelete
|-
| GetInternetFile
| FileDownloadFromInternet
|-
| GetThumb
| FileDownload
|-
| GUISetting
| SetGUISetting, GetGUISetting
|-
| SetFile
| FileUpload
|-
| SetKey
| SendKey
|}
|}


[[Category:Inner Workings]]
[[category:Team-XBMC]]
[[Category:Development]]
[[category:Python]]
[[category:Skin Development]]

Revision as of 15:15, 11 September 2011

List of people officially involved with XBMC development, (likely incomplete, so give us a nudge if we forgot you)

(PLEASE DON'T E-MAIL OR PM ANYONE DIRECTLY ABOUT SUPPORT! INSTEAD USE THE COMMUNITY FORUM OR IRC-CHANNELS!)

Active Members

XBMC Foundation Voting Board Members and Non-Voting Officers

  • Jmarshall - Board Member (President)
  • Yuvalt - Board Member (Secretary)
  • elupus - Board Member
  • Pike - Board Member
  • Spiff - Board Member
  • theuni - Board Officer (Business Relations Manager)
  • malloc - Board Officer (Treasurer)

Project Managers

Liason

Developers (General)

Developers (Linux)

Developers (Mac and iOS)

Developers (Windows)

Developers (ARM)

Skinners

Addon Developers

Q/A Testers

Forum and Online Manual (wiki) Moderators

Inactive Members

Project Founders (All Retired)

Developers (Currently Inactive or Retired)

(Website)

Skinners / Graphic-artists (Retired)

Python Scripters (Retired/Inactive)

Web Services (Retired/Inactive)

Testers (Retired/Inactive)

#XBMC (FreeNode) IRC Support

Forum and Online Manual (WIKI) Moderators (Retired/Inactive)



If your link is missing and/or faulty, contact Pike or Gamester17