{"id":16711446,"url":"https://github.com/kuabem/stempel","last_synced_at":"2025-04-10T05:40:30.390Z","repository":{"id":37851852,"uuid":"126458782","full_name":"KuabeM/stempel","owner":"KuabeM","description":"Command line utility to keep track of time spent working","archived":false,"fork":false,"pushed_at":"2024-01-14T21:01:53.000Z","size":182,"stargazers_count":5,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2024-03-15T01:20:15.556Z","etag":null,"topics":["cli","rust","time-tracker"],"latest_commit_sha":null,"homepage":"https://crates.io/crates/stempel","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/KuabeM.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"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":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-03-23T08:55:44.000Z","updated_at":"2024-06-01T13:10:30.973Z","dependencies_parsed_at":"2024-01-14T13:48:00.214Z","dependency_job_id":"ec4ab705-074a-42e5-9459-2cf4479fef50","html_url":"https://github.com/KuabeM/stempel","commit_stats":{"total_commits":107,"total_committers":3,"mean_commits":"35.666666666666664","dds":0.3271028037383178,"last_synced_commit":"931c7e93cc9b6fccf95003ac176d1ee4cde6322d"},"previous_names":[],"tags_count":24,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KuabeM%2Fstempel","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KuabeM%2Fstempel/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KuabeM%2Fstempel/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/KuabeM%2Fstempel/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/KuabeM","download_url":"https://codeload.github.com/KuabeM/stempel/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248166120,"owners_count":21058474,"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":["cli","rust","time-tracker"],"created_at":"2024-10-12T20:12:02.094Z","updated_at":"2025-04-10T05:40:30.360Z","avatar_url":"https://github.com/KuabeM.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Stempel\n\n[![Build](https://img.shields.io/github/actions/workflow/status/KuabeM/stempel/build_master.yml)](https://github.com/KuabeM/stempel/actions?query=workflow%3Abuild-master)\n[![Crates.io](https://img.shields.io/crates/v/stempel.svg)](https://crates.io/crates/stempel)\n[![AUR](https://img.shields.io/aur/version/stempel-bin)](https://aur.archlinux.org/packages/stempel-bin)\n\nSmall utility to store and calculate the time spent at work.\n\n\u003e :warning: v0.10.0 introduces a new storage file format. Run `stempel migrate`\n\u003e to update your json database to the new format.\n\n## Usage\n\nExample for managing one day:\n\n```bash\n# First of, configure some settings\nstempel configure\n# start working now\nstempel start\n# start a break five minutes ago\nstempel break start --offset 5m-\n# optional: break can be canceled:\nstempel cancel\n# finish break in one hour (only if not canceled above)\nstempel break stop --offset 1h+\n# Finish the day\nstempel stop\n# Alternatively, you can specify the time point to stop as a time in 24h format\nstempel stop --time 17:38\n```\n\nFor a detailed reference, run `stempel help` or `stempel SUBCOMMAND --help`.\nAvailable subcommands are:\n\n  - `cancel`s the last break, start or does nothing if no break or start in the\n    storage,\n  - `break`: use `start` or `stop` as subcommand to handle breaks,\n  - `migrate`: migrate storage file from old (before 0.10.0) to new format\n    (since v0.10.0)\n  - `start`: start a working period, aborts if you already started previously,\n  - `stats` prints current statistics.\n  - `stop`: checks if a `start` entry is in the storage `file` and calculates\n    the working time, aborts if no `start` entry is found,\n  - `configure`: set some defaults for stempel and save them alongside the\n    database file. Currently available:\n    * number of months printed by the statistic command\n    * number of hours to work per day\n\n# Completions\n\nRun `stempel completions --shell \u003cshell\u003e` to get a shell completion file, e.g. `stempel completions\n--shell zsh` for zsh. Source this file according to your specific shell.\n\n```zsh\nsource \u003c(stempel completions --shell zsh)\n```\n\n### Options:\n\n#### `--offset`\n\nThis option allows to specify a positive or negative offset to the current time.\nIn other words, giving the option `--offset 10m+` means that the command is\nexecuted with the current time plus 10 minutes, `20s-` stands for current time\nminus 20 seconds. The syntax allows `[Xh][Xm][Xs](+-)` where `X` can be any\nnumber and `h|m|s` refer to hours, minutes and seconds, respectively. Overridden\nby `--time`below.\n\nSome examples:\n\n  - `2h30m4s+`: 2 hours, 30 minutes, 4 seconds from now\n  - `1h90s-`: 1 hour 90 seconds before now\n  - `20m30s+`: 20 minutes, 30 seconds from now\n  - `60s-`: one minute before now\n\n#### `--time`\n\nThis options allows to specify a time for the respective action. Use it if you\nwant to start or stop at a certain time. The format is `HH:MM` in 24h where the\ndate is set to the current day, e.g. `13:47` means today at `13h 47`.\n\n#### `--storage`\n\nSpecify a path to the storage file where all work entries are written to. The\npath defaults to `$HOME/.config/stempel.json` and is created on the first\ninvocation of the `start` subcommand.\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuabem%2Fstempel","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkuabem%2Fstempel","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkuabem%2Fstempel/lists"}