{"id":27290971,"url":"https://github.com/projecthamster/hamster-gtk","last_synced_at":"2025-06-11T02:03:30.035Z","repository":{"id":57436652,"uuid":"46660382","full_name":"projecthamster/hamster-gtk","owner":"projecthamster","description":"A GTK3 time tracker. Powered by 'hamster-lib'","archived":false,"fork":false,"pushed_at":"2021-08-10T02:18:51.000Z","size":666,"stargazers_count":116,"open_issues_count":75,"forks_count":18,"subscribers_count":10,"default_branch":"develop","last_synced_at":"2025-05-12T19:49:33.256Z","etag":null,"topics":["floss","gnome","gtk","gui","python","time-tracker"],"latest_commit_sha":null,"homepage":"http://projecthamster.org","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/projecthamster.png","metadata":{"files":{"readme":"README.rst","changelog":"HISTORY.rst","contributing":"CONTRIBUTING.rst","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-11-22T12:50:42.000Z","updated_at":"2024-04-22T17:30:53.000Z","dependencies_parsed_at":"2022-09-09T22:50:15.857Z","dependency_job_id":null,"html_url":"https://github.com/projecthamster/hamster-gtk","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-gtk","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-gtk/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-gtk/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-gtk/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projecthamster","download_url":"https://codeload.github.com/projecthamster/hamster-gtk/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-gtk/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259184731,"owners_count":22818265,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["floss","gnome","gtk","gui","python","time-tracker"],"created_at":"2025-04-11T21:39:46.700Z","updated_at":"2025-06-11T02:03:30.008Z","avatar_url":"https://github.com/projecthamster.png","language":"Python","funding_links":[],"categories":["Productivity"],"sub_categories":["Timers / Time Tracking"],"readme":"===============================\nhamster-gtk\n===============================\n\n.. image:: https://img.shields.io/pypi/v/hamster-gtk.svg\n        :target: https://pypi.python.org/pypi/hamster-gtk\n\n.. image:: https://img.shields.io/travis/projecthamster/hamster-gtk/master.svg\n        :target: https://travis-ci.org/projecthamster/hamster-gtk\n\n.. .. image:: https://readthedocs.org/projects/hamster-gtk/badge/?version=latest\n        :target: https://readthedocs.org/projects/hamster-gtk/?badge=latest\n        :alt: Documentation Status\n\n\nA GTK interface to the hamster time tracker.\n\n**IMPORTANT**\nAt this early stage ``hamster-gtk`` is pre-alpha software. As such you are very\nwelcome to take it our for a spin and submit feedback, however you should not\nrely on it to work properly and most certainly you should not use it in a\nproduction environment!\nYou have been warned.\n\nDependencies\n-------------\n\nIf you want to use the ``make register-gnome`` target ``desktop-file-install``\nis required. On debian derivates this is provided by ``desktop-file-utils``.\n\nInstalling from sources:\n~~~~~~~~~~~~~~~~~~~~~~~~\n- xmllint (Needed in order to call ``resources`` make target. On debian this is\n  part of the ``libxml2-utils`` package.\n\nTo Run the Testsuite\n~~~~~~~~~~~~~~~~~~~~~\n- make\n- xvfb\n\nFirst Steps\n------------\n* Install dependencies (on debian if using virtualenvwrapper):\n  install ``virtualenvwrapper python-gi gir1.2-gtk-3.0 libglib2.0-dev\n  libgtk-3-dev``.\n  If you use python 3, you will need ``python3-gi`` instead.\n* Create new virtual env: ``mkvirtualenv hamster-gtk``\n* Activate env: ``workon hamster-gtk``\n* Activate system site dirs: ``toggleglobalsitepackages``. Otherwise you will\n  have no access to Gtk.\n* Install ``hamster-gtk``: ``pip install hamster-gtk``.\n* Run the little furball: ``hamster-gtk``\n\nSome notes:\n\n* Preference changes will only be applied at the next start right now.\n* Exported data is tab separated.\n* This is pre-alpha software!\n\nHow to run the testsuite\n-------------------------\n- Create a virtual environment ``mkvirtualenv hamster-gtk`` (python 2) or\n  ``mkvirtualenv -p python3 hamster-gtk`` (python 3). Whilst those instructions\n  do not reflect best practices (which would make use of python 3's built in\n  venv) it does provide a better handling of ``system-site-packages``.\n  `This issue \u003chttp://bugs.python.org/issue24875\u003e`_ provides some context for\n  the problems one may run into using ``system-site-packages`` with python3\n  venvs. It is our hope that python 3.7 will fix this.\n- enable access to system-site-packages for our virtual environment:\n  ``$ toggleglobalsitepackages``. This is needed to access our global GTK\n  related packages.\n- Install development environment: ``make develop``.\n- To run the actual testsuite: ``make test``.\n- To run tests and some auxiliary style checks (flake8, pep257, etc):\n  ``make test-all``.\n\nRight now, our actual code testing does not utilize ``tox`` as we keep running\ninto segfaults (which does not happen without ``tox``).\nFor  this same reason we are currently unable to run our code tests on Travis\nas well (we still run the 'style checks' at least).\nWe hope to get to the bottom of this at some point and would be most grateful\nif you have any hint or pointer that may help tracking down this issue.\n\nMigrating from 'legacy hamster'\n---------------------------------\nIn case you are wondering “Will I be able to continue using my ‘legacy\nhamster’ database with this rewrite?” the answer is “yes and no.” This new\nversion of hamster significantly raises the standard in terms of data\nconsistency. Unlike before, it will not be possible to have “Facts” without\nan end time specified, nor to have multiple facts overlapping.\n\nThere will be a way to import data that still constitute valid “facts” (having\nboth a start and an end time). We have, however, not decided on how this will\nbe implemented, nor what to do with the legacy “facts” that do not have\nan end time.\n\nThe general timeline for addressing the actual implementation is: once we are\nfeature freezing in preparation of release 1.0.0 as part of a more general\npre-release cleanup effort.\n\nWhilst possible, it is unlikely we will have the resources to provide a fancy\nlooking GUI to resolve migration conflicts (unless someone new pitches in of\ncourse) so the result will most likely be a migration script of some sort.\n\nIf you are interested in this general issue, please feel free to watch the\n`epic issue for\n\"hamster-lib\" \u003chttps://projecthamster.atlassian.net/browse/LIB-12\u003e`_ that\ncovers all things relevant.\n\nNews: Version 0.11.0\n----------------------\nThis release introduces refines various aspects of your *Hamster-GTK*\nexperience. Whilst we introduce no new major dialogs (just a simple\nabout-dialog). We catch up with the lastest version of ``hamster-lib``,\n``0.12.0``. The most noteworthy change for user is probably the ability to use\nwhitespaces with your ``Activity.name``. Besides that we fixed some rather\nanoying bugs as well as continued to refine the codebase. All in all, while\nstill not big on features, this release should feel much more stable and\nreliable. This is not the least due to multiple contributions by ``jtojnar``,\nthanks for that! As ususal, for more changes and details, please refer to the\nchangelog. Happy tracking; Eric.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojecthamster%2Fhamster-gtk","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojecthamster%2Fhamster-gtk","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojecthamster%2Fhamster-gtk/lists"}