time-tracer

Atomatic time tracking powered by any command line tool (default is watson) for Atom. Never again forget starting or stopping the timer!

Features

• you choose what time tracking tool is used in the background
• global and project specific configuration options
• use the power of NodeJS to fully customize command arguments
• starts tracking time automatically when you work in Atom
• stops tracking time when you're inactive in Atom
• stops tracking when your machine goes to sleep
  • currently only macOS is supported without any extra work (see Installation)
• upon Atom window switch tracking is also switched from the previous project to the current window's one
• check your stats in the status bar
• keep tracking your time while you're in a meeting (using the meeting command)
  • a meeting tag is added to your current project tracking by default
  • you can specify another project in the appearing in-Atom lock-screen
  • hit escape to cancel

Installation

apm install time-tracer
# on macOS (see https://tailordev.github.io/Watson/#installation for more details)
brew install watson

If you're not on macOS and want to enable automatically stop tracking when your machine goes to sleep, you have to install a command line tool of your choice on your user's shell $PATH and add the tool's name to the sleep watcher setting.

Usage

This package tracks your interactions in Atom. Whenever you do something actively a timer is started. The timer stops if you haven't done anything in a while.

Since everything is configurable you can use this package with any time tracking tool you want. Most of the configuration is done in Atom's settings panel. But project-specific settings can be defined in a timetracer.config.js file. See section Configuration for more details.

Status bar

Unless disabled, there is a status bar tile which shows a watch and the time until the timer will be stopped (using a mini pie chart). On hover the time spent on the project is displayed (days mean work days - the amount of hours per work day can be configured). On click a chart is displayed showing how much you worked on what tags.

Configuration

Atom settings

See the config for details.

timetracer.config.js

This file can and should be used to add/overwrite project specific settings. All keys of the Atom settings may be overwritten.

Additionally, the name and tags properties may be defined. name equals %project (default is all project folder names joined by __) and tags equals %tags (default '') in the command settings.

Furthermore, you can define callbacks for onStart and onStop to run a JavaScript function in addition to or instead of the start and stop commands, respectively.

Since the config file is a JS file you can dynamically generate tags. You could for example use the staged files as tags to see how long you've approximately worked on certain files.

See the example config file.

UI tweaks

As always, you can use your Atom's styles.less to customize this package's style. For example, if you want only part of the status bar tile to be rendered, you can hide the others. In this case you should use the following selectors:

.status-bar {
    .time-tracer {
        .icon {}
        .timer {}
        .project-name {}
    }
}

Thanks to

• Akuma901 and his time tracker for inspiration for the status bar tile