markdown-body entry-content container-lg" itemprop="text">

Waybar-Clockify

Track and display Clockify's time entry at Waybar

waybar.mp4

Description

Waybar-Clockify is a simple wrapper between clockify-cli and timewarrior.

Why?

I love timewarrior, but I find the summary and report functionalities lacking, while Clockify offers rich reports and time analysis:

Fortunately, we have clockify-cli which offers amazing integration with Clockify. Hence the birth of Waybar-Clockify.

Getting Started

Dependencies

Waybar
timewarrior
clockify-cli
rofi
jq
fzf (optional if you want to control it through the terminal)

Installation

Clone this repository: git clone https://github.com/kohane27/Waybar-Clockify.git
Put the directory src/Waybar-Clockify under ~/.config/waybar/scripts/Waybar-Clockify:

.
├── config
├── scripts
│   ├── custom-script.sh
│   └── Waybar-Clockify
│       ├── click.sh
│       ├── main.sh
│       └── stop.sh
│       ├── clockify-tags.txt
└── style.css

Make click.sh, main.sh and stop.sh executable: chmod +x click.sh main.sh stop.sh
Add Waybar-Clockify module to ~/.config/waybar/config:

    "custom/Waybar-Clockify": {
    "format": " {} ",
    "exec": "~/.config/waybar/scripts/Waybar-Clockify/main.sh",
    "on-click": "~/.config/waybar/scripts/Waybar-Clockify/click.sh",
    "on-click-right": "~/.config/waybar/scripts/Waybar-Clockify/stop.sh",
    },

Add the module to whichever modules you want the timer to appear. In this example it's modules-right:

    "modules-right": [
        "custom/Waybar-Clockify",
        "cpu",
        "memory"
    ],

Restart Waybar and the timer should appear
(Optional) Add the following two shell functions to ~/.bashrc or ~/.zshrc:

ti() {
  # no running instance
  if [[ "$(timew get dom.active)" == "0" ]]; then
    timew start >/dev/null 2>&1
    print -z timew tag @1 \'"$(cat <~/.config/waybar/scripts/Waybar-Clockify/clockify-tags.txt | fzf)"\'
   # modify current instance's description/tag/project
  elif [[ "$(timew get dom.active)" == "1" ]] && [[ "$(timew get dom.active.tag.count)" == "1" ]]; then
    current_tag="$(timew get dom.active.tag.1)"
    # untag current tag
    timew untag @1 "$current_tag"
    # tag again with new selection
    print -z timew tag @1 \'"$(cat <~/.config/waybar/scripts/Waybar-Clockify/clockify-tags.txt | fzf)"\'
  fi
}

to() {
    ~/.config/waybar/scripts/Waybar-Clockify/stop.sh
}

You may choose whatever function command names you want. For example, if you're used to timewarrior: zsh plugin for timewarrior, then you can use the default twa and two.

Usage

Note: I recommend getting familiar with clockify-cli and timewarrior before using.

There are two main ways to interact with Waybar-Clockify:

1. Only through `Waybar`

waybar.mp4

Left click to start the timer Note: When the timer is running, left click again allows replacing current tag
Click on a predefined tag in clockify-tags.txt through rofi
Right click to stop the timer

2. Only through terminal

cli.mp4

If you've added the optional shell functions to ~/.bashrc or ~/.zshrc (step 7 above):

Use the command ti to start the timer
Choose a predefined tag in clockify-tags.txt through fzf
Use the command to to stop the timer

Additionally, you could start Waybar-Clockify in the terminal and stop in Waybar, or start in Waybar and stop in the terminal.

Caveats

1. Tags need to already exist in `Clockify`

Inside clockify-tags.txt, you'll find the following samples:

{"p": "Code","t":["clientA","career"], "d": "projectA"}
{"p": "Code","t":["clientB","career"], "d": "projectB"}
{"p": "Entertainment","t": ["youtube"], "d": ""}

p: project
t: tags
d: description

