This plugin allows you to track, start and stop Clockify timers on your Elgato Stream Deck.

Basic

• Title: Override the title being set by the plugin, leave empty otherwise

• API Key: (required) Provide your 48 characters long Clockify API Key, which is required for the plugin to work

• Workspace Name: (required) Write the name of the workspace you want to run/track timers in

• Project Name: (optional) Provide the name of an existing project to run/track a timer for

• Task Name: (optional) Set the name of the project-specific task

• Timer Name: (optional) Specify a name for the timer you want to run/track

• Tags: (optional) Provide a comma separated list of tags to be assigned to the timer

  • Note: If your tag contains a comma (WHY?!) use a backslash to escape it, e.g. tag1,tag\,2,tag3

• Billable (optional) Check or uncheck the box to run the timer as billable or non-billable

Advanced

• Client Name: (optional) Set the client name assigned to the specified project

• Title Format: (optional) Specify the format for the title to be displayed on the button.

  • This can include any of:

    • {workspaceName} : The workspace name

    • {projectName} : The project name

    • {taskName} : The task name

    • {timerName} : The timer name

    • {clientName} : The client name

    • {timer} : The current timer value when running. Blank when not running

• Server Url: (required) Change from the default URL to the API URL of your own/company instance

  • Note: Starting with V1.11 the URL should not end with /v1

First two months on the Marketplace has been pretty good! 🥳

While Elgato doesn't provide any statistics, there's a way to see the download count, which currently sits at 568! 🤯

Thank you to everyone who reached out with questions or issues!

This update uses .NET 8, given that .NET 6 is no longer supported, but I struggled a bit to get it working with the StreamDeck-Tools SDK.

It also ships with an up-to-date Clockify API client. ✨

The current plan is to focus on API rate limits / caching / etc.

If you saturate your entire Stream Deck with timers, especially when using the Stream Deck XL, will quickly run into the API rate limits and then every button stops working. Hopefully, I can find a solution to reduce the number of required calls and provide options to fine tune the experience for those with different needs.

Fixes

In some odd cases it seems like tags can return null from the API, which then led the plugin to crash. Now such null tags are simply removed and ignored.