Hamster is now part of GNOME, and most probably available in your distribution – go ahead and search for “hamster” in your package manager! Distribution version will match GNOME stable, whichever that is at the moment and is suggested for everyday use.
If, however, you would like to see the best we have at the time – read on how to install from source.
From the source
Running development version gives you access to most recent changes and is recommended if you would like to contribute.
Project hamster depends on several development packages, so before getting to hamster, we should solve dependencies. Ubuntu’s apt-get line looks something like this:
sudo apt-get install gnome-common python-gtk2 \ python-gtk2-dev python-gobject python-gobject-dev libgconf2-dev \ python-gnome2-dev
After that hamster is good to go – let’s checkout! Fire up a terminal and execute following line:
git clone git://git.gnome.org/hamster-applet cd hamster-applet
Next let’s do that autotool thing – nothing to be affraid of – just copy/paste!
./autogen.sh --prefix=/usr/ --with-gconf-schema-file-dir=/usr/share/gconf/schemas/ make sudo make install
Now you should be able to add hamster to your panel!
The “–prefix” thing tells to install Hamster to /usr instead of /usr/local. That’s necessary, because normally the bonobo thing is not configured to look under /usr/local and thus you won’t see the applet.
“–with-gconf-schema-file-dir” tells where to put the gconf schema

