Toggl2Redmine

PHP CLI tool for syncing toggl with redmine., _(*1)

, _(*2)

Time entry sync

Currently only time-entry-sync is available., _(*3)

One-way-synchronisaton from toggl to Redmine
Mapping of Toggl tag name with Redmine
Sync state is marked as tag #synched in Toggl

Installation

The installation is simple by using composer. After installing composer you can either install the command globally or within a project., _(*4)

Global

In the global installation toggl2redmine will be available as a command line tool., _(*5)

Run composer global require derhasi/toggl2redmine to install globally.
Add export PATH=~/.composer/vendor/bin:$PATH to your .bashrcor .profile

After the installation you should be able to run toggl2redmine time-entry-sync ... from anywhere., _(*6)

Local

You can run composer require derhasi/toggl2redmine in any composer enabled project to add this project as a dependency., _(*7)

Usage

You can run the global or local command by appending options, use a configuration file or use both. A command line argument or option will allways override a setting from the toggl2redmine.yml., _(*8)

Global: toggl2redmine.php time-entry-sync ..., _(*9)

Local: ./toggl2redmine time-entry-sync ..., _(*10)

Command line arguments and options

Usage:
 time-entry-sync [--workspace="..."] [--fromDate="..."] [--toDate="..."] [--defaultActivity="..."] redmineURL redmineAPIKey tooglAPIKey

Arguments:
 redmineURL            Provide the URL for the redmine installation
 redmineAPIKey         The APIKey for accessing the redmine API
 tooglAPIKey           API Key for accessing toggl API

Options:
 --workspace           Workspace ID to get time entries from
 --fromDate            From Date to get Time Entries from (default: "-1 day")
 --toDate              To Date to get Time Entries from (default: "now")
 --defaultActivity     Name of the default redmine activity to use for empty time entry tags (default: "")

Configuration

You can place a toggl2redmine.yml in your current working directory for local defaults. For global defaults you can place it at ~/.toggl2redmine/toggl2redmine.yml. Attention: local and global defaults will not be merged. The local default always take precedence over the global defaults, in the case it exists., _(*11)

You can find a template for toggl2redmine.yml at default.toggl2redmine.yml. Make sure to rename it to toggl2redmine.yml!, _(*12)

For example, for adding the default config template to the global folder you can simply type:, _(*13)

mkdir ~/.toggl2redmine
curl https://raw.githubusercontent.com/derhasi/toggl2redmine/master/default.toggl2redmine.yml > ~/.toggl2redmine/toggl2redmine.yml