TempoFlex

Browser extension for Chrome & Firefox. Get the time spent over/under what Tempo says you should have worked, for flexible working environments.

Why this exists

Short version: I needed this.

Long version: Many software houses use Jira. Many people use Tempo in Jira to track time, especially if it's a consultancy and you need to bill that time to someone! Some workplaces have flexible working arrangements. If you have flexible working hours, TempoFlex can let you know how much time you have worked above/below what you should have worked (according to your Tempo Administrator).

You should be able to get this through the Tempo UI, but there's a few problems. For starters, before you started work today you were already behind by the number of hours you should work by the end of the day. Next, if you book time in the future (e.g. you have holiday tomorrow and want your timesheet up to date for reporting), then Tempo classes this as work done, and so you're reported as ahead, but that doesn't actually mean you can take the afternoon off. Tempo bundles everything into Periods, which means if you have a busy Jan 31st and work a couple of extra hours, Tempo shows you as "balanced" on Feb 1st (unless you dig into older periods which shows you were up on a previous period, but never reconciles).

Building the extension

npm install
npm run build

This will create a dist subfolder with the build outputs.

Installing for Chrome

From Chrome Web Store

Visit https://chrome.google.com/webstore/detail/tempoflex/ldinkknlmjkoigpniidlffboenkecgbp

From source

• Build the extension (above)
• Navigate to chrome://extensions
• Enable "Developer Mode" (in the top right)
• Click "Load unpacked" and load the "dist" subfolder

From a Github release

As per the source instructions, but download & unzip "TempoFlex-x.x.x.zip" from the latest release

Installing for Firefox

From Mozilla Add-ons

TBA

From source

• Build the extension (above)
• Run npm run runff to test the extension in a isolated profile

If you've made changes and need a signed version to distribute (and don't want to use Mozilla's web upload to do it):

• Change the id in the manifest.json from tempoflex@fishbowler.github to something you want
• Get credentials from https://addons.mozilla.org/en-GB/developers/addon/api/key/
• Set the WEB_EXT_API_KEY environment variable to the JWT Issuer
• Set the WEB_EXT_API_SECRET environment variable to the JWT Secret
• Run npm signpackage

Usage

• Right click the extension
• Pick "Options"
• Set your Jira URL and your Jira username
• Click the extension to see your over/under

Oddities

Tempo starts the day with every user being behind by 7½ hours (or your configured daily work hours). TempoFlex adapts to this by ignoring today's hours if today is a working day, up to the configured work hours. This means that if it's a UK Bank Holiday, or a weekend, it'll count all of today's hours since the "configured" amount should be 0 (so you probably should take a break...)

Acknowledgements

Tempo is a Jira plugin for recording time, among many other things. The Tempo name is theirs, and I'm in no way affiliated - I just made a tool that I found useful.

Icon made by Freepik from www.flaticon.com