wakapi-anyide 0.3.1

Time tracking for any IDE with WakaTime-like servers

wakapi-anyide

Log your coding time against any WakaTime-like server.

[!NOTE] Teenager? Check out High Seas!

[!IMPORTANT] wakapi-anyide has only been tested on Linux and Windows, and is still in development. Please report any tracking bugs!

Alternatives

You should try use an editor extension over wakapi-anyide if you can. If you don't need precise coding metrics, use the WakaTime app instead. (Not for High Seas!)

Quickstart guide

• Set your IDE to autosave as quickly as possible. This is how wakapi-anyide is able to track your coding time. Ideally, something like a second, so it saves as you type. However, anything under your editor timeout preference in your WakaTime settings is fine. For High Seas, it must be under two minutes.

• Install wakapi-anyide with your favourite Python package manager

• Run wakapi-anyide setup and follow the instructions

• Inspect and edit the generated wak.toml:

  # https://github.com/iamawatermelo/wakapi-anyide v0.3.1
  
  [wakapi-anyide]
  version = 1  # don't change this
  
  [files]
  include = ["/python/**/*.py", "/*.toml"]  # files to include in tracking
  exclude = ["/.venv"]  # files to exclude in tracking
  exclude_files = [".gitignore"]  # files whose contents will be used to exclude other files from tracking
  exclude_binary_files = true
  
  [project]
  name = "wakapi-anyide"  # your project name
  

• Run wakapi-anyide test in the same directory you have wak.toml in, and start coding for a bit. Ensure that wakapi-anyide is not tracking any generated files.

• Run wakapi-anyide track to actually track your progress. You must run this every time.

What wakapi-anyide sends

wakapi-anyide tells the WakaTime server:

• your OS and that you are using wakapi-anyide (wakatime/unset (Linux-none-none) wakapi-anyide-wakatime/unset)
• an anonymised hostname based off of your computer's name (anonymised machine 749f8c4e)
• the relative path of the files you change (./wakatime_anyide/__init__.py)
• the estimated time you have spent
• your estimated cursor position over time
• the estimated language of any files you edit (py, Makefile)
• the amount of lines changed
• the branch you are editing if you use Git
• any information you specified in the project section of wak.toml

Additionally, the WakaTime server will be able to see:

• your IP address, which means your approximate location
• the time of day your requests are being sent

Every website you visit can see this information.

wakapi-anyide does not send:

• any information about your system not listed above, like your username
• file content
• filenames outside of those included in your wak.toml

For security, wakapi-anyide does not use wakatime-cli.

Support for existing WakaTime configuration

wakapi-anyide supports the WAKATIME_HOME and the WAKATIME_API_KEY environment variables. The configuration value takes precedence over the environment variable.

$WAKATIME_HOME/.wakatime.cfg

Only these configuration values are supported:

[settings]

option	description	type	default value
api_key	Your WakaTime API key.	string
api_key_vault_cmd	A command to get your api key. Shell syntax is not supported, use sh -c "<your command>" for that.	string
api_url	The WakaTime API base url.	string	https://api.wakatime.com/api/v1
hostname	Optional name of local machine.	string	(an anonymised hostname)

All other configuration values are silently ignored.

.wakatime-project

Not supported.

Quirks and limitations

Tracking

wakapi-anyide is not integrated with your editor. It can only guess what you are doing through file changes. As such, it may sometimes pick up generated files.

Binary files

wakapi-anyide can track binary files with files.exclude_binary_files = false. File changes are reported specially:

• they are appended with #wakapi-anyide-binary in tracking
• cursor position is set to the last change in the binary file
• the line count are set to the binary diff count