alfred-toggl

command module
v1.1.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Jan 3, 2015 License: MIT Imports: 12 Imported by: 0

README

alfred-toggl

An Alfred workflow for accessing the Toggl time-tracking service

Screenshot

Installation

Download the latest workflow package from the releases page and double click it — Alfred will take care of the rest.

Usage

The workflow uses one main keyword: “tgl”. The first time you use the keyword, only two items will be available: login and token. Actioning login will prompt you for your username and password, which are used to temporarily authenticate with toggl.com to retrieve your API token. The token item can be used to manually enter your API token (available at the bottom of your Toggl profile page).

Login

Once you’ve logged in, a number of commands will be available.

Main menu

Items may be either “tabbed” or “actioned”. Tabbing means to press the Tab key, and actioning means to press the Return or Enter key.

timers

The timers command lists all user time entries created during the last 9 days, up to 1000. Entries are listed in reverse chronological order by start time. If a timer is active, it’s icon will be green.

Timers list

Actioning a time entry will start a new time entry with the same project and description and the actioned entry.

Tabbing a time entry will show a list of entry properties (description, project, tags) and subcommands (delete). Tabbing a selected property will show that property’s value. Some properties, such as “description”, can be modified. For these, entering a new value and pressing Enter will update the time entry.

Timer menu

Actioning the “delete” command will first ask the user to confirm the deletion, then delete the time entry.

Delete confirmation

projects

The projects command lists all user projects. Projects are listed in reverse creation order. If a timer is active, its project icon will be green.

Projects list

Tabbing a project will present a list of properties (name) and subcommands (delete). Tabbing a property will show the property’s value, and may allow it to be changed. Actioning a subcommand will execute the subcommand.

Project menu

tags

The tags command lists all user tags in alphabetical order.

Tags list

Tabbing a tag will present a list of properties (name) and subcommands (delete). Tabbing a property will show the property’s value, and may allow it to be changed. Actioning a subcommand will execute the subcommand.

Tag menu

report

The report command can be used to generate summary time-spent reports for the current or previous days or for the current week (starting on Monday).

Report menu

Tabbing one of the report types will show the total hours for the given time frame, as well as a breakdown of how many hours were spent on each project.

This week's report

Tabbing one of the projects will show how time was spent on that project, broken up by task. Multiple time entries with the same description will be grouped into a single task.

This week's report for a project

sync

The sync command will download current user data, including account info, tags, projects, and time entries for the last 9 days, from Toggl.com. Tabbing the sync item, or just typing “sync”, will begin the sync process. sync is not an actionable command, and actioning the sync item will simply autocomplete it (just like tabbing). After a few seconds, the item’s message will changed to “Synchronized!”, showing that the sychronization process is complete.

logout

The logout commmand will clear the locally stored copy of the user's API token, preventing the workflow from interacting with Toggl.com. Other locally cached data and configuration information is not affected.

reset

The reset command will clear all locally cached data and configuration information, including the API token. This returns the workflow to a clean initial state.

Documentation

The Go Gopher

There is no documentation for this package.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL