Developer Blog

App Development on the Boxee Box

We’ve had a lot of questions regarding the status for developers who currently have apps on the platform, or are currently working on new ones.

For apps that have already been accepted and are available in the Boxee app library, the applications will remain there.  We won’t make any significant changes to the app library. If you’ve already got an app on the platform you’ll be able to update major bugs in your app, no problem.  We don’t have the resources to do quality assurance on major app updates so if you’re changing the core app functionality or features, we’ll most likely suggest that you host the app on your own repository.

For apps that are not yet in the Boxee App Library, developers have until Dec 14th to submit them.  Apps submitted before that day will go through our standard review process.  If apps do not pass review the first time, then developers will need to host their own repositories for their apps.  Apps submitted after Dec. 14th will receive an auto-reply on how to do this.   You will be able to add apps through repositories indefinitely (some of our most popular apps are hosted in repositories).

If you have any questions, please email us at developers@boxee.tv

Best,
Shawn

November 29, 2012 at 6:55 pm

Important Developer Update

We interrupt your otherwise ambiguously awesome developer’s lives to bring you a bit of sad news. Earlier this month we released the last version of Boxee for the PC (v1.5). After Jan 31st we will remove the download from our website and we will shutdown support for Mac/Windows/Linux platforms.

There are lots of reasons for this decision, but the clearest is our belief that the future of TV will be driven by devices like the Boxee Box, Connected TVs, Blu-Ray players and 2nd screen devices such as tablets and phones. While many users still have computers connected to their TVs, we believe this use case is likely to decline as users find inexpensive, better alternatives.

So what does this mean for you as a developer? Well if you’ve developed apps for the Boxee Box, then you’re all good. You don’t need to do anything.

If you’ve developed apps for our downloadable software, then we’d like you to:

  • Test it on the latest release (v1.5 available here) to see if it works. If it does, huzzah! Stay golden.
  • If it doesn’t work – you’ve got two options:
    - Fix the bugs and resubmit it to us before Jan. 31st.
    - Ignore the bugs on the PC and resubmit as Boxee Box ONLY by Jan. 31st. Check out the “platform” specification on our DevWiki for a how-to: http://developer.boxee.tv/Descriptor_XML

After Jan 31st, we recommend developing all apps in HTML5 so your app can easily work across many platforms. Our hope is that this will streamline the app development process for you as well as lighten the support load for our team.

To help you get started, we’ve put together a few easy HTML5 templates with frameworks that have already been tested on Boxee. You can find them here:
https://github.com/Boxee/html5-examples

If you’ve got any other questions or concerns about our plans, please feel free to give us a shout at developers@boxee.tv.

Cheers,
Team Boxee

January 24, 2012 at 4:55 pm

Boxee at HackNY Hackathon

by Ray

Obviously there’s been a notable silence since Rob headed out to be a full time developer evangelist 2 months ago.   I’m going to do my best to fill a little bit of the gap that Rob’s departure left in the blog, obviously those are big shoes to fill, so bare with me here.

First a brief introduction, my name is Ray, I’ve been a web developer at Boxee since April, and I’m currently Boxee ping pong champion.  I’m also not a Red Sox fan.

Back on October 1st Boxee offered up its APIs to students at the HackNY fall Hackathon. HackNY gathered several NYC startups and a ton of great college student hackers from far and wide for 24 hours of caffeine fueled creativity.  The students formed teams, came up with project ideas, and got busy with the various APIs that were presented.

There were a number of interesting projects that were presented when the dust settled that made use of Boxee APIs:

One team put together TumblrTV , which hooks into your tumblr account, finds videos in your feeds, and plays them back inside a classy throwback wooden TV.  The navigation is simple and it shows additional info from Tumblr when each video starts.

Another team made what I think was one of the first games we’ve seen on Boxee.  They built an Othello app using mac and windows symbols in place of white and black dots – a nice hacker touch that got the other students vocally choosing sides during their presentation.

A solo programmer got started with the html5-fullscreen-player boxee project that we recently put up on github and made an app that let the user take screenshots from an html5 video.  Then the app posted the screenshot directly to a tumblr feed.  Pretty sweet!

In prepartation for the Hackathon we also put up some examples on GitHub for how to make HTML5 boxee apps, as well as a javascript api library.  Development on these is ongoing but they should help anyone looking to make HTML5 apps get started.  If you have questions or suggestions, don’t hesitate to email me (ray [AT] boxee.tv)

Oh, and in case anyone was wondering if Rob is loving his new gig at Twilio, you should check this out:



October 25, 2011 at 11:20 am

Thank You.

Boxee devs one and all!

This week has been pretty damn rad.  On Tuesday we released our much anticipated new Boxee Box firmware 1.2 which included a lot of hot sauce for developers, including AirPlay support and fixes to our new JSON-RPC remote control API.  It also marked the launch of the new Boxee Media Manager to stream content from your PC or Mac to your Boxee devices more easily.  And of course we unleashed our wicked iPad app onto the world, racking up over 50,000 downloads and reaching #9 in the App Store.

