{"id":18044732,"url":"https://github.com/natterstefan/toggl-zsh-plugin","last_synced_at":"2025-06-22T06:36:57.253Z","repository":{"id":89872407,"uuid":"183661039","full_name":"natterstefan/toggl-zsh-plugin","owner":"natterstefan","description":"⌚️A oh-my-zsh plugin, printing the working hours of the current week tracked in toggl.com (for OSX).","archived":false,"fork":false,"pushed_at":"2019-04-26T19:13:18.000Z","size":8,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-10T01:14:22.070Z","etag":null,"topics":["cli","timetracker","timetracking","toggl","toggl-plugin","zsh","zsh-plugin"],"latest_commit_sha":null,"homepage":"https://github.com/natterstefan/toggl-zsh-plugin/blob/master/README.md","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/natterstefan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null},"funding":{"github":["natterstefan"],"patreon":"natterstefan","custom":["https://www.paypal.me/natterstefan","https://www.buymeacoffee.com/natterstefan"]}},"created_at":"2019-04-26T16:26:29.000Z","updated_at":"2021-11-17T21:59:15.000Z","dependencies_parsed_at":"2023-03-13T18:03:57.353Z","dependency_job_id":null,"html_url":"https://github.com/natterstefan/toggl-zsh-plugin","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/natterstefan/toggl-zsh-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natterstefan%2Ftoggl-zsh-plugin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natterstefan%2Ftoggl-zsh-plugin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natterstefan%2Ftoggl-zsh-plugin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natterstefan%2Ftoggl-zsh-plugin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/natterstefan","download_url":"https://codeload.github.com/natterstefan/toggl-zsh-plugin/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/natterstefan%2Ftoggl-zsh-plugin/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":261249372,"owners_count":23130494,"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","timetracker","timetracking","toggl","toggl-plugin","zsh","zsh-plugin"],"created_at":"2024-10-30T18:10:30.416Z","updated_at":"2025-06-22T06:36:52.220Z","avatar_url":"https://github.com/natterstefan.png","language":"Shell","funding_links":["https://github.com/sponsors/natterstefan","https://patreon.com/natterstefan","https://www.paypal.me/natterstefan","https://www.buymeacoffee.com/natterstefan"],"categories":["Plugins"],"sub_categories":["ZSH on Windows","Zinit (née zplugin)"],"readme":"# Toggl Plugin for zsh\n\n## Features\n\n:watch: get the total working hours of the current week with the `toggl-week`\n  command:\n\n```bash\n$ toggl-week\n$ You've worked 38 hours, 55 minutes and 46 seconds this week.\n```\n\n## Installation\n\n### in your ~/.zshrc\n\n- Download [`toggl.plugin.zsh`](./toggl.plugin.zsh) or clone this repository:\n\n```bash\ngit clone https://github.com/natterstefan/toggl-zsh-plugin.git\n```\n\n- source the script **at the end** of `~/.zshrc`:\n\n```bash\nsource /path/to/toggl-zsh-plugin/toggl.plugin.zsh\n```\n\n- source `~/.zshrc` to take changes into account:\n  \n```bash\nsource ~/.zshrc\n```\n\n### with oh-my-zsh\n\n- Clone the repo in [\"Oh My ZSH\"](https://github.com/robbyrussell/oh-my-zsh)\n  plugins directory:\n\n```bash\ngit clone https://github.com/natterstefan/toggl-zsh-plugin.git ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/toggl\n```\n\n- Activate the plugin in `~/.zshrc` by adding `toggl` to the plugins section:\n\n```bash\nplugins=( [plugins...] toggl)\n```\n\n- source `~/.zshrc` to take changes into account:\n  \n```bash\nsource ~/.zshrc\n```\n\n### With antigen\n\nHaving [antigen](https://github.com/zsh-users/antigen) properly installed, just\nrun:\n\n```bash\nantigen natterstefan/toggl-zsh-plugin\n```\n\n## Setup\n\nAdd the following environment variables to your `~/.zshrc`:\n\n```bash\n# open https://toggl.com/app/workspaces. Select the workspace you want to use,\n# click on the three dots and open \"Settings\". Get the id from the URL in your\n# browser. Eg. https://toggl.com/app/workspaces/12345678/settings?\nexport TOGGL_WORKSPACE_ID=\"12345678\"\n\n# open https://www.toggl.com/app/projects and select the project(s) you want to\n# use in the report. Again copy the id from the url. In this case\n# https://www.toggl.com/app/projects/12345678/edit/98765 the id would be 98765.\n# This value can look like: \"98765\" or \"98765,43210\" for multiple project ids.\nexport TOGGL_PROJECT_IDS=\"98765\"\n\n# open https://toggl.com/app/profile and get the API token from the bottom of\n# the page\nexport TOGGL_API_TOKEN=\"eNw1y5uVyYfW3aSVhHDZCcyAZGDfvezi1DmxjVXo\"\n```\n\n## Development\n\n```bash\ngit clone https://github.com/natterstefan/toggl-zsh-plugin.git\nmkdir ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/toggl\nls -s toggl.plugin.zsh ${ZSH_CUSTOM:-~/.oh-my-zsh/custom}/plugins/toggl/toggl.plugin.zsh\n```\n\nYou are now ready to develop. After changing your code, you need to restart the\nterminal or source `~/.zshrc` again. Don't forget to remove the symlink, in case\nyou start from [Installation](#Installation) again.\n\nIf this does not work, I recommend to create `tmp/test.sh` and make it\nexecutable. Then copy and paste the code from [`toggl.plugin.zsh`](./toggl.plugin.zsh)\ninto the file. Now, make changes and test it with `./tmp/test.sh`. Once you are\ndone, copy the code back into [`toggl.plugin.zsh`](./toggl.plugin.zsh).\n\n## Links\n\n- [Oh My ZSH!](https://ohmyz.sh/)\n- [Oh My ZSH! - Customization](https://github.com/robbyrussell/oh-my-zsh/wiki/Customization)\n- [Toggl API Docs - Reports](https://github.com/toggl/toggl_api_docs/blob/master/reports.md)\n- [Toggl API Docs - Authentication](https://github.com/toggl/toggl_api_docs/blob/master/chapters/authentication.md)\n- [Working with JSON in bash using `jq`](https://medium.com/cameron-nokes/working-with-json-in-bash-using-jq-13d76d307c4)\n\n## Licence\n\n[Apache 2.0](./LICENCE)\n\nThis extension is not affiliated, associated, authorized, endorsed by or in any\nway officially connected to Toggl ([toggl.com](https://toggl.com)).\n\n## Maintainers\n\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\n        \u003ca href=\"https://github.com/natterstefan\"\u003e\n          \u003cimg width=\"150\" height=\"150\" src=\"https://github.com/natterstefan.png?v=3\u0026s=150\"\u003e\n          \u003c/br\u003e\n          Stefan Natter\n        \u003c/a\u003e\n        \u003cdiv\u003e\n          \u003ca href=\"https://twitter.com/natterstefan\"\u003e\n            \u003cimg src=\"https://img.shields.io/twitter/follow/natterstefan.svg?style=social\u0026label=Follow\" /\u003e\n          \u003c/a\u003e\n        \u003c/div\u003e\n      \u003c/td\u003e\n    \u003c/tr\u003e\n  \u003ctbody\u003e\n\u003c/table\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatterstefan%2Ftoggl-zsh-plugin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fnatterstefan%2Ftoggl-zsh-plugin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fnatterstefan%2Ftoggl-zsh-plugin/lists"}