WARNING: This is still a work in progress. You are free to use and poke around with this, but the API/DB Schema may change until we reach 1.0.
Minuteur is a Timer app built with Electron to solve a simple problem: Easy and simple time tracking.
To download the latest version, go to releases and download the latest version for your OS.
There's also a CLI tool + an Alfred Workflow to make your life easier. To check it out, check the latest release on the CLI tool.
This app exposes an internal API so you can write your custom integration for it.
Every time you see the time
fields in the API, it will be in seconds.
Getting a daily summary of hours per project
curl http://localhost:22507/api/projects/summary/daily | jq
[
{
"uuid": "ecfad1da-95a3-4355-b07e-7f205e8ea2ae",
"client_uuid": "68aae4be-1f24-4268-ad09-f9d9c7588d64",
"name": "New project",
"date": "2020-09-25",
"time": 7202,
"notes": "Session 1 name, Session 2 name"
},
{
"uuid": "ecfad1da-95a3-4355-b07e-7f205e8ea2ae",
"client_uuid": "68aae4be-1f24-4268-ad09-f9d9c7588d64",
"name": "New project",
"date": "2020-09-26",
"time": 50055,
"notes": "Session 1 name, Session 2 name"
}
]
Starting a timer for a given project
curl -X POST "http://localhost:22507/api/projects/{uuid}/sessions"
Stopping the running timer for a given project
curl -X POST "http://localhost:22507/api/projects/{uuid}/sessions/running"
Deleting all sessions for a given project
curl -X DELETE "http://localhost:22507/api/projects/{uuid}/sessions/clear"
After cloning this repo, simply run:
yarn install
sed '/Migrator.js/d' node_modules/knex/package.json > node_modules/knex/package.json.tmp && mv node_modules/knex/package.json.tmp node_modules/knex/package.json
yarn electron:serve
Make sure node_modules/.bin
is in your PATH, otherwise you might have to run node_modules/.bin/knex
instead.
Setting up migrations:
knex migrate:latest
Rolling back migrations:
knex migrate:rollback --all
yarn build:all