{"id":40402067,"url":"https://github.com/hicknhack-software/redmine_hourglass","last_synced_at":"2026-01-20T13:35:20.647Z","repository":{"id":46380451,"uuid":"91352473","full_name":"hicknhack-software/redmine_hourglass","owner":"hicknhack-software","description":"New Redmine plugin to enhance the time tracking abilities, reports and REST-API.","archived":false,"fork":false,"pushed_at":"2025-11-01T23:50:10.000Z","size":2283,"stargazers_count":80,"open_issues_count":35,"forks_count":30,"subscribers_count":15,"default_branch":"develop","last_synced_at":"2025-11-02T01:18:59.974Z","etag":null,"topics":["redmine-plugin","reports","time-tracker"],"latest_commit_sha":null,"homepage":null,"language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/hicknhack-software.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":null,"code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":"COPYRIGHT.txt","agents":null,"dco":null,"cla":null}},"created_at":"2017-05-15T15:16:45.000Z","updated_at":"2025-11-01T23:50:14.000Z","dependencies_parsed_at":"2023-12-13T13:42:55.643Z","dependency_job_id":"d9aa5de4-251f-428c-a98f-6614f7d057c7","html_url":"https://github.com/hicknhack-software/redmine_hourglass","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/hicknhack-software/redmine_hourglass","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hicknhack-software%2Fredmine_hourglass","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hicknhack-software%2Fredmine_hourglass/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hicknhack-software%2Fredmine_hourglass/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hicknhack-software%2Fredmine_hourglass/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/hicknhack-software","download_url":"https://codeload.github.com/hicknhack-software/redmine_hourglass/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/hicknhack-software%2Fredmine_hourglass/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28603807,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-20T12:01:53.233Z","status":"ssl_error","status_checked_at":"2026-01-20T12:01:46.545Z","response_time":117,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["redmine-plugin","reports","time-tracker"],"created_at":"2026-01-20T13:35:20.576Z","updated_at":"2026-01-20T13:35:20.627Z","avatar_url":"https://github.com/hicknhack-software.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Redmine Hourglass Plugin\n[![Code Climate](https://codeclimate.com/github/hicknhack-software/redmine_hourglass.png)](https://codeclimate.com/github/hicknhack-software/redmine_hourglass)\n[![Build Status](https://github.com/hicknhack-software/redmine_hourglass/workflows/Specs/badge.svg)](https://github.com/hicknhack-software/redmine_hourglass/actions?query=workflow%3ASpecs)\n[![Join the chat at https://gitter.im/hicknhack-software/redmine_hourglass](https://badges.gitter.im/hicknhack-software/redmine_hourglass.svg)](https://gitter.im/hicknhack-software/redmine_hourglass?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge\u0026utm_content=badge)\n\nHourglass is a Redmine plugin to aid in tracking spent time on projects and issues. It allows users to start / stop a timer with an optional reference to what they are working on.\n\nIt allows various queries for time entries as well as possibilities to update existing entries.\n\nHourglass can be configured on a global base as well as per project.\n\nSee [CHANGELOG.md](CHANGELOG.md) for the latest features.\n\n\n## Migrate from old Time Tracker plugin\n\n_Note: This is a complete rewrite of the [Redmine Time Tracker Plugin](https://github.com/hicknhack-software/redmine_time_tracker). While it has feature parity (atleast we hope we didn't forget anything), the code base has changed positively, so further additions are no longer a pain to do._\n\n___To ease migrating we added a function to import time entries from the redmine_time_tracker. You can find this in the plugin settings and as a rake task. For more information about migrating from the old time tracker take a look on the [Migration Guide](https://github.com/hicknhack-software/redmine_hourglass/wiki/Migration-Guide)___\n\n\n## Companion App\n\nWe made an app to ease use of the time tracker on mobile (android only for now), check it out:\n\n- [Hourglass for Android](https://play.google.com/store/apps/details?id=hnh.software.hourglass)\n\nThe Binaries are made available as downloads in the [Releases](https://github.com/hicknhack-software/redmine_hourglass/releases) section\n\n\n## Features\n\n- Per user time tracking\n- Integrates well with Redmine by reusing time entries\n- Overview of spent time for users\n- Track project unrelated time\n- Book tracked time on issues\n- Detailed statistics for team management\n- Status monitor of currently running trackers\n- Detailed list views with Redmine queries integrated\n- Report generation for projects with graphical time representation with customizable company logo\n- Project specific settings\n\n\n## Requirements\n\n* Ruby 3.3.7\n* Redmine 6.0.x (The only version fully tested! - Try older versions of the plugin for older versions of Redmine.)\n* An [ExecJS](https://github.com/sstephenson/execjs) compatible runtime, the gemfile includes [therubyracer](https://github.com/cowboyd/therubyracer) for unix based systems and windows ships with a default js interpreter (from Win 7 upwards), so most people should be set. If you happen to have problems like for example [#29](https://github.com/hicknhack-software/redmine_hourglass/issues/29), take a look on the linked ExecJS and install one of the mentioned runtimes.\n\nSee [.github/workflows/main.yml](.github/workflows/main.yml) for details about supported versions.\nIf a newer version doesn't appear in there, feel free to open an issue and report your experience with that Redmine or Ruby version.\n\n\n## Installation\n\n1. If you use Mysql please make sure you have the timezone details loaded, otherwise you miss a lot of nice features.\n   ```bash\n   sudo mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root -p mysql\n   ```\n1. Place the source code of this plugin at the `plugins/redmine_hourglass` folder.\n   Either by:\n    - Download a release from [Releases](https://github.com/hicknhack-software/redmine_hourglass/releases) and extract it into your Redmine.\n    - Or clone the repository:\n        ```bash\n        git clone https://github.com/hicknhack-software/redmine_hourglass.git plugins/redmine_hourglass\n        ```\n1. Install required Gems by:\n    ```bash\n    bundle install\n    ```\n1. Update the database schema by running the following command from the root of Redmine:\n    ```bash\n    bundle exec rake redmine:plugins:migrate RAILS_ENV=production\n    ```\n1. Precompile the assets.\n    - If your Redmine is accessed with a path on your domain, like `www.example.com/redmine` use this option:\n        ```bash\n        bundle exec rake redmine:plugins:hourglass:precompile RAILS_ENV=production RAILS_RELATIVE_URL_ROOT=/redmine\n        ```\n    - If your Redmine is on the root you might simply run:\n        ```bash\n        bundle exec rake redmine:plugins:hourglass:precompile RAILS_ENV=production\n        ```\n    - Note: The task changed for Redmine 5+, as we no longer have a global `redmine:plugins:assets` task.\n1. (Re)start your Redmine\n1. Done. *Please read the \"First time usage\" section below.*\n\n\n## Update\n\nThe process is roughly the same as installing. Make sure you have the desired version in the `plugins` directory and run the steps above (except 1).\n\nIf you had it installed via git before, the first step is simply doing `git pull` in the `plugins/redmine_hourglass` directory.\n\n\n## First time usage\n\n1. Login as an administrator and setup the permissions for your roles\n    - developers should have the rights to track time\n\n      ![Developer Rights](doc/images/DeveloperRights.png)\n\n    - managers should have the rights to fix times\n\n      ![Manager Rights](doc/images/ManagerRights.png)\n\n1. Enable the \"Hourglass\" module for your project\n    - works well in combination with the built in `Time tracking`\n\n      ![Project Modules](doc/images/ProjectModules.png)\n\n1. You should now see the Time Tracking link in the top menu.\n\nTo track time directly on an issue, you can use the context menu (right click in the issues list) in\nthe issue list to start or stop the timer or press the \"Start Tracking\" button on the top right, next to the default \"Book Time\" Redmine button.\n\n\n### What's what?\n\nThe plugin is intended to help us create invoices for customers. This requires the separation of time that was spent and time that is booked. Only booked times can be billed.\nMore information are available in the [wiki](http://github.com/hicknhack-software/redmine_hourglass/wiki).\n\n#### Time Tracker\n\nThe stop watch. Time you spent gets \"generated\" by the trackers.\n\n#### Time Log\n\nA time log is a spent amount of time. If you stop the tracker, a time log is created. A time log has nothing attached to it. To add this time to issues or projects, you **book** time.\nRole permissions can be edited to disable logging. This might be useful for reviewers, that do not generate time on their own but want to look up statistics on a project or user.\n\n#### Time Booking\n\nA booking is time that is actually connected to a task (project or issue). To create a booking, you book time from a time log. You are not limited to spent the whole time of a single booking, you can divide as you wish. You however aren't able book more time than what was actually logged. The role you have on projects and their settings determine if you are able to edit bookings or are just allowed to create them.\n\n#### Settings\n\nThe plugin offers a list of settings at the Redmine roles and permission settings page. Also you can set the size and file for a logo to be displayed at the report in the Redmine plugin settings, enable rounding behaviour and interval as well as snapping percentage. You can also refine this settings per project if you have different accounting rules per project.\n\n![Project Settings](doc/images/ProjectSettings.png)\n\n\n## Contributing\n\nBug reports and pull requests are welcome on [GitHub](https://github.com/hicknhack-software/redmine_hourglass). Please check the [contribution guide](CONTRIBUTING.md).This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to our [code of conduct](CODE_OF_CONDUCT.md).\n\n\n## License\n\nThe plugin is available released under the terms of [GPL](https://www.gnu.org/licenses/gpl).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhicknhack-software%2Fredmine_hourglass","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhicknhack-software%2Fredmine_hourglass","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhicknhack-software%2Fredmine_hourglass/lists"}