v0.1.2

Two fixes found by putting the plugin on a real deck and enlarging the keys. Neither was reachable by any test.

Long names no longer run off the key

The default width for wrapping the Current Timer key's text was 11 characters, which was a guess. On hardware at the stock title font, 11 characters overflow the key and get clipped at both edges, so a project like Internal Tool Development was unreadable. The default is now 7.

If you left "Chars per line" blank, your Current keys will wrap a little narrower after updating. That is the fix. If you had set a value explicitly, nothing changes.

The Start key no longer collides with its own title

start.svg and start-running.svg filled the whole key, so a title, which for a Start key is usually the project name, printed straight over the artwork. Both are redrawn to sit higher and smaller, matching the proportions the Stop key already used, leaving the bottom of the key clear for text.

Nothing else changed. Same four actions, same settings, same API behavior.

v0.1.1

Marketplace eligibility fix. No functional changes: if v0.1.0 works for you, there is nothing here you need.

What changed

SDKVersion in the manifest goes from 2 to 3. Elgato's Maker Console rejects submissions below 3, and its DRM step cannot validate against 2.

Nothing else moved. Software.MinimumVersion stays at 7.1, no dependencies changed, and the plugin's behavior is identical. The packaged bundle was extracted to a bare directory and launched the way Stream Deck launches it, to confirm it still starts under the new value.

Requires the Stream Deck app 7.1 or newer, same as before.

v0.1.0

First release. A generic, configurable Stream Deck plugin for Kimai time tracking — four key types, all configured through the Stream Deck app UI, no code changes needed.

Install

Download co.alphaomegateam.kimai.streamDeckPlugin below and double-click it. Requires the Stream Deck app 7.1 or newer.

Then drag any Kimai key onto your deck, select it, and enter your Kimai URL and an API token (Kimai: profile → API access — the token value is shown only once). The connection is shared by every key; press Test connection to confirm it before configuring anything else.

The four actions

• Start Timer — starts a chosen project + activity. Optionally stops whatever is running first (on by default). The key highlights while its own timer is the one running.
• Stop Timer — stops whatever is currently running.
• Current Timer — a read-only display of the running timer: client, project, activity, elapsed. Elapsed ticks live.
• Toggle Timer — one key that starts its timer, or stops it if it is already the one running.

Known limitations in v0.1.0

• Keys only. No Stream Deck+ dials or touchscreens.
• One Kimai connection, shared by all keys.
• Changing the poll interval needs a plugin restart. URL and token changes apply immediately.
• "Stop running timer first" stops the first running timesheet, so on a Kimai configured to allow concurrent timers it stops one of several.
• Elapsed time is never wrapped or shortened, so a timer running past 99 hours can overflow a narrow key.
• Icons are a functional placeholder set; branded artwork comes before any Marketplace listing.

Settings, including the API token, are stored by Stream Deck in plaintext on the local disk. See the README for the full disclosure.

Verification

127 unit tests, streamdeck validate clean. The packaged archive was extracted to a bare directory and booted the way Stream Deck launches it, and installation plus startup were confirmed on real hardware on macOS. Windows is untested. docs/QA-CHECKLIST.md records what has and has not been exercised on a device.

MIT licensed. Third-party notices for all bundled dependencies ship inside the plugin bundle.