Skip to content

Latest commit

 

History

History
81 lines (56 loc) · 2.61 KB

README.md

File metadata and controls

81 lines (56 loc) · 2.61 KB
Raw

Toggl Track client

Renovate enabled

Disclaimer

This project is built solely by me with no affiliation with Toggl OÜ whatsoever.

It was developed as a response to company's decision to discontinue the native tracker app for Linux and is mostly driven by my allergy to browser extensions.

I started by patching the old c++ app (link to my fork that should work somehow) to work with the new API, but 100 KLOC is beyond my ability to comprehend in a few hours.

Features

Well, this is a time tracker. It supports creating, reading, updating and deleting time entries.

Here's what it can do:

  • Login: only with email and password.
  • Running entry: start; load; modify description, time and project; stop.
  • Previous entries: load; update description, time and project; delete.
  • Workspace: select active
  • Project: select default (not mandatory)

This app is built with iced framework.

Installation

If you are fine with grabbing random binaries from the internet, just go to the [Releases] page, take the binary for your arch & platform and copy to whatever location is on your PATH. Here's an example:

wget https://github.com/sterliakov/toggl/releases/download/v0.1.0/toggl-tracker-x86_64-unknown-linux-gnu.tar.gz
tar xzf toggl-tracker-x86_64-unknown-linux-gnu.tar.gz
./toggl-tracker

To build from source:

cd "$(mktemp -d)"
git clone https://github.com/sterliakov/toggl
cd toggl
cargo install --path .

TODO

A few more things would be nice to implement:

  • Login with SSO
  • Editing entry tags
  • Ability to minimize to tray

Reporting issues

Almost any feedback is welcome, with the only exception being UI "design". I don't care how stylish and lightweight the UI looks. It should work, and that's it. However, this does not include quality of life improvements: e.g. "this field is too small to read" or "text overflows here" aren't examples of unimportant design problems.

Please use GitHub issues to contact me about any problems you may have with this app.

Make sure to include your OS and relevant system details in your report.

I'm ready to accept pull requests. Make sure to explain what the PR is doing and why it is necessary, link to relevant issues if any.

Windows users note

If you're experiencing a bug on Windows that does not reproduce on other platforms, you're left on your own, sorry. I don't have a Windows machine by hand and don't want to acquire one. However, if you can fix the problem yourself, a PR is welcome!