Metadata-Version: 2.1
Name: gnome-pomodoro-tracking
Version: 4.1.0
Summary: Connect your Pomodoros to popular time tracking services.
Home-page: https://github.com/gnome-pomodoro/gnome-pomodoro-tracking
Author: Jose Hbez
Author-email: josehbez@outlook.com
License: MIT
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.2
Classifier: Programming Language :: Python :: 3.3
Classifier: Programming Language :: Python :: 3.4
Classifier: Programming Language :: Python :: 3.5
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Description-Content-Type: text/markdown
License-File: LICENSE

<p align="center">
  <img src="docs/img/how-does-it-workv4.png" width="1200">
</p>

<p align="center">  
  <a href="https://github.com/gnome-pomodoro/gnome-pomodoro-tracking/actions?query=workflow%3APytest">
    <img src="https://github.com/gnome-pomodoro/gnome-pomodoro-tracking/workflows/Pytest/badge.svg">
  </a>
  <a href="LICENSE">  
    <img src="https://img.shields.io/github/license/gnome-pomodoro/gnome-pomodoro-tracking?style=flat-square" />
  </a>
  <a href=".pm/version.yml">
        <img src="https://img.shields.io/badge/dynamic/yaml?color=green&label=version&query=version.*&url=https://raw.githubusercontent.com/gnome-pomodoro/gnome-pomodoro-tracking/master/.pm/version.yml">
  </a>
</p>

# GNOME Pomodoro Tracking
Lets you track your time with the popular time tracking services.

## Contents

* Getting Started
	* [Install](#getting-started)
	* [GNOME Pomodoro Settings](#gnome-pomodoro-settings)
	* [Command Line](#command-line)	
* Guides
	* [Introducing](docs/introducing.md)
	* [Toggl](docs/toggl.md)
	* [Clockify](docs/clockify.md)
	* [Odoo](docs/odoo.md)
* Contributing
	* [Testing](testing.md)

## Getting Started

### Requirements
* python3
* [gnomepomodoro.org](https://gnomepomodoro.org)

### Install
```bash
pip install -U git+https://github.com/gnome-pomodoro/gnome-pomodoro-tracking.git
```
or 
```bash
pip3 install -U gnome-pomodoro-tracking
```
### Uninstall
```bash
pip3 uninstall -y gnome-pomodoro-tracking
```

### GNOME Pomodoro Settings

`Preferences / Plugins ... / Custom Actions(Execute shell scripts) / Add `

```bash
gnome-pomodoro-tracking -gps "$(state)" -gpt "$(triggers)" -gpd "$(duration)" -gpe "$(elapsed)"
```

<p align="center">  
 <img src="docs/img/gnome-pomodoro-settings.gif" width="400"/>
</p>

### Command Line

```bash
usage: gnome-pomodoro-tracking [-h] [--plugin {odoo,clockify,toggl}] [-n NAME]
                               [-g TAG] [-r] [-k] [-s] [-w] [-p]
                               [--token TOGGL_TOKEN]
optional arguments:
  -h, --help            show this help message and exit
  --plugin {odoo,clockify,toggl}
                        Time Tracking Service
  -n NAME, --name NAME  Pomodoro name
  -g TAG, --tag TAG     Pomodoro tag
  -r, --restart         Pomodoro restart
  -k, --stop            Pomodoro stop
  -s, --status          Pomodoro status
  -e, --time-entry      Create time entry
  -m, --min-trace       Time minimal elapsed to track
  -d, --debug           Enable debug

```



