fork of the wakatime cli program for rana
Find a file
2015-02-12 18:36:14 -08:00
wakatime update readme with config file available settings. support setting proxy from config file. 2015-02-12 18:36:14 -08:00
.gitignore encode json when sending to urllib 2014-08-07 08:21:06 -07:00
AUTHORS set system language to English before running subversion program 2014-01-14 05:02:51 -08:00
HISTORY.rst v3.0.5 2015-01-13 14:00:16 -08:00
LICENSE update license 2014-12-21 19:54:00 -06:00
MANIFEST.in added version 0.0.1 2013-07-06 00:51:09 -07:00
README.rst update readme with config file available settings. support setting proxy from config file. 2015-02-12 18:36:14 -08:00
setup.py change pypi classifier to stable 2014-03-12 16:25:00 -07:00
wakatime-cli.py update wakatime descriptions 2013-12-13 15:09:09 +01:00

WakaTime
========

Fully automatic time tracking for programmers.

This is the common interface for the WakaTime api. You shouldn't need to directly use this package unless you are creating a new plugin or your text editor's plugin asks you to install the wakatime-cli interface.

Go to http://wakatime.com to install the plugin for your text editor.


Usage
-----

Install the plugin for your IDE/editor at https://wakatime.com/plugins

If you are building a plugin using the [WakaTime API](https://wakatime.com/developers/)
then follow the [Creating a Plugin](https://wakatime.com/help/misc/creating-plugin)
guide for information about using `wakatime-cli.py`.


Configuring
-----------

Options can be passed via command line, or set in the `$HOME/.wakatime.cfg`
config file. Command line arguments take precedence over config file settings.
The `$HOME/.wakatime.cfg` file is in [INI](http://en.wikipedia.org/wiki/INI_file)
format. An example config file looks like:

```
[settings]
debug = false
api_key = your-api-key
hidefilenames = false
ignore =
    ^COMMIT_EDITMSG$
    ^TAG_EDITMSG$
    ^/var/
    ^/etc/
offline = true
proxy = https://user:pass@localhost:8080
```


Installation
------------

Each plugin installs wakatime for you, but for testing you can install the
common api interface with pip:

    pip install wakatime