Installation

To play with accomplishments two steps have to be taken:

• You need to install Ubuntu Accomplishments Daemon and Viewer

• You need to install a set (or few sets) of accomplishments - e.g. Ubuntu Community Accomplishments

This guide presents how to install the client-side application. If you are interested in setting up a validation server, read how to set up the server component.

What You Need

To run Ubuntu Accomplishments you need to be running Ubuntu 12.04 Precise Pangolin. You will also need to have an Ubuntu One account running on your computer.

You also need some additional packages to build the application from source. Run the following command to install them:

sudo apt-get update && sudo apt-get install quickly quickly-ubuntu-template python-gpgme

Installing the Ubuntu Accomplisments System

Getting the code

Run the following to check out the latest code for both components:

bzr branch lp:ubuntu-accomplishments-daemon
bzr branch lp:ubuntu-accomplishments-viewer

Installing the Daemon

At first, use the quickly's packaging command to create a .deb package from daemon's source.

cd ubuntu-accomplishments-daemon
quickly package

Afterwards, install the resulting .deb package:

cd ../
sudo dpkg -i accomplishments-daemon_0.1_all.deb

Installing the Viewer

The Viewer provides a graphical interface for browsing accomplishments. The installation is very similar:

cd ubuntu-accomplishments-viewer
quickly package

(Quickly may fail to create package or create it improperly if the daemon hasn't been installed before packaging the viewer.)

To install the Viewer's package run:

cd ../
sudo dpkg -i accomplishments-viewer_0.1_all.deb

The Ubuntu Accomplishments System has been installed on your system. However, this application makes no sense without any accomplishments set installed.

Installing Ubuntu Community Accomplisments

You are highly recommended to install Ubuntu Community Accomplishments collection (these are the different types of trophies). Grab these by running:

bzr branch lp:ubuntu-community-accomplishments

Now create a directory to install your accomplishments to in your home directory:

mkdir ~/accomplishments

When you have grabbed this branch you can install those accomplishments to your accomplishments directory in your home directory with the included script. For example:

cd ubuntu-community-accomplishments
./install.sh ~/accomplishments

Running The App

To run the daemon simply use:

twistd -noy /usr/bin/accomplishments-daemon &

Then, to browse accomplishments and trophies, use the viewer:

accomplishments-viewer

Follow the on-screen instructions and soon you will see a note in the status bar saying the app is checking for accomplishments: you should see new accomplishments appear in the My Trophies view shortly afterwards.

Note: In case you need to stop the daemon, use kilall -9 twistd.

Questions can go to jono@ubuntu.com

Thanks!

Uninstalling

Uninstallation is as simple as removing it's two packages: accomplishments-daemon and accomplishments-viewer

FAQ

How can I force a re-verification of my trophies?

Click File -> Check Accomplishments.

The application does not give me trophy for something I have accomplished!

Keep in mind that when Ubuntu One happens to lag a bit, the validation server may take some longer time to send you validated trophies. Also try re-verification your trophies. And double-check if your credentials are correct. If the application still misbehaves, report a bug: https://bugs.launchpad.net/ubuntu-accomplishments-system/+filebug

How do I clear out my trophies so I can re-verify them?

Your trophies directory lives in ~/.local/share/accomplishments/trophies. In that directory is a sub-directory for each collection of trophies. Just rm -rf * everything or even remove the sub-directories.

How do I clear out my user information so I can re-enter it?

Your trophies directory lives in ~/.local/share/accomplishments/trophies. In that directory is a sub-directory called .extrainformation - just delete it.