Revision 12 as of 2009-06-18 18:42:03

Clear message
  • Launchpad Entry: Integrating with Ubuntu One

  • Created: 2009-06-17

  • Contributors: Joshua Hoover, Steve Alexander, Elliot Murphy, Lucio Torre

  • Packages affected: python-contacts-api, dbus-contacts-api, gtk-contacts-picker, erlang, couchdb, couchdb-bin, ubuntu-couchdb, couchdb-oauth, couchdb-history, ubutuone-sync-ui, evolution-couchdb, akonadi-couchdb, tomboy-couchdb, firefox-bookmarks-couchdb, python-couchdb, couchdb-glib, dbus-couchdb, python-couchdb-records-api, dbus-couchdb-records-api, icontool, ubuntuone-client, ubuntuone-storage-protocol, python-oauth, ubuntuone-screensharing, ejabberd, configglue, gwibber-couchdb


Ubuntu One provides capabilities for the Ubuntu desktop as well as extended capabilities via optional online services. Integrating Ubuntu One capabilities with the Ubuntu desktop will provide storage sharing & synchronization (across a LAN and (optionally) the Ubuntu One cloud), screen sharing, and data (contacts, notes, Firefox bookmarks) sharing & synchronization via CouchDB.

Release Note


User stories

Data Sharing & Synchronization


Bookmarks (Firefox)

Notes (Tomboy)

File Sharing & Synchronization

  • Ubuntu One Account, Subscription & Computer Setup - Jacko is running Ubuntu 9.10 on his desktop. He establishes an Ubuntu One account using his Launchpad ID and subscribes to the paid 10GB plan using his credit card. Jacko launches Ubuntu One on his desktop from the Applications->Internet->Ubuntu One menu. A browser window appears and asks him to authenticate his computer with his Ubuntu One subscription. Jacko completes this process. Any folders in his ~/Ubuntu One directory will be copied and stored in the cloud.

  • Add A Computer To Use Ubuntu One Service - Jacko has multiple computers and he wants to configure his netbook to synchronize folders with Ubuntu One. Jacko launches the Ubuntu One Sync Client on his netbook. A browser window appears and asks him to authenticate his second computer with his Ubuntu One subscription. Jacko completes this process. The netbook will pull down any folders from the cloud and add them to ~/Ubuntu One. Jack adds a folder of music files to his ~/Ubuntu One directory. This folder is synchronized with the cloud. Jacko logs into his desktop computer. New files are pulled down from the cloud and his desktop is in sync with his netbook.

  • Share Files Using Ubuntu One Service - Share Folders Using Jacko uses Nautilus to browse to a directory of photo files within ~/Ubuntu One. Jacko right-clicks on the directory and chooses to Share on Ubuntu One with his friend Ben. A window appears and he types Ben's email address and clicks to not allow Ben to edit this folder. This setting is pushed to the cloud and a sharing invitation is sent to Ben. Ben receives an email notification that Jacko has shared a folder with him. Ben already has an Ubuntu One subscription. He logs into his computer and the Ubuntu One Sync Client on Ben's computer pulls the folder of pictures from the cloud. Ben opens ~/Ubuntu One and he can view the shared folder of photos from Jacko.

    • Ben is away from his computer but wants to see the photos. Ben can log into the Ubuntu One website and browse to Jacko's shared folder of photos.
    • Jacko wants to stop sharing the folder of photos with Ben. Jacko logs into the Ubuntu One website and browses to the folder. He clicks the sharing tab and cancels the share with Ben. Ben logs into his computer and the Ubuntu One Sync Client removes the photos from Ben's ~/Ubuntu One folder.

Screen Sharing

  • No Ubuntu One Accounts - Jacko and Fiona do not have Ubuntu One online accounts. Jacko opens Empathy and connects to a Jabber (XMPP) server. Jacko right-clicks on Fiona's name in his Empathy buddy list and chooses "Share my screen". Fiona has Empathy open and receives a notification in Empathy that Bob wants to share his screen. Fiona selects OK. A screen sharing session is started using Telepathy to negotiate the best connection. Vino launches on Jacko's computer and Vinagre starts up on Fiona's computer. Jacko sees the message, "Fiona's looking at your desktop" and Fiona sees Jacko's desktop.

  • Ubuntu One Subscribers - Tom and Ben have Ubuntu One subscriptions which includes a Jabber user account on an Ubuntu One Jabber (XMPP) server. They both have Empathy running on their computers. Tom right-clicks on Ben's name in his Empathy buddy list and chooses "Share my screen". Ben sees a notification in Empathy that Tom wants to share his screen. Ben selects OK. A screen sharing session is created using Telepathy and an Ubuntu One connection manager. The connection manager verifies that Tom or Ben has an Ubuntu One subscription and finds the best way to connect using an Ubuntu One proxy server. Vino launches on Tom's computer and Vinagre starts up on Ben's computer. Tom sees the message, "Ben's looking at your desktop" and Ben sees Tom's desktop.


File Sharing & Synchronization

File sharing and syncronization allows users to share and synchronize files across their local network. An optional capability will allow users to easily share and synchronize files across the Internet using the Ubuntu One online service.

