godot-wakatime

Godot plugin for metrics, insights, and time tracking automatically generated from your Godot usage.

Dependecies

Wakatime-cli uses Python to send the heartbeats to api.

For Linux/macOS users:

No dependencies. Python binary will be automatically found on your system.

For Windows users:

Download and install Python on system.

or
Download and extract Python embeddable zip file to the root path of the plugin (addons/wakatime). The extracted folder must contain python on its name to be automatically found by script.

Installation

Download and extract the zip from releases or clone the repository.
Put the extracted directory into your addons directory of your project. Create addons directory at the root of your project if you don't have one.
Activate godot-wakatime on Plugins tab at menu Project -> Project Settings -> Plugins.
Enter your Wakatime API Key on opened prompt.
Use Godot script editor for a while and check on https://wakatime.com/api/v1/users/current or https://wakatime.com/dashboard to see your coding activity :)

Tracking GDScript and GDNative files

For now, pygments doesn't support GDScript by default. The workaround is to use a custom rule to force any files ending with .gd to be categorized as GDScript. (https://wakatime.com/settings/rules)

Configuring

Some settings are available in the editor bottom panel as soon as the plugin is active

Wakatime settings and plugin settings (like Python binary path) are stored in the file at <GODOT_PROJECT>/addons/wakatime/settings.cfg.

Caveat

[Windows only] All heartbeats sent are printed to Godot output console. OS.execute do this by default and can't be disabled. Be careful to not reveal your printed API key to anyone.

TODO

Debug mode
Logs
Download and extract wakatime-cli from repo during plugin setup.
Add more cmdline args and let users change it on bottom panel
Remove cmdline output from Windows editor.

animeshrisal / touhou-platformer-game