Got a bit of personal news I need to share with you – today is my last day at Boxee.  Working with you has been my favorite part of this gig, so much so I’ve decided to do that full time with a career move to pursue developer evangelism.  Of all the insanely ridiculous opportunities I have had at Boxee, the most fun has been getting to know you and watch you turn this open source platform into a hurricane gale movement.

Boxee has been the most important work of my career, and you – the Boxee developer community – were the best part of it.

A familiar face will be taking my place on the community front in the form of Shawn Rieger, who you can reach at developers [at] boxee [dot] tv with any of your questions or support needs.

While I leave the Boxee crew, I’m staying solidly in the Boxee family as “Evangelist Emeritus.” You can expect to see me chiming in on the forums now and again, releasing the occasional app and encouraging every last person I see suffering from an ordinary television experience to cut that cord and be free at last.  I hope if I can help you in any way, you won’t hestitate to reach out and contact me.  You can follow my further misadventures over at Brooklyn Hacker.

May the road rise to meet you – as I will, some where down the way.

August 12, 2011 at 9:52 am

App Categories Coming in 1.2

If you’ve logged into your Developer Dashboard today, you’ve noticed a new management feature for your apps.  With the upcoming 1.2 release for the Boxee Box, we are going to be introducing new Categories for apps.  Up until now, apps have been categorized solely by Video, Photo, and Music.  With 1.2, we’ll be helping navigate our exploding library of apps with a whole mess of new categories, including:

  • Adult
  • Education
  • Entertainment
  • Film and TV
  • Gaming
  • Kids
  • Lifestyle
  • Live
  • Music
  • News
  • Photo
  • Sports
  • Social
  • Tech

You don’t have to adjust anything in your application to get ready for this new release.  Just log in to your Developer Dashboard, click on Apps, select the app you wish to categorize, and choose three from the list above.

1.2 drops in a few weeks, so get your apps categorized with a quickness!

June 30, 2011 at 11:25 am

Miso Announces Dev Contest For Social TV Developers

The fine folks over at Miso have announced a developer competition and are extending a warm invitation to the Boxee family to compete.  Miso serves up a piping hot social TV platform for checking into your favorite shows, earning points and badges while discovering what fun stuff your friends are watching.  We share a lot of users in common and now they’re rolling out the red carpet to our development crew to kick out some tight social TV apps.

Here’s the skinny:

Deadline: 10 May 2011, noon Pacific Daylight Time.

Prize: A brand spanking new iPad 2, ready for our upcoming Boxee iOS app.

Rules: Must leverage the Miso API to do something awesome.

What kind of awesome can be built with Miso and Boxee?  Oh how about some of these tasty treats:

  • Auto check-ins on Miso when you watch shows on Boxee
  • Change show on Boxee based upon what your friends watch in Miso
  • Notification when a new episode of a show you follow on Miso is available on Boxee
  • Check out your friends’ favorite shows
  • Leave notes on shows for your friends to see
  • A Boxee app hinting on how what would be best to watch to earn Miso badges
  • Create an auto-running playlist Boxee app based on Miso trends

The ideas just fly off the fingers.  More details are available at the Miso blog including their sign-up form.

As usual, I’m here to make sure you win.  Hit me up on IRC at FreeNode at #boxee, on Twitter at @boxee_api and via email at rob [at] boxee [dot] tv if you run into any snags.

Go get ‘em!

April 13, 2011 at 5:54 pm

Congrats to hackNY Winners Adit Shukla, Doug Fulop and Eric Seidel

This past weekend NYU’s Mathematical Sciences Building played host to the third hackNY Student Hackathon, drawing over 150 students from 50 different schools up and down the Eastern Seaboard.  Giving up a sunny Saturday in New York, college hackers drove through the night to produce 24 different hacks to present to luminaries of the NYC tech community.

Etsy Shopping Network AppPulling down the top overall prize was a Boxee based hack called “Etsy Shopping Network.”  This HTML5 app is an elegant window-shopping-in-Williamsburg take on the TV shopping experience developed by the prodigious team of Adit Shukla (@aditshukla), Doug Fulop (@dougfulop) and Eric Siedel (@gridaphobe).

Designed by Adit, the simple interface let’s users peruse their favorite Etsy items and puts the gorgeous product photography front and center in a 10-foot interface.  Eric wrote the backend in Ruby, leveraging the Sinatra framework and the Etsy API.  Finally, Doug made the interface go, picking up some strong jQuery-fu in the process.

The app is available for Boxee Box users by adding this repository to your install:

http://tapp.boxee.tv/partners/etsyshoppingnetwork

Don’t have the Boxee Box?  Scope it out in your browser at:

http://etsy-tv.heroku.com

Congrats Adit, Doug and Eric – can’t wait to see what you come up with next!

