Introducing the WebLive API

After working on it for the last two weeks, I’m proud to finally announce the WebLive API.
As a reminder, WebLive is the name used for the daemon, Drupal plugin and scripts used to run
Since last week, all the code is now available here:

The API is exported over JSON and example code is available in the branch called ltsp-cluster-agent-vmmanager in the client directory. When interfacing with python, it’s recommended to use the “” module as it’ll be updated should the JSON API change or be extended in the near future.

Exported functions are:

  • create_user(serverid, username, fullname, password, session)
  • list_everything()
  • list_locales(serverid)
  • list_packages(serverid)
  • list_servers()

The following functions are exported over authenticated XML-RPC (for management):

  • delete_user(serverid, username)
  • set_disabled(serverid,status)
  • list_users(serverid,all=False)

The main weblive instance is available at and is the one used by Edubuntu.

The drupal-weblive branch contains the Drupal module which is now just a client to the JSON API.

The first use of that API after the Drupal module is Natty’s software-center which since last week ships with code to connect to WebLive.
If you use up to date Natty, you’ll need to install “qtnx” from universe and then start: software-center –with-weblive

All the packages available in WebLive will then have a “Test drive” button you can click to test that app remotely from a WebLive server.

WebLive integration in software-center

The software-center integration is experimental and will hopefully be improved by the time Natty is released. As Ubuntu doesn’t ship qtnx by default, WebLive won’t be visible in the default Ubuntu install, though it’ll be for Edubuntu.

Note: It can take up to a minute to connect to a server. There’s currently no user feedback during the connection process unless you watch the terminal from which you started the software center.

The current code requires your username and hostname to be ascii lowercase alpha characters only. I posted instructions as a comment to get the development branch that doesn’t have this restriction.

This entry was posted in Edubuntu, LTSP, Planet Revolution-Linux, Planet Ubuntu, WebLive and tagged . Bookmark the permalink.

12 Responses to Introducing the WebLive API

  1. If you want to test the latest changes for weblive in the software-center, you can try the following:
    – Install “bzr” (sudo apt-get install bzr)
    – bzr get lp:~weblive-dev/software-center/software-center-use-module
    – cd software-center-use-module
    – ./software-center –with-weblive

    This will install bzr, get my development branch of the software-center and start software-center using the new code I just commited.

    It fixes quite a few issues that are present in the software-center currently in Natty. These should get merged quite soon.

  2. Pingback: Software-center & weblive « Michael Vogt's blog

  3. Ellipsis says:

    Any plans for this to be enabled in future versions of Ubuntu (not just Edubuntu)?

  4. Well, all that Ubuntu would need to do to get it to work is install the “qtnx” package by default. That’s probably something that can and will be discussed at our next Developer Summit in Budapest.

    Until then we chose to do a smaller scale deployment by just having it by default in Edubuntu and available for all other Ubuntu users who manually install qtnx.
    From that we can gather data on server usage, stability and have something rock stable when we push it to Ubuntu itself.

  5. Pingback: Weblive su Natty consentira’ di provare in anteprima le applicazioni sul software center | P&P

  6. Pingback: Ubuntu 11.04: Δοκίμασε τις εφαρμογές πριν την εγκατάσταση

  7. Pingback: More on WebLive and the Software Center integration | Stéphane Graber's website

  8. Pingback: Ubuntu 11.04 Released : SiteCompInfo

  9. julien says:

    Hey this is amazing!! I’ve just test it and woow!!

    I am one of the main developper of APODIO distribution for multimedia / art / audio / video and I was wondering how could we use weblive on our server to test apodio online!!! I loooooove it!!



  10. Tristan Hils says:

    “I’ll be releasing a guide on how to setup your own WebLive server quite soon (hopefully next week) which should help you do that.”

    Not to nag, but is there any chance you could get that out there??

    Thanks so much!

  11. Vasilica Petcu says:


    Just reading your blog …

    Is there any small how to install weblive on my personal site ? Could you provide some more hints ???

    Thank you,
    Vasilica Petcu

Leave a Reply to Stéphane Graber Cancel reply

Your email address will not be published. Required fields are marked *