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

• Refresh Rate: (required) Define how often the API is being called, the default is 5 Seconds

• 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

There's a reason that one should try to avoid multi-threading if possible, since it adds more complexity and a lot more failure cases.

With V1.14 I accidentally added a deadlock on the timer toggling step. The Stream Deck would still correctly show the running timers, but if you pressed a button, it would just freeze as it deadlocked itself.

Hope this finally makes Clockify work again with all the improvements that V1.13 introduced!