April 11, 2011 at 5:51 pm

Helpful Debug Grid from Bartsidee

Late last year Dutch developer Bartsidee exploded onto the Boxee scene with a popular custom repo delivering some widely used applications.  Bart has also been huge on the Boxee Forums helping developers get started on Boxee and providing a lot of tips and tricks.  His repository is one of my favorite to watch on GitHub and he just released a simple but helpful grid graphic to help debug your UI layouts in Boxee.

Check it out:

Bart has laid out markers in pixels to help you place your controls on the grid.  Super useful to put as a background on your application while you are doing your UI design.  Simply drop thing PNG inside your media folder and put it in the background by making it the bottom image control on your UI stack.  You can do so with just a few lines of XML:

<control type="image">
   <width>1280</width>
   <height>720</height>
   <texture>debuggrid.png</texture>

Thanks Bart – enjoy!

March 2, 2011 at 11:55 am

What Oscars? Hear Rob Talk at SCALE9x!

Is there something else going on in Los Angeles this weekend?  SCALE9x crashes the Airport Hilton in sunny Los Angeles this weekend and open source enthusiasts from around the globe are descending en force.  Swapping red carpets for red fedoras and VIP passes for IPv6 classes, the international FOSS community is gathering for one of the biggest open source conferences geared toward the discriminating hardcore geek.

Boxee will be there representing in full effect with your friendly neighborhood community evangelist Rob sporting the punch-drunk frog loud and proud all weekend long.  Check out these tasty Boxee appearances on Saturday:

  • Open Source Television – 3pm Saturday, Century AB: Rob gives a talk on what Boxee gives and gets from the open source community.
  • FLOSS Media Center Panel – 1:30pm Saturday, La Jolla: Rob joins XBMC’s Cory Fields and LinHES’s Cecil Watson and Michael Hanson to talk about the future of open source in the living room.
  • The Weakest Geek – 7:30pm Saturday, La Jolla: Street cred is the most valuable currency in SCALE9x’s annual geek trivia contest – will Rob have what it takes to be the weakest of all?

Full schedule of festivities is here.  Rob will be in attendance all weekend, so keep an eye out for a Boxee t-shirt, a punk rock Thinkpad and a hearty laugh and say hello!

Tags: ,
February 24, 2011 at 1:26 pm

Developing HTML5 on Boxee

It’s Valentine’s Day at Boxee and users are already feeling the love. Of course, we never want to leave out our developers from our affection, so I thought I’d rap a bit about our support for HTML5.  

We feel strongly that the future of TV apps is a cross-platform one, where developers write code once and users enjoy the experiences across multiple devices and screens.  HTML5 can create rich experiences across many platforms on the desktop, on mobile devices and – of course – in the living room.  We’re on board with this new standard and would like to invite you to try your hand on building an HTML5 app on the Boxee Box.

Setting up an HTML5 app is super easy – just three steps!

1) Creating the descriptor.xml

Like RSS and skin Boxee apps, HTML5 apps start with a descriptor.xml.  Let us first consider this example.

<app>
  <id>example</id>
  <name>Example HTML5 App</name>
  <version>1.0</version>
  <description>An example HTML5 app using the new Boxee browser.</description>
  <thumb>http://example.com/thumbnail.png</thumb>
  <repository>http://dir.boxee.tv/apps</repository>
  <media>video</media>
  <copyright>Example, inc</copyright>
  <type>html</type>
  <url>http://www.example.com/html5app</url>
  <controller>http://example.com/boxee.js</controller>
  <platform>all</platform>
  <minversion>1.0</minversion>
  <test-app>true</test-app>
</app>

There are three new important values and one new element we introduced just for HTML5 apps.

  • <type>html</type> – This element defines the Boxee app as an HTML5 app.
  • <url>http://www.example.com/html5app</url> – Like in RSS apps, we use the url element as the link to our HTML5 application.
  • <controller>http://example.com/boxee.js</controller> – A new element in the descriptor.xml, the value for controller should be the link to your Javascript control file.
  • <minversion>1.0</minversion> – HTML5 support is a feature only available in Boxee 1.0; setting this value ensures that the app will be visible only for Boxee 1.0 clients (e.g. the Boxee Box).

2) Creating the Javascript controller

Along with HTML5 support, we’ve introduced a new browser mode to our Javascript API making it super simple to use the Boxee Box remote with your HTML5 app.  Called keyboard mode, setting this in your Javascript controller file now allows you to produce simple up/down/left/right navigation in your app with only three lines of Javascript code:

boxee.apiMinVersion=7.0;
boxee.reloadOnPageChange = true;
boxee.setMode(boxee.KEYBOARD_MODE);

3) Installing your app on your Boxee Box

Follow the handy and dandy new testing instruction we have available on the Developer wiki.

Enjoy this new feature of the Boxee platform and comment with your experience.

February 14, 2011 at 3:11 pm