A Harvest timetracking widget for your touchbar
Switch branches/tags
Nothing to show
Clone or download
Failed to load latest commit information.
resources cleaning up Jun 29, 2018
.gitignore cleaning up Jun 29, 2018
Gemfile cleaning up Jun 29, 2018
Gemfile.lock cleaning up Jun 29, 2018
LICENSE.txt fixing license Jun 29, 2018
README.md Fix Harvest link in README Jun 29, 2018
config.example.yml cleaning up Jun 29, 2018
harvest.rb shows --:-- instead of error when offline Jul 23, 2018


Harvest for Touchbar

This is a simple script for BetterTouchTool which allows users to control their currently active timer on Harvest.

Harvest for Touchbar in action

The extension is essentialy a touchbar-based duplicate of Harvest for Mac's menu bar.


Before getting started, please ensure you have BetterTouchTool, Ruby, and Bundler installed on your on your Mac.

Once you have these packages installed cd into a directory you're not likely to accidentally delete (as that will break the widget) and clone the repository:

$ git clone https://github.com/stevenleeg/harvest-touchbar.git harvest-touchbar

Next you'll need to generate a personal access token from Harvest's developer console for the widget to access your account. Once you've generated your credentials you'll need to create a file, config.yml with the following contents:

harvest_token: [auth token here]
harvest_account_id: [account id here]

We'll also need to install some Ruby dependencies by running:

$ bundle

Finally we'll generate a JSON configuration snippet used to add the widget to BTT and copy it into your system clipboard:

$ ruby harvest.rb | pbcopy

Once copied, you can open BTT's touchbar configuration screen and add the widget by right clicking on the list of widgets and clicking "Paste from JSON in clipboard":


Voilà! You should now have a functional Harvest widget in your touchbar. Give it a tap to start/stop your latest timer.


Please feel free to open an issue or PR if you've found a bug. If you're looking to implement a feature, please open an issue before creating a PR so I can review it and make sure it's something that should be added.


This project is released under the MIT License. See LICENSE.txt for more information.