{"id":17961685,"url":"https://github.com/expl0it3r/streamdeck-clockify","last_synced_at":"2026-01-28T12:23:00.834Z","repository":{"id":147290854,"uuid":"353058628","full_name":"eXpl0it3r/streamdeck-clockify","owner":"eXpl0it3r","description":"Clockify Action for the Elgato Stream Deck","archived":false,"fork":false,"pushed_at":"2024-11-21T22:45:52.000Z","size":624,"stargazers_count":55,"open_issues_count":4,"forks_count":9,"subscribers_count":5,"default_branch":"master","last_synced_at":"2025-03-19T08:48:21.321Z","etag":null,"topics":["clockify","elgato-stream-deck","plugin","timetracking"],"latest_commit_sha":null,"homepage":"","language":"CSS","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/eXpl0it3r.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}},"created_at":"2021-03-30T15:56:21.000Z","updated_at":"2025-03-03T07:49:36.000Z","dependencies_parsed_at":"2024-02-08T23:26:09.039Z","dependency_job_id":"8227a6f5-b999-401e-b4e1-61870cfa8e3c","html_url":"https://github.com/eXpl0it3r/streamdeck-clockify","commit_stats":null,"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eXpl0it3r%2Fstreamdeck-clockify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eXpl0it3r%2Fstreamdeck-clockify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eXpl0it3r%2Fstreamdeck-clockify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/eXpl0it3r%2Fstreamdeck-clockify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/eXpl0it3r","download_url":"https://codeload.github.com/eXpl0it3r/streamdeck-clockify/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245401360,"owners_count":20609161,"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":["clockify","elgato-stream-deck","plugin","timetracking"],"created_at":"2024-10-29T11:10:28.464Z","updated_at":"2026-01-28T12:23:00.824Z","avatar_url":"https://github.com/eXpl0it3r.png","language":"CSS","readme":"# Stream Deck - Clockify\n\n![Clockify + Elgato Stream Deck](Docs/Clockify-GitHub-Banner.png)\n\nThis plugin allows you to track, start and stop Clockify timers on your [Elgato Stream Deck](https://www.elgato.com/en/stream-deck).\n\n## Download\n\nUntil the plugin is available in the [Stream Deck Store](https://apps.elgato.com/plugins), you can download a copy from the [GitHub release pages](https://github.com/eXpl0it3r/streamdeck-clockify/releases/latest).\n\n## Setup\n\n- **Basic**\n  - **Title:** Override the title being set by the plugin, leave empty otherwise\n  - **API Key:** *(required)* Provide your 48 characters long [Clockify API Key](https://clockify.me/user/settings), which is required for the plugin to work\n  - **Workspace Name:** *(required)* Write the name of the workspace you want to run/track timers in\n  - **Project Name:** *(optional)* Provide the name of an existing project to run/track a timer for\n  - **Task Name:** *(optional)* Set the name of the project-specific task\n  - **Timer Name:** *(optional)* Specify a name for the timer you want to run/track\n  - **Tags:** *(optional)* Provide a comma separated list of tags to be assigned to the timer\n    - Note: If your tag contains a comma (WHY?!) use a backslash to escape it, e.g. `tag1,tag\\,2,tag3`\n  - **Billable** *(optional)* Check or uncheck the box to run the timer as billable or non-billable \n- **Advanced**\n  - **Client Name:** *(optional)* Set the client name assigned to the specified project\n  - **Title Format:** *(optional)* Specify the format for the title to be displayed on the button\n    - This can include any of:\n      - `{workspaceName}` : The workspace name\n      - `{projectName}` : The project name\n      - `{taskName}` : The task name \n      - `{timerName}` : The timer name\n      - `{clientName}` : The client name\n      - `{timer}` : The current timer value when running. Blank when not running\n  - **Refresh Rate:** *(required)* Define how often the API is being called, the *default* is 5 Seconds \n  - **Server Url:** *(required)* Change from the *default* URL to the API URL of your own/company instance\n    - Note: Starting with V1.11 the URL should *not* end with `/v1` \n\nhttps://user-images.githubusercontent.com/920861/132741561-6f9f3ff0-a920-408d-8279-579840ce0a6b.mp4\n\n## FAQ / Troubleshooting\n\n- Why am I getting a yellow triangle when pressing the button?\n  - Your API Key is likely incorrect\n  - Make sure your local system time is up-to-date, it's not uncommon for systems to be off by a few seconds\n  - If you have clients assigned to your project, make sure they're configured in the Stream Deck\n- Why am I not seeing the running timer on my button?\n  - Make sure you haven't set a title, as this will override any other content\n  - Make sure the API Key, Workspace name and optional the project and timer name\n- Why are my tags missing on the timer?\n  - Make sure the tags have been created through the web app, as the plugin doesn't create them\n  - Make sure the tag names match and tags with commas (WHY!?!) are escape with a backslash, e.g. `tag1,tag\\,2,tag3`\n- Why does the timer always start with a negative number?\n  - This can happen when your local computer time isn't in sync with the Clockify server time\n  - Make sure you synchronize your clock with a time-server\n- Why does it always take some seconds to show the timer running?\n  - Due to API rate limits, there's some magical caching going on, leading to certain delays \n- Why can't I select my Workspace and Project in a dropdown menu?\n  - Because I was lazy 😅\n- Where can I find the logs?\n  - Windows: `%appdata%\\Elgato\\StreamDeck\\Plugins\\dev.duerrenberger.clockify.sdPlugin\\Windows\\pluginlog.log`\n  - macOS: `~/Library/Application Support/com.elgato.StreamDeck/Plugins/dev.duerrenberger.clockify.sdPlugin/macOS/pluginlog.log`\n- IT DOESN'T WORK, WHY?!?\n  - Feel free to open a [GitHub issue](https://github.com/eXpl0it3r/streamdeck-clockify/issues) or ping me on [Bluesky](https://bsky.app/profile/darkcisum.bsky.social) or [Twitter](https://twitter.com/DarkCisum)\n\n## Credits\n\n- Feel free to star this repository and follow me on [Bluesky](https://bsky.app/profile/darkcisum.bsky.social) or [Twitter](https://twitter.com/DarkCisum)\n- Thanks to [Bar Raiders](https://barraider.com/) for the great tooling and community\n- Shout-out to [Hugh Macdonald](https://github.com/HughMacdonald) for adding the text formatting feature!\n- Took some inspiration from the [Toggl plugin](https://github.com/tobimori/streamdeck-toggl)\n- Using a CC0 licensed [Timer image](https://www.svgrepo.com/svg/23258/timer) for the Time Tracking category\n- Talking to Clockify with the [ClockifyClient](https://github.com/eXpl0it3r/ClockifyClient) library\n- And thanks to [Clockify](https://clockify.me/) for providing an excellent time tracking tool for free\n\n## License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpl0it3r%2Fstreamdeck-clockify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexpl0it3r%2Fstreamdeck-clockify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexpl0it3r%2Fstreamdeck-clockify/lists"}