https://github.com/andrejilderda/alfred-harvest
Control your Harvest timers directly from Alfred.
https://github.com/andrejilderda/alfred-harvest
alfred-workflow harvest harvestapp javascript time-tracker
Last synced: 7 months ago
JSON representation
Control your Harvest timers directly from Alfred.
- Host: GitHub
- URL: https://github.com/andrejilderda/alfred-harvest
- Owner: andrejilderda
- License: mit
- Created: 2019-10-28T19:17:35.000Z (about 6 years ago)
- Default Branch: master
- Last Pushed: 2024-01-03T11:06:57.000Z (almost 2 years ago)
- Last Synced: 2024-04-24T18:55:39.870Z (over 1 year ago)
- Topics: alfred-workflow, harvest, harvestapp, javascript, time-tracker
- Language: JavaScript
- Homepage:
- Size: 560 KB
- Stars: 43
- Watchers: 4
- Forks: 3
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
## Control your [Harvest](https://www.getharvest.com/) timers using [Alfred](https://www.alfredapp.com/).
- Start, stop and adjust timers
- Delete timers
- Add/append notes
- API token is stored securely in Keychain (no password used for authenticating)
- Uses the latest Harvest API (v2)
## Installation & Setup
1. Ensure that you have [node.js](https://nodejs.org/en/) installed. You can check by running `node -v` in the Terminal.
2. Download the latest version of the workflow from the [Releases](https://github.com/andrejilderda/alfred-harvest/releases) page.
3. Open https://id.getharvest.com/developers and click on 'Create New Personal Access Token'.
4. Give the token a name, such as 'Alfred workflow', and generate it.
5. Copy the generated Account ID.
6. Open the workflow's configuration and paste the Account ID. Save the configuration.
7. Type `hvs` in Alfred and press enter.
8. Paste the API token and press enter.
9. Type `hvn` in Alfred to start your first timer.
Note: Make sure you have the [Alfred Powerpack](https://www.alfredapp.com/powerpack/) installed to use workflows.
\*The first time you run the workflow you may be prompted to grant access to the API token (which is stored in your Keychain).
_Note: In order to install workflows you need the [Alfred Powerpack](https://www.alfredapp.com/powerpack/)._
## How to use
### Start a new timer
- Type hvn to list the available projects,
- Select a project and press enter,
- Select the task and press enter
### Toggle timer
- Type `hvt` to list today's timers.
- Press enter to stop/restart the selected task.
**Tip:** Hold alt to delete the selected task.
### Adjust timer
- Type `hva` to list today's timers,
- Select a timer by pressing enter,
- Type a new time for the task in digit (`2.5`) or time (`2h30m`) format.
**Tip:** Add a `+`/`-` in front of your timer to add or subtract time, i.e. `-30m` will subtract 30 minutes from your timer.
### Add notes
- Type `hvnt` to list today's timers,
- Select a timer by pressing enter,
**Tip:** Your newly typed note will be appended by default. If you want to overwrite the note, hold down the alt-key when selecting a task from the list.
## Credits & thank you’s
This workflow was inspired by Neil Renicker’s [Harvest workflow](https://github.com/tinystride/alfred-harvest) which I've used for years (but stopped working for me).
All icons (except the Harvest logo) are from Daniel Bruce’s [Entypo](http://www.entypo.com/)-pack, and are distributed under the [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)-license.