Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
PHP
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
Connections
Examples
Services
BoxeeBoxPHPJSONRPC.class.php
README

README

BoxeeBox PHP JSONRPC SDK by Nicholas Robinson

This project houses a fully functional and re-usable PHP SDK for the BoxeeBox JSONRPC API. Several examples are included as suggestions for possible uses and to help get you started. My hope is that given the prevalence of PHP and the ease of access to web server technologies this SDK will increase and diversify the number of devices that can interact with the BoxeeBox. 

To see it in action go here (sockets are disabled for safety):
http://www.nicholassavilerobinson.com/BoxeeBox-PHP-JSONRPC/Examples/browser.php

The JSON RPC API replaces the soon-to-be-deprecated HTTP API, but can be combined with it to utlize the UDP-XML discovery protocol and other useful features. Why not have a look at https://github.com/nicholasrobinson/BoxeeBox-PHP-RemoteControlInterface to see what differences exist between the two APIs?

Requirements:
- PHP 5.2+
- Web Server (optional)

Installation:
- Download/Clone project folder
- Place in your web root (optional)
- Run the the example scripts (found in the "Examples/" folder) in your web browser or from the command line
- Make sure to utilize Examples/browser.php to get familiar with the API

Please Note: 

For simplicity of cross-platform implementation/compatibility there is no attempt to handle state within the SDK. As a result connection state must be handled by your implementation (examples are included with the SDK). Furthermore Boxee API push Notifications are not readily available.

To maintain connection state there are many options, including:
- Browser Cookies
- PHP Sessions
- Local Storage
- Databases
- HTML Form submission [POST/GET] (as shown in Examples/complex.php)
- Javascript (as shown in Examples/keypress.php and Examples/browser.php)

Please let me know if you find this useful or come up with any novel implementations.

Enjoy!

Nicholas Robinson
me@nicholassavilerobinson.com

P.S. You 'could' host your BoxeeBox JSONRPC application on the public internet and control your BoxeeBox from anywhere. If you choose to go this route, please consider the security implications of potentially allowing anyone on the internet to control your BoxeeBox.

References:
http://developer.boxee.tv/JSON_RPC
Something went wrong with that request. Please try again.