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 official release on the Elgato Marketplace! 🎉

Version 1.11 has support for:

• Workspace🏢 - Select your relevant workspace on a per button basis
• Project📈 - Run timers for a specific project
• Task Name📝 - Provide the underlying task for a timer
• Timer Name⏱️ - Specify a name for the timer itself
• Tags🏷️ - Clockify allows you to define tags on a per workspace basis and provide an arbitrary amount of tags for your timer
• Billable💰 - You can decide whether your timers run as billable or non-billable, by checking or or unchecking the "Billable" checkbox
• Client🧑🏼‍💼 - Specify for which client the timer should run for
• Custom Title🔖 - Customize the text that is shown on the action button
• Custom Server🌐 - In case you host your own Clockify server

Note: Unlike task or timer names, tags are not automatically created, as to prevent a flood of non-matching and typo-ed tags. This means you first need to create the wanted tags in the Clockify (web) app for your workspace.