{"id":27290969,"url":"https://github.com/projecthamster/hamster-shell-extension","last_synced_at":"2025-05-16T06:05:21.901Z","repository":{"id":1032669,"uuid":"2049065","full_name":"projecthamster/hamster-shell-extension","owner":"projecthamster","description":"Shell extension for hamster","archived":false,"fork":false,"pushed_at":"2025-03-14T16:06:03.000Z","size":599,"stargazers_count":218,"open_issues_count":42,"forks_count":92,"subscribers_count":21,"default_branch":"develop","last_synced_at":"2025-04-11T21:44:23.234Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"http://projecthamster.org","language":"JavaScript","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,"governance":null,"roadmap":null,"authors":"AUTHORS.rst","dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2011-07-14T18:51:32.000Z","updated_at":"2025-03-14T16:06:08.000Z","dependencies_parsed_at":"2025-04-11T21:39:50.464Z","dependency_job_id":"30155c0f-1742-4517-b910-3665a6ae934d","html_url":"https://github.com/projecthamster/hamster-shell-extension","commit_stats":{"total_commits":310,"total_committers":51,"mean_commits":6.078431372549019,"dds":0.7064516129032259,"last_synced_commit":"ed710a709ce166cfd3e15d836e82008e253e01ca"},"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-shell-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-shell-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-shell-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/projecthamster%2Fhamster-shell-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/projecthamster","download_url":"https://codeload.github.com/projecthamster/hamster-shell-extension/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254478187,"owners_count":22077676,"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":[],"created_at":"2025-04-11T21:39:45.432Z","updated_at":"2025-05-16T06:05:21.840Z","avatar_url":"https://github.com/projecthamster.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"Hamster Gnome Shell extension\n===============================\n\nA Simple Hamster shell extension for Gnome 3.\n\nImportant: Testers needed\n-------------------------\nOne of the main reasons development on this extension is slow is that there is\nhardly any testing for feature/bugfix branches. As automated tests are not\nreally an options we would love to **hear from you** if you would be willing to\ntake new feature branches for a test drive and provide some feedback every now\nand then. **Please get in touch!**\n\nUsage\n-----\nQuick categorization of activities is done by entering your activity in the\nfollowing format: 'activity@category, description #tag1 #tag2', where the comma\nis mandatory when adding a description and/or tag(s).\n\nInstall\n--------\n\nDependencies\n~~~~~~~~~~~~\nBecause *Hamster-Shell-Extension* is just a frontend to the hamster dbus\nservice the presence of `hamster-time-tracker\n\u003chttps://github.com/projecthamster/hamster\u003e`_ is required. You can verify that\nthe relevant dbus services are up and running by issuing ``ps aux | grep\nhamster`` which should bring up ``hamster-service`` and\n``hamster-windows-service``.\n\nInstall For Production\n~~~~~~~~~~~~~~~~~~~~~~\n\nPlease follow the instructions under\n`Manual Installation For Testing and Development`_ below to install from git.\nSee `metadata.json.in`_ for GNOME shell compatibility status of the current branch.\n\n*Important:* The \"Hamster Time Tracker\" extension on\n`extensions.gnome.org https://extensions.gnome.org/extension/425/project-hamster-extension/`_\nis *severely outdated*; it supports GNOME shell up to 3.20 only. There are\nsome other versions of this extension on extensions.gnome.org, but none of\nthem is supported by the current maintainers of the extension.\n\n.. _metadata.json.in: data/metadata.json.in\n\nManual Installation For Testing and Development\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nClone the repository::\n\n    git clone https://github.com/projecthamster/hamster-shell-extension.git\n\nMake sure you are on the development branch::\n\n    git switch -c develop origin/develop\n\nTo make this build available locally under your user account::\n\n    make install-user\n\nTo build a fresh distribution package (this will create a distributable archive located in the ``dist/`` folder)::\n\n    make dist\n\nAfterwards, enable the extension and change the preferences using the\n*gnome-extensions* tool (on GNOME 3.34 and earlier, you need to use *gnome-tweak-tool*).\n\n\nReloading the Extension\n~~~~~~~~~~~~~~~~~~~~~~~\n\nIf the Hamster GNOME shell extension is already loaded and you change some code, \nthe GNOME shell needs to be restarted in order to update and restart the extension.\nThe easiest way to do this is to run GNOME under X11 and use the key combination\n``Alt-F2`` followed by ``r``. If you run GNOME under Wayland, either re-login, or \nstart a `nested session \u003chttps://wiki.gnome.org/Initiatives/Wayland/GnomeShell/Testing\u003e`_::\n    \n    dbus-run-session -- gnome-shell --nested --wayland\n\nChanging the extension UUID\n~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\nIt's possible to change the \"UUID\" of the extension from\n``contact@projecthamster.org`` to a name of your choice. If you do this,\nyou have to obey the `UUID Guidelines\n\u003chttps://wiki.gnome.org/Projects/GnomeShell/Extensions/UUIDGuidelines\u003e`.\nThis may become necessary in some cases if there are problems with the\nofficial UUID on `https://extensions.gnome.org`.\n\nTo change the UUID, pass it to ``make dist`` in the instructions above::\n\n    # Build\n    make dist UUID=\"my_uuid@my.domain\"\n\nThe rest of the build procedure is like above, except that you have to replace\n``contact@projecthamster.org`` by your new UUID everywhere.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojecthamster%2Fhamster-shell-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprojecthamster%2Fhamster-shell-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprojecthamster%2Fhamster-shell-extension/lists"}