55 comments
Comments feed for this article
April 18, 2008 at 9:17 pm
Halp! Packaging! « Project Hamster
[...] Make hamster build hamster from sources [...]
April 24, 2008 at 9:02 pm
Como usamos nuestro tiempo « OcioLinux
[...] Si lo quieres probar y saber cuanto le dedicas, por ejemplo a ver blogs, puedes descargar los paquetes .deb desde aquí (siempre y cuando uses ubuntu, sino, ve aquí) [...]
August 12, 2008 at 12:13 am
Christian
How do I use Hamster in Xfce? (Xubuntu 7.10/8.04/8.10)
August 12, 2008 at 7:01 am
Hamster - Time Tracking for Gnome
[...] can find installation guide from Hamster web site or from [...]
August 13, 2008 at 11:52 am
Productivio » Blog Archive » Project Hamster - Time Tracking Application For Linux
[...] Getting and installing [...]
October 22, 2008 at 6:59 pm
Time tracking in Ubuntu Linux with Hamster | sewmyheadon.com
[...] a Gnome application that sits in a panel so you can access it easily. It’s available in the repositories of several Linux distributions and, if you’re an Ubuntu user, there are APT sources you can add to install via [...]
November 11, 2008 at 6:57 pm
Richard
Where does Hamster keep its data file? It would be helpful to know for back-up purposes.
It’s a stupendous bit of software though – I’ve even persuaded a friend to install Ubuntu on the strength of it!
November 11, 2008 at 7:00 pm
Toms
Thanks Richard!
All activities are stored in single file:
~/.gnome2/hamster-applet/hamster.db
November 11, 2008 at 9:33 pm
Richard
Thank you Tom. I wish I’d asked before, as I’ve just lost a couple of weeks data – I forgot to save as an html before re-installing my system. Why did I do that? Don’t ask!
Anyway, I can now back up regularly. Thanks again.
December 2, 2008 at 9:30 am
Stargazers
Hmm, is there any ideas what might be wrong, but I cannot add Project Hamster to panel? I can see it’s icon in normal place, but when I drag it to panel, or press “Add” button or even double click it’s icon, nothing happens. It just won’t go on panel.
This happens on Intrepid Ibex.
Btw, if I start it manually /usr/lib/hamster-applet/hamster-applet I can’t see it anywhere, but if I start it with -w parameter, it starts windowed.
Any ideas?
December 2, 2008 at 11:43 am
tm
Stargazers – start the applet and then add to panel. All the debug output will go into console. Before that make sure that there is no instance of hamster running (unfortunately hidden under “python” process – so kill all pythons, hahaha)
January 3, 2009 at 7:00 am
Kambiz
Hi,
How can I install Hamster to my computer?
January 3, 2009 at 7:04 am
Kambiz
I have Window XP
January 3, 2009 at 1:46 pm
Toms
Project Hamster doesn’t work on windows yet, Kambiz. And we don’t have plans yet to make that happen.
January 13, 2009 at 2:32 am
Debian Etch
Hello,
Hamster looks very promising!
Is there an easy way to install Hamster on Debian Etch?
January 13, 2009 at 12:50 pm
Toms
Hmmm, Project Hamster is now part of GNOME, so it should be in the Debian repository – so go search for “hamster”. If it is not, then the fastest way could be from sources, but i don’t know really.
March 12, 2009 at 4:52 pm
webmonarch
Really enjoy using Hamster. Was having some really annoying issues with the date’s being jibberish. Then, I realized I was using something like 0.9.X version. Downloaded, compiled, and running 2.27.1 now. Really like the ACTIVITY@CATEGORY, DESCRIPTION syntax. It makes things much cleaning for me.
cheers, eric
April 21, 2009 at 12:43 am
Toms
thanks Eric, comments as yours make me happy, heheh
April 25, 2009 at 2:05 pm
Renato Diogo
Hi, very good tool!!!
So I have a problem. I have the applet in Fedora 10 (gnome 2.24, python 2.5), and will migrate to arch (gnome 2.26, python 2.6).
And I moved to db to new distro. When I will add applet to the panel get a error to open the applet.
If I add the applet without my actual db (new db), its open normally.
Has a incompatibility of the 2 version?
April 25, 2009 at 2:14 pm
Toms
Renato – hamster databases are future compatible, so there should be no problems regarding that.
What you can do, is use your previous database and run hamster in terminal:
/usr/lib/hamster-applet/hamster-applet -w
and see for any errors that pop out.
Just make sure you have no hamster instace running around before you do that.
April 25, 2009 at 2:24 pm
Renato Diogo
Hi Toms,
thank´s for ansers
so, the out of the run hamster is:
=====
[renato@thedark ~]$ /usr/lib/hamster-applet/hamster-applet -w
Data Dir: /usr/share/hamster-applet
SELECT version FROM version None
ALTER TABLE facts add column description varchar2 ()
Traceback (most recent call last):
File “/usr/lib/hamster-applet/hamster-applet”, line 60, in
hamster.__init_db()
File “/usr/lib/python2.6/site-packages/hamster/__init__.py”, line 90, in __init_db
storage = Storage(dispatcher)
File “/usr/lib/python2.6/site-packages/hamster/storage.py”, line 26, in __init__
self.run_fixtures()
File “/usr/lib/python2.6/site-packages/hamster/db.py”, line 689, in run_fixtures
self.execute(”ALTER TABLE facts add column description varchar2″)
File “/usr/lib/python2.6/site-packages/hamster/db.py”, line 506, in execute
res = cur.execute(statement, params)
sqlite3.OperationalError: duplicate column name: description
=====
[]s
April 25, 2009 at 3:28 pm
Toms
hmm, most annoying, we had this bug where elder versions where setting their version number and that caused this error.
here is how you can fix it:
First install sqlite3.
After that:
sqlite3 ~/.gnome2/hamster-applet/hamster.db “update version set version=5″
And you are good to go.
One thing to notice – please do not run previous version of hamster with this same database, because that is where the bug is.
April 25, 2009 at 4:39 pm
marfal
Just installed on Ubuntu 8.10, been testing with tracking etc.
When I try to generate a report it launches thunderbird!
Any ideas to get around this?
Nice app though.
April 25, 2009 at 4:43 pm
Toms
Hey marfal!
Go to home folder (this is where the report is generated), right click on the report html file and select properties. Check the “open with” tab. Could be that HTML files are mapped to thunderbird.
April 27, 2009 at 6:33 pm
Renato Diogo
Ok, I understood
but this compatibility across distro (fedora, ubuntu, debian, centos, archlinux), if is possible, is very interesting, but the problem is the version politic of this distros.
But great job!!! Congratulations!!!!
[]s
April 27, 2009 at 6:43 pm
Renato Diogo
Or, can I change the value from 4 to 5, and when I comeback to old version, change from 5 to 4?
[]s
April 27, 2009 at 6:55 pm
Toms
Renato – there is no reason to not work cross distros. Most of stuff does.
And i’d suggest not going back to the old version
April 29, 2009 at 6:50 pm
Brad Landis
Ubuntu doesn’t have it by default. You can follow the instructions at http://tombuntu.com/index.php/2008/08/08/hamster-time-tracking-for-gnome/
April 29, 2009 at 7:42 pm
Toms
..or you can just do
sudo apt-get install hamster-applet
May 6, 2009 at 2:59 am
Andy
Hi, great idea, I can’t get it to work:
> checking for HAMSTER… yes
> checking for gnomeapplet module… no
> configure: error: gnomeapplet Python module required to build hamster
I did all the prework of installing the various dependencies cited, after finding this error I then installed ”gnome-applets” (note the hyphen) but still no joy. ”locate” does not return ”gnomeapplet” nor does yast2 nor does Google offer a solution…
I’m on SuSE 11.1 with KDE 4.1.
Thanks in advance, Andy
May 6, 2009 at 7:51 am
Toms
Andy, i’d suggest searching help in your distro’s community. I remember there was a gnome-devel or something like that package in suse that took care of dependencies.
May 8, 2009 at 4:12 pm
Brian
I’m not sure if this is a bug in the Hamster package for Ubuntu or in GNOME, but after installing hamster-applet from the repositories, the applet is not available via “Add to Panel…” unless I first logout of GNOME and back in.
May 8, 2009 at 7:54 pm
tm
Sometimes it takes a while until it appears. Logging in and out just fastens that process.
May 12, 2009 at 5:23 pm
Blaxter
I’ve just install from source and when I try to add to the panel, it shows up the dialog saying that a problem has been found (…) delete/not delete (it happens in both branches, master and 2.26).
The funny thing is that if I run /usr/lib/hamster-applet/hamster-applet first, and then add to the panel, everything works, any ideas?
I’m on jaunty.
May 29, 2009 at 3:45 pm
Blaxter
I don’t know why, but today I try to do the same and it works
May 25, 2009 at 6:43 pm
Daniel Tamborelli Alvarenga
I’ve download and there is a bug in import GconfStore…
This is the patch…
diff –git a/hamster/KeyBinder.py b/hamster/KeyBinder.py
index 9372a8c..14a0b6e 100644
— a/hamster/KeyBinder.py
+++ b/hamster/KeyBinder.py
@@ -21,7 +21,7 @@
import gtk, gconf
import hamster, hamster.keybinder
-from hamster.Configuration import GconfStore
+from hamster.configuration import GconfStore
from hamster import dispatcher
class Keybinder(object):
May 25, 2009 at 10:20 pm
tm
Thanks for spotting Daniel, fixed the missed replace!
June 2, 2009 at 9:56 am
Vivek Kapoor
Wow – this has been an amazing package. I have started using it almost a week now and it helps track information so easily. The only gripe, the reports cannot be made based on categories or activities – they show everything. Nevertheless an excellent tool – just wow. Thank you so much for it.
June 2, 2009 at 10:00 am
Toms
Thanks Vivek, and there is bug on better reports:
http://bugzilla.gnome.org/show_bug.cgi?id=549563
June 2, 2009 at 10:04 am
Vivek Kapoor
Toms, you are too prompt! it is just wonderful! thank you for the hamster, look forward to the reports
June 2, 2009 at 4:10 pm
Mark
Oooh yer it’s good…..
Many thanks to all the developers.
Question – what command do I type in terminal to get hamster to reload the data base? At the moment I log out then back in.
June 2, 2009 at 4:13 pm
Toms
reload like in after manual DB update? You could kill python, a dialog will pop out complaining about applet died unexpectedly and such.
June 2, 2009 at 4:29 pm
Mark
Yep, that right a manual DB update, seems a bit drastic to kill python.
I was hoping a simple command would reload the hamster-app.
June 5, 2009 at 9:55 am
Mark
Is it possible to get the totals from the HTML generated report to be in HH:MM format instead of Days(24hrs):HH:MM as I find it very confusing.
Cheers
June 5, 2009 at 10:06 am
Toms
not via blog, no
June 5, 2009 at 10:16 am
Mark
Um, not sure about the blog?
I’m talking about clicking the “Generate Report” button.
“Total Time: 6:16:00″
but I’d like to read that as
“Total Time: 160:00″
June 5, 2009 at 10:26 am
Toms
I mean – how about filing a bug (before that checking that one has not been already filed yet)
http://bugzilla.gnome.org/buglist.cgi?product=hamster-applet&bug_status=UNCONFIRMED&bug_status=NEW&bug_status=ASSIGNED&bug_status=REOPENED&bug_status=NEEDINFO
June 5, 2009 at 10:47 am
Mark
OK I’ve done that, many thanks.
June 8, 2009 at 10:57 pm
JOsh Beauregard
great program.
I would like to see the ability o tag times so that i can associate them with clients and also so that i can mark them billed or not billed for
June 11, 2009 at 12:44 pm
mwic
I’m not sure how (or whether) to use DTA’s patch.. I have hamster installed on ubuntu hardy; it doesn’t appear in my “Add to Panel” options. CLI launch gives me:
Binding shortcut I to popup hamster
Running with options: {’do_trace’: False, ’standalone’: False}
When hitting Control-I:
Missing handler for event keybinding_activated
(I used gconf editor to change shortcut key to Ctl I)
also of note:
when launching in CLI, Control-C to stop the process doesn’t work.
also of note:
I have hamster running perfectly fine on another (Fedora 10) machine
June 11, 2009 at 12:51 pm
tm
Hardy is shipping 2.24, in which we had this little problem of name “hamster” not being in the applet name. Look for time tracker instead!
Ctrl+C won’t work since it is errm waiting for the applet.
June 16, 2009 at 9:18 am
Alessandro
Hi,
having some troubles with python-gtk2-dev in Ubuntu intrepid…
python-gtk2-dev: Depends: libgtk2.0-dev (>= 2.13.6)but it is not going to be installed
E: Broken packages
suggestions?
June 16, 2009 at 10:47 am
Toms
well, you have some broken packages. i’d suggest to sort it out!
June 18, 2009 at 7:53 am
Hantabaru
Hi
I’m having problems with adding the applet to lxpanel on arch (I use openbox with lxpanel).
I installed hamster using the pkgbuild system in arch (AUR) and can run it in a window using “/usr/lib/hamster-applet/hamster-applet -w” however I can’t see a way to add it to the lxpanel. Usually when I run applets from the command line they show up themselves on the lxpanel.
Any help is much appreciated…
June 18, 2009 at 7:56 am
Hantabaru
If it is any help. Running “/usr/lib/hamster-applet/hamster-applet” from a terminal gives:
(hamster-applet:4559): Gtk-WARNING **: Unable to locate theme engine in module_path: “thinice”,
Data Dir: /usr/share/hamster-applet
SELECT version FROM version None
select count(*) from categories None
Binding shortcut H to popup hamster
** (hamster-applet:4559): WARNING **: Binding ‘H’ failed!
Running with options: {’do_trace’: False, ’standalone’: False}