Installing
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 git-core python-gnomeapplet
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
[...] Make hamster build hamster from sources [...]
[...] 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í) [...]
How do I use Hamster in Xfce? (Xubuntu 7.10/8.04/8.10)
[...] can find installation guide from Hamster web site or from [...]
[...] Getting and installing [...]
[...] 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 [...]
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!
Thanks Richard!
All activities are stored in single file:
~/.gnome2/hamster-applet/hamster.db
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.
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?
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)
Hi,
How can I install Hamster to my computer?
I have Window XP
Project Hamster doesn’t work on windows yet, Kambiz. And we don’t have plans yet to make that happen.
Hello,
Hamster looks very promising!
Is there an easy way to install Hamster on Debian Etch?
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.
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
thanks Eric, comments as yours make me happy, heheh
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?
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.
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
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.
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.
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.
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
Or, can I change the value from 4 to 5, and when I comeback to old version, change from 5 to 4?
[]s
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
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/
..or you can just do
sudo apt-get install hamster-applet
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
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.
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.
Sometimes it takes a while until it appears. Logging in and out just fastens that process.
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.
I don’t know why, but today I try to do the same and it works
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):
Thanks for spotting Daniel, fixed the missed replace!
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.
Thanks Vivek, and there is bug on better reports:
http://bugzilla.gnome.org/show_bug.cgi?id=549563
Toms, you are too prompt! it is just wonderful! thank you for the hamster, look forward to the reports
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.
reload like in after manual DB update? You could kill python, a dialog will pop out complaining about applet died unexpectedly and such.
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.
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
not via blog, no
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″
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
OK I’ve done that, many thanks.
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
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
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.
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?
well, you have some broken packages. i’d suggest to sort it out!
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…
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}
Any chance of a Mac port (native or via MacPorts or Fink)? PC broke and got a macbook, but I miss Hamster… Thanks!
oooh, well if somebody will do it, then of course there is a chance. i have no plans and i don’t know of anybody working on it yet.
but hey – patches are welcome!
Toms, please add ‘git-core’ to the list of required packages to install the development version. Users are prompted to download when getting the source from git anyway, but….
Thanks Charles – fixed!
Hi Tom,
Is there a log file that hamster errors would go to? Sometimes after I leave my computer awhile and come back, then I’ll try to put in a new task, but after like a minute the task just reverts and says “No Activity”. I tried running it standalone and I don’t get a problem, so next time it happens in the applet version I was wondering what file to tail to see if there is an error message.
i’m afraid we don’t have a log file. code wise though there is not much difference when you add it as an applet and when it runs from the console.
could you maybe check if the bug exposes itself in the recent 2.26 branch or with git master (i’d say running bleeding edge hamster is pretty harmless)?
I installed the latest on master yesterday and have seen the problem occur already. Right now I’m running it standalone to see if I can get the problem to occur. Yesterday I was able to workaround the issue, by removing the applet and re-adding it, but today I wasn’t able to re-add it after removing, but re-adding it might work after a system restart. The problem might be related to my system not sending the right signals to hamster when I go idle as my screen saver does not always turn on when I leave, but my icon goes from available green circle to idle red triangle, so I’m sure what the issue is.
if you are running debian testing or anything that is featuring gnome-screensaver 2.26+ (there was no 2.26 AFAIK), then please update your hamster checkout – changes in screensaver prevented hamster to check when computer goes idle.
since we are not in windows, an add/remove of applet or simply running “killall gnome-panel” in terminal is more than enough. system restart might be good for kernel updates or whatnot, but certainly won’t do any good to hamster.
hmmm. now that i think of it. the mentioned fix could also have fixed those drive-by activity killers
so please try to git pull on master and see how it goes!
I’m running Ubuntu Jaunty and my gnome-screensaver is
Version: 2.24.0-0ubuntu6
I only sometimes pull in an item from the ubuntu-proposed repository.
I also run xmonad as my window manager.
I pulled latest and installed. When I rebooted my applet that i had been trying to add back was there. I’ll let you know how it goes, it usually starts fine, but when I leave and come back has problems so might take some time to reproduce or verify fixed.
The latest fix seems to be working well for me so far, I was able to leave and come back a few times, suspended my computer all night, used it today, leaving and coming back a few times and it has worked every time.
Still working after a few days, Thanks!
Is there any possibility to use it with KDE 4.3? Or something similiar (easy to use, ktracker is too much clicking tool
I can’t build from source, I get this error:
checking whether /usr/lib/python2.5 version >= 2.4… configure: error: too old
I have python 2.5 and 2.6 installed
hmm, could it be that you have an older python running around set as default?
You can try to run ‘python –version’ and see what it prints out.
Apart from that we are in the world of autotools, don’t know much about them really
Maybe try to get some help from the guys of your distro?
I have 14 computers all the same architecture all running suse 11.1
I’ve used one of them to compile hamster, and it works very well for what I need. The problem is It’ s not easy to attach these pcs to the internet (here at work) and I was hoping you could shed some light as to how I may transfer the installed files from one pc to the others.
or somehow make a package for suse 11.1 using the one computer I have it on.
Thanks for any suggestions,
Andre
you might just drag the compiled source folder around and do “sudo make install” on each of them. I think there is also a package for suse. No idea when they will be releasing new version with the upcoming gnome 2.28 though..
Thanks for this project — really fits my needs.
I’m running into trouble compiling the latest version from source. On Ubuntu 8.10, I get the following messages from the autogen.sh script:
Please add the files
codeset.m4 gettext.m4 glibc21.m4 iconv.m4 isc-posix.m4 lcmessage.m4
progtest.m4
from the /aclocal directory to your autoconf macro directory
or directly to your aclocal.m4 file.
You will also need config.guess and config.sub, which you can get from
ftp://ftp.gnu.org/pub/gnu/config/.
Please advise.
Hey Lew!
Those lines are just warnings and have been there ever since. Unless you hit something else, you should be fine.
You can always try to remove any generated files (git clean -f), repeat the apt-get line to make sure that you have the packages and then do the autogen bit again!
How can I get this to work under Xfce? Running it manually with -w works, but I don’t think there’s any way to put it in the panel from there…
as far as i know, xfce has a meta-applet to add gnome applets to desktop.
Great program! I’m using it on my laptop and want to get it working on my desktop, but things arn’t going so smoothly. Desktop is Ubuntu 8.10 and I’m trying the instructions to get the up-to-date version. Everything installs nicely, but when I try to add hamster to my panel nothing happens. Running:
/usr/lib/hamster-applet/hamster-applet -w
gets me:
Binding shortcut H to popup hamster
(hamster-applet:6619): Bonobo-WARNING **: Can’t find ‘Hamster_Applet.xml’ to load ui from
Traceback (most recent call last):
File “/usr/lib/hamster-applet/hamster-applet”, line 119, in
applet_factory(applet, None)
File “/usr/lib/hamster-applet/hamster-applet”, line 56, in applet_factory
hamster_applet = HamsterApplet(applet)
File “/usr//lib/python2.5/site-packages/hamster/applet.py”, line 230, in __init__
self._gui = stuff.load_ui_file(“applet.ui”)
File “/usr//lib/python2.5/site-packages/hamster/stuff.py”, line 38, in load_ui_file
ui.add_from_file(os.path.join(runtime.data_dir, name))
glib.GError: Failed to open file ‘/usr/lib/python2.5/site-packages/data/applet.ui’: No such file or directory
Any suggestions?
hmm, you seem to have mix of both.
please try to run
sudo ./bye-hamster.sh
in hamster checkout folder followed by
sudo make install
and try again
Still no go. I went back and made sure to run
>sudo apt-get remove hamster-applet
and also ran
>sudo apt-get autoremove
I even erased everything, re-git the file and started from the very beginning again. When I try to add the applet to my desktop nothing happens and running it in window mode still gives me the error above
well, the error is because it looks for data files where they are not. i’m not sure what it could be connected to.
Hi again,
So I finally bit the bullet and upgraded to Ubuntu 9.04. Doing that and installing:
>sudo apt-get install gnome-devel
seems to have worked for me. Thanks again for the help and I just want to say again that this is a fantastic piece code you’ve wrote. I use it to keep track of my work day and it’s really helping me manage my time better.
I do have one last issue though… So I’m using Hamster on both my office desktop and my personal laptop. I’m syncing the hamster.db file using unison. The problem is that the applet loads up automatically when I turn on my laptop. Then I sync my laptop to my desktop, but hamster doesn’t read the database. I have to remove hamster from my desktop panel, kill the python process and then add it to my panel again for it to read in the newly sync’ed *.db file. Is there an easier way to do this?
Thanks
you could just kill the python process.
Cool! That’s exactly the insider info I need. Now I’m off to write a short python script to ps aux my system and kill the python process for me. Then I can toss that in my desktop panel. Thanks again for all the help!
-YH
Trying Ubuntu 9.10, have installed Hamster from repo (V2.28.0).
How do I change the db location on this version of Hamster?
My db is located in my “Dropbox” so that it is backed up
$”~/Dropbox/hamster-applet”
(in-case of lose or theft of netbook).
I can’t see how to redirect hamster to look at that location, previous versions I just edited
“/usr/lib/python2.6/dist-packages/hamster/_init_.py”
Is it possible for future versions to have an option for db location please?
Cheers
Mark
Is it possible to use Hamster applet with AWN (Avant Windows Navigator)?
If yes, how would I add launcher to AWN panel? Thanks in advance.
Hello,
i’m using hamster every day, it’s really cool!
But i have a problem with it – i can’t see any color on any bar
http://www.ubuntu-pics.de/bild/30769/screenshot_033_4FUw9C.png
Is it normal? How can i fix it?
I’ve used 2.28.1 from latest ubuntu, and a compiled one (2.29.1).
bug 599343
I see that for every release there are links to the deb packages. I really appreciate it, but: the links seem to not work (page not found, no permission for the page, …)
Any suggestion for this?
A second request: why not to update the repository? It can be very handy!
Thanks
i’m not sure where you are looking. as hamster now is part of gnome, it should be available via the package manager of your distribution.
Yes, it is, but not the latest version…