Skip to main content

Toggl Entry - CLI REST API client for Toggl

Project description

Toggl Entry (te)

Toggle Entry (te) is a Toggl REST API command line interface (CLI) client. This tool allows quick entries insertion from your terminal - no more tedious mouse-clicking!

For any power user, this will be probably much faster way than inserting entries with the official web/desktop/mobile version of the app. Moreover, it can nicely speed-up bulk editing via shell script edited in your favorite editor. Actually, this is how I am catching up with my timesheets ;-)

Toggl Entry screenshot

Requirements

  • Windows, macOS, Linux, or any Unix-like operating system
  • Python 3 + pip (tested with Python 3.7)
  • Toggl account + Toggl API token

You can get the Toggl API token in its web interface from Profile Settings (scroll to the bottom).

Installation

  1. Install te from PyPI (Python Package Index):

    $ pip3 install te
    
  2. Create a configuration file .te.ini in your home directory:

    $ touch ~/.te.ini
    
  3. Set permissions to your configuration file, so nobody but you can read it:

    $ chmod 0600 ~/.te.ini
    
  4. Open the configuration file:

    $ nano  ~/.te.ini
    
  5. Insert this template to the configuration file:

    [general]
    
    ; Set your timezone here
    timezone = Europe/Prague
    
    ; Set your API token here
    api_token = ...
    
  6. Adjust the timezone and api_token in the configuration file and save it.

Usage

Open your terminal application and try this command:

$ te 20-01-30 08:00 1h My first task entry

If no error message is provided and the process gracefully exits, the entry has been successfully inserted. You can check it in the Toggl web app.

You can also use this format to automatically insert the current date:

$ te - 08:00 120m My first task entry

Also, the separators can be avoided:

$ te 200130 0800 3h My first task entry

That's it for now and happy Toggl-ing!

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

License

This project is licensed under the MIT License - see the LICENSE file for details.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

te-1.0.1.tar.gz (216.4 kB view details)

Uploaded Source

Built Distribution

te-1.0.1-py3-none-any.whl (5.1 kB view details)

Uploaded Python 3

File details

Details for the file te-1.0.1.tar.gz.

File metadata

  • Download URL: te-1.0.1.tar.gz
  • Upload date:
  • Size: 216.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.7.1

File hashes

Hashes for te-1.0.1.tar.gz
Algorithm Hash digest
SHA256 ccbf59c005d172ff8fef85cc08e2dba38b888a419f55c4addd1624bee4312218
MD5 61f2df2cef5d3e008c7dfa3d74fa7948
BLAKE2b-256 f2b4b4c4e414b62c08bae0b9f8ef3595ab50e39e80c9aea721d6b96805da7b9a

See more details on using hashes here.

File details

Details for the file te-1.0.1-py3-none-any.whl.

File metadata

  • Download URL: te-1.0.1-py3-none-any.whl
  • Upload date:
  • Size: 5.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.1.1 pkginfo/1.5.0.1 requests/2.22.0 setuptools/42.0.2 requests-toolbelt/0.9.1 tqdm/4.40.1 CPython/3.7.1

File hashes

Hashes for te-1.0.1-py3-none-any.whl
Algorithm Hash digest
SHA256 b216741f7482ba30ff4491f7d0dddb485c56e7bb2e87a356de19894e898437ca
MD5 ed3454ac92b666be382fc808caa03769
BLAKE2b-256 b1881942b54e418492867f56796eae5053d95fe08f6652c3b38a1b4adb7e9684

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page