Each key corresponds to PROJECT, TAGS and DESCRIPTION in clockify-cli:

❯ clockify-cli report
+--------------------------+---------------------+---------------------+---------+---------------+-------------+------+------------------------------------+
|            ID            |        START        |         END         |   DUR   |    PROJECT    | DESCRIPTION | TASK |                TAGS                |
+--------------------------+---------------------+---------------------+---------+---------------+-------------+------+------------------------------------+
| 63121910b456dc322924eb1f | 2022-09-01 08:00:00 | 2022-09-01 09:00:00 | 1:00:00 | Code          | projectA    |      | clientA (630328ec899ba763d36b39d7) |
|                          |                     |                     |         |               |             |      | career  (630106dd96dd4c674e51a45a) |
+--------------------------+---------------------+---------------------+---------+---------------+-------------+------+------------------------------------+
| 63131a977f07da44c10f6a21 | 2022-09-01 09:52:59 | 2022-09-01 10:49:00 | 0:56:01 | Entertainment | cat vid     |      | youtube (6306445eb59c366b3eaz4280) |
+--------------------------+---------------------+---------------------+---------+---------------+-------------+------+------------------------------------+
| TOTAL                    |                     |                     | 1:56:01 |               |             |      |                                    |
+--------------------------+---------------------+---------------------+---------+---------------+-------------+------+------------------------------------+

You need to make sure p(project) and t(tags) fields exist in clockify, or else clockify-cli will fail to send the time entry to Clockify. In the above example, the projects Code and Entertainment, and the tags clientA, clientB, youtube need to exist in Clockify.

To see the projects available clockify-cli project list --not-archived --csv

To see the tags available: clockify-cli tag

2. Beware of modification of `timewarrior` tag fields

I use timewarrior as a medium between Waybar-Clockify and clockify-cli. The timewarrior tag field is converted to a json for clockify-cli to consume. The tag field will become like the following:

inc 20220831T091819Z - 20220831T091822Z # "{\"p\": \"Entertainment\",\"d\": \"\",\"t\": [\"youtube\"]}"
inc 20220831T133109Z - 20220831T133121Z # "{\"p\": \"Code\",\"t\": [\"code\",\"career\"], \"d\": \"clientA\"}"

Please take into acount of this modification of timewarrior data before using Waybar-Clockify. Back up your .timewarrior data.

How `Waybar-Clockify` works

The backbone of time tracking is done by timewarrior, so any timewarrior commands like cancel, continue, lengthen, shorten still work.

Waybar displays the latest time tracked by timewarrior, effectively timew get dom.active.duration.

When you left-click the Waybar module or use the command to, it'll trigger the follow clockify-cli command to communicate with clockify API:

clockify-cli manual \
  --project "$project" \
  --description "$description" \
  --when "$start" \
  --when-to-close "$end" \
  --tag "$tag"
  --interactive=0

It's permissive: if no project, description, tags are provided, default values are used, i.e., empty strings.

Roadmap

fzf: after selection, move cursor inside d field so it's ready for input:

'{"p": "Health","t":["gym","weight", "d": "|"]}'

Solution: append tmux send-keys Left Left Left to ti function

after clicking Waybar module, what if user wants to add description?

Solution: issue ti again to modify current instance's description/tag/project

Contributing

Any contributions you make are greatly appreciated. If you have a suggestion that would make this better, please fork the repo and create a pull request. You can also open an issue.

Fork the Project
Create your Feature Branch (git checkout -b feature/AmazingFeature)
Commit your Changes (git commit -m 'Add some AmazingFeature')
Push to the Branch (git push origin feature/AmazingFeature)
Open a Pull Request

License

Waybar-Clockify is licensed under the MIT license. See LICENSE for more information.

Acknowledgments

Don't forget to give the project a star! Thanks again!

License

kohane27/Waybar-Clockify

ErrorLooks like something went wrong!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Languages

Error
Looks like something went wrong!