https://github.com/oxalorg/emacs-clockify
clockify.el emacs package for tracking time in clockify
https://github.com/oxalorg/emacs-clockify
clockify emacs time-tracking
Last synced: 4 months ago
JSON representation
clockify.el emacs package for tracking time in clockify
- Host: GitHub
- URL: https://github.com/oxalorg/emacs-clockify
- Owner: oxalorg
- Created: 2021-02-24T15:45:10.000Z (almost 5 years ago)
- Default Branch: main
- Last Pushed: 2023-09-14T13:55:47.000Z (over 2 years ago)
- Last Synced: 2025-05-13T03:56:06.289Z (7 months ago)
- Topics: clockify, emacs, time-tracking
- Language: Emacs Lisp
- Homepage:
- Size: 11.7 KB
- Stars: 2
- Watchers: 2
- Forks: 2
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# emacs-clockify
An emacs plugin to make time entries into https://clockify.me
## Install
Add this to your config file
``` emacs-lisp
(use-package clockify
:load-path "~/projects/emacs-clockify"
:init
(setq clockify-api-key "")
(setq clockify-user-id "")
(setq clockify-workspace "")
)
;; or to not check the secrets in, you can create a file called
;; secrets.el
(setq clockify-api-key "")
(setq clockify-user-id "")
(setq clockify-workspace "")
;; then load it in your init.el
(load-file "./secrets.el")
```
You need to clone this repo to the path you mention in the `:load-path` as this package is not yet available on MELPA.
## Usage
In any emacs session use `M-X` and call the `clockify-get-projects` once to populate all the projects from your workspace.
Then run `clockify-clock` whenever you want to clock in a time entry. It will show a nice popup where you can search for your project, search for start time, and end time. Really quick!
To start tracking for a project arbitrarily, run `M-X clockify-clock-start` and select the project. To end it, run `M-X clockify-clock-stop`
## TODO
- [ ] I'm working on a better way to store the api key and workspace id, probably in a file like `~/.emacs-clockify`
- [ ] Remove the need to call `clockify-get-projects` manually
- [ ] Screenshot / GIF