Menu

Tree [eab0cb] 1.x v1.0.0 /
 History

HTTPS access


File Date Author Commit
 assets 2020-07-17 Temuri Takalandze Temuri Takalandze [fc9975] 🔧 Update snapcraft config.
 src 2020-07-17 Temuri Takalandze Temuri Takalandze [b6a344] :bug: Fix empty config filename.
 vendor 2020-07-16 Temuri Takalandze Temuri Takalandze [af8c4e] ➕ Use docopt.
 .gitignore 2020-07-16 Temuri Takalandze Temuri Takalandze [f68382] 🔧 Use vendoring.
 CHANGELOG.md 2020-07-17 Temuri Takalandze Temuri Takalandze [eab0cb] 📝 Create CHANGELOG.md
 LICENSE 2020-07-16 Temuri Takalandze Temuri Takalandze [605f21] 📄 Create LICENSE.
 Makefile 2020-07-16 Temuri Takalandze Temuri Takalandze [f5dbdd] ♻️ Use Docker image to build project.
 README.md 2020-07-17 Temuri Takalandze Temuri Takalandze [c2de31] 📝 Add usage notes to README.md
 go.mod 2020-07-16 Temuri Takalandze Temuri Takalandze [af8c4e] ➕ Use docopt.
 go.sum 2020-07-16 Temuri Takalandze Temuri Takalandze [af8c4e] ➕ Use docopt.
 main.go 2020-07-17 Temuri Takalandze Temuri Takalandze [c2de31] 📝 Add usage notes to README.md
 nfpm.yaml 2020-07-16 Temuri Takalandze Temuri Takalandze [f5dbdd] ♻️ Use Docker image to build project.
 snapcraft.yaml 2020-07-17 Temuri Takalandze Temuri Takalandze [fc9975] 🔧 Update snapcraft config.

Read Me

goclockify

A terminal based client for Clockify time tracker [![goclockify](https://snapcraft.io//goclockify/badge.svg)](https://snapcraft.io/goclockify) [![GitHub release](https://img.shields.io/github/release/ABGEO/goclockify.svg)](https://github.com/ABGEO/goclockify/releases) [![GitHub license](https://img.shields.io/github/license/ABGEO/goclockify.svg)](https://github.com/ABGEO/goclockify/blob/1.x/LICENSE)

Installation

Binary installation

Download a compatible binary for your system and rename it to
goclockify. Then move goclockify into your $PATH somewhere (e.g. /usr/local/bin).

$ mv goclockify /usr/local/bin

Also, from this page, you can download .deb and .rpm packages and install them using your package manager:

# dpkg
$ sudo dpkg -i /path/to/goclockify.deb
$ sudo apt-get install -f

# apt
$ sudo apt install /path/to/goclockify.deb

# rpm
$ sudo rpm –i /path/to/goclockify.rpm

# yum
$ sudo yum localinstall /path/to/goclockify.rpm

# dnf
$ sudo dnf localinstall /path/to/goclockify.rpm

# ...

Via Go

You can also get goclockify via Go:

Note: Go 1.14+ required.

$ go get -u github.com/abgeo/goclockify
$ cd $GOPATH/src/github.com/abgeo/goclockify
$ go install .

Using Snap

goclockify is also available on Snap: https://snapcraft.io/goclockify

$ snap install goclockify

Setup

  1. Create a Clockify API Key;

  2. Running goclockify for the first time, will create a default config file at ~/.config/abgeo/goclockify/config;
    Note: The path to the config file will be different if you install goclockify using Snap.
    Check the error message (Config file: ...).

    bash $ goclockify

  3. Update the config file and set your clockify_api_token:

    json { "clockify_api_token": "your_api_key" }

Usage

When everything is set up correctly you can run goclockify with the following command:

$ goclockify

Key Mapping

Key Action
a Workplace navigation Up
z Workplace navigation Down
k, <Up> and <MouseWheelUp> Time Entries navigation Up
j, <Down> and <MouseWheelDown> Time Entries navigation Down
g, <Home> Time Entries jump to Top
G, <End> Time Entries jump to Down
<Enter> Display time entry details
<F1>, ? Show help message

Changelog

Please see CHANGELOG for details.

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

Authors

License

Copyright © 2020 Temuri Takalandze.
Released under the MIT license.

Want the latest updates on software, tech news, and AI?
Get latest updates about software, tech news, and AI from SourceForge directly in your inbox once a month.