Author: Vincent Guyader
Date: 2024-02-19

# togglr

#### Vincent Guyader

#### 2024-02-19

## Installation of `togglr`

### From CRAN

    install.packages("togglr")

### From Github

    if (!requireNamespace("devtools")){install.packages("devtools")}
    devtools::install_github("ThinkR-open/togglr")

## Set toggl Api token

Go on toogl.com website : `https://toggl.com/app/profile`

    togglr::open_toggl_website_profile()

then select and copy your token api at the bottom of the page.

    library(togglr)
    set_toggl_api_token("your_token_api")

You just need to do this once.

## Start the tracking system

Without any parameters it will create a new project using your Rstudio project names.

    toggl_start()

By default the client name is “without client” you can choose (and eventualy create a client) by using :

    toggl_start(client = "my client")

But you can also choose the task and the project

    toggl_start(client = "my client",
                description = "what I'm doing",
                project_name = "my project")

## Stop the tracking system

    toggl_stop()

## Get total time passed on the current project

    get_current_duration()# the current track
    get_project_task_detail()# all the project (including the current track)

## Get all your dashboard

    get_dashboard()

## Use Rstudio Addins

This package comes with 2 Rstudio addins ‘start toggl’ and ‘stop toggl’, feel free to use keybindings for convenience.

## Some other useful functions are in this package

    ls(package:togglr)