The Ubuntu One client will no longer use a client applet (as is the case with the current beta). Instead, the client will use downloads, FUSA, and standard Ubuntu messaging indicators.


  • icontool
  • ubuntuone-client
  • ubuntuone-storage-protocol

Screen Sharing

Provides screen sharing between two desktops using Empathy, Telepathy. The "Share My Desktop" dialog will be unaffected. An optional Ubuntu One service will provide a proxy (utilizing ejabberd on the server) to allow users to more easily share their screens across the Internet.


  • ubuntuone-screensharing
  • ejabberd

Data Sharing & Synchronization


Overview: Apache CouchDB is a distributed, fault-tolerant and schema-free document-oriented database accessible via a RESTful HTTP/JSON API. CouchDB is the database for Ubuntu One data sharing and synchronization capabilities.

Erlang is the language and runtime environment for CouchDB. Work will be done to trim the Erlang package so that it is as small as possible to run CouchDB and other applications dependent on the Erlang runtime.

Each user will run their own instance of CouchDB, which is different than the standard install of the current CouchDB package. There is also a need to setup various CouchDB configuration files, design docs, and triggers. Additional capabilities will be added to CouchDB, including OAuth support and document history.

In order for developers to more easily use CouchDB in their applications, we will provide libraries for a variety of languages and environments, including Python, DBUS, and GTK (GLib).

A new desktop application will be developed to allow users to easily share and synchronize their data (contacts, notes, bookmarks, etc.) stored in CouchDB between Ubuntu computers on their local network.


  • erlang
  • couchdb
  • couchdb-bin
  • ubuntu-couchdb
  • couchdb-oauth
  • couchdb-history
  • python-couchdb
  • couchdb-glib
  • dbus-couchdb
  • python-couchdb-records-api
  • dbus-couchdb-records-api
  • ubuntuone-sync-ui


Providing a CouchDB contacts database that all Ubuntu applications can use is one of the key applications of the Ubuntu One data sharing and synchronization capability. Integration with Evolution, Akonadi, and Gwibber will provide the ability to store contacts in CouchDB. By default, Evolution, Akonadi, and Gwibber will continue to use their current contact data store. Developers of GTK applications will have a GTK widget which can provide their applications with a way to easily lookup/select contacts from the contacts CouchDB database. There will also be a contacts API for Python and DBUS, which will allow developers to use the CouchDB contacts database without worrying about the underlying details of CouchDB and the contacts schema.


  • evolution-couchdb
  • akonadi-couchdb
  • gwibber-couchdb
  • python-contacts-api
  • dbus-contacts-api
  • gtk-contacts-picker

Bookmarks (Firefox)

A Firefox bookmarks synchronization and sharing extension will store Firefox bookmarks in CouchDB, which will provide sharing and synchronization capabilities.


  • firefox-bookmarks-couchdb

Notes (Tomboy)

Tomboy will use CouchDB for storing its data which will provide sharing and synchronization capabilities.


  • tomboy-couchdb


The packages below include the Python OAuth library and a tool for managing Ubuntu One configurations.


  • python-oauth
  • configglue


Code Changes

Specific code changes will be captured here. The summary given above in the design view highlights the major changes overall. As key code changes in the packages listed above are identified, they will be listed in this section.

Test/Demo Plan


Unresolved issues

This should highlight any issues that should be addressed in further specifications, and not problems with the specification itself; since any specification with problems cannot be approved.

BoF agenda and discussion

  • ubuntu-one uses the couchDB database
  • couchDB supports replication, it's very simple, open and uses structured data
  • ubuntuone provides an API to couchDB
  • couchDB has good upstream support, and we need to get it into main for karmic
  • the service in front of couch supports http, which simplifies access for the API
  • lazr.restful, a python api originally developed for launchpad
  • couchDB needs erlang
    • erlang is about 45M installed size
    • maybe we can strip down erlang to make it fit more easily fit the single live CD
  • the application only needs to know how to handle the structured data with couchDB, not worry about things like sync, replication, etc
  • one use case, having a syncronized addressbook
    • evolution-data-server directly queries ubuntuone (locally)
    • the contact database from ubuntuone does sync locally, so e-d-s doesn't directly query the server just the local sync of the service
  • for the contact storage, what is the upgrade path?
  • start time is something to consider, the syncdaemon runs continuously, but it is in the background
    • perhaps defer the rescan to speed up login time
  • working with the design team to work out the details of what to do with the applet
    • it might go away when idle
  • other uses:
    • screen sharing
      • for now sticking with current technology, vino and vnc
    • bookmark syncing
      • trademark issues with customizing firefox
      • perhaps weave integration
      • modifications would be made in ubufox
    • tomboy sync
      • sync notes to u1 instead of snowy
      • should we consider gnotes?
    • backing up a usb drive when plugged in
  • What KDE apps should integration with u1?
    • system wide storage called akonadi using mysql
  • ultimately all configuration should be done in the applications, but we might use a common u1 control panel to configure various aspects of u1 until we get that level of integration
  • we need to work on the MIR for the u1 client and deps (including erlang) for karmic
  • before doing the MIR we should figure out how we can split erlang into smaller chunks for CD size constraints. See: