Hamster Gnome Shell extension
A Simple Hamster shell extension for Gnome 3.
Important: Testers needed
One of the main reasons development on this extension is slow is that there is hardly any testing for feature/bugfix branches. As automated tests are not really an options we would love to hear from you if you would be willing to take new feature branches for a test drive and provide some feedback every now and then. Please get in touch!
Quick categorization of activities is done by entering your activity in the following format: 'activity@category, description #tag1 #tag2', where the comma is mandatory when adding a description and/or tag(s).
Because Hamster-Shell-Extension is just a frontend to the hamster dbus
service the presence of hamster-time-tracker is required. You can verify that
the relevant dbus services are up and running by issuing
ps aux | grep
hamster which should bring up
Install For Production
The extension is available on the central extension repository.
Current compatible Gnome shell version: 3.28 For previous shell versions check releases.
Creating a development environment
hamster-shell-extension is mainly simple JS there is not much of a development
setup needed if you just want to get hacking right away. We do however provide
a few convenience functionalities that make documenting and releasing the extension
easier. For those purposes some additional python packages are required.
The easiest and cleanest way to go about this is to create a new virtual environment and activate
python3 -m venv .venv source .venv/bin/activate
Now you are all setup to run
make develop and related make targets without
changing you main environment.
Manual Installation For Testing and Development
Clone the repository:
git clone https://github.com/projecthamster/hamster-shell-extension.git
Make sure you are on the development branch:
git checkout develop
Build a fresh distribution package:
This will create a distributable archive.
You can now use the
tweaktool (at the bottom of the
to install and activate the new
zip file located in the
Alternatively you just can unpack the tar archive to
As a result, a directory named
firstname.lastname@example.org should be there now.
After that you can enable the extension and change the preferences using Tweak
Tool, or on