Godot plugin for metrics, insights, and time tracking automatically generated from your Godot usage. https://wakatime.com
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
addons/wakatime
.gitattributes
LICENSE
README.md
icon.png
icon.png.import
project.godot
wakatime_logo.jpg

README.md

godot-wakatime

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

wakatime_dashboard

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

The easiest and fastest way is to install directly from Godot's AssetLib

  1. Access Godot's AssetLib inside the engine (F4 default keybind)
  2. Search for godot-wakatime and click on install button

Or, you can manually install the latest version following the next steps

  1. Download and extract latest zip file from releases.
  2. Copy or move the wakatime directory from the extracted zip and put into your project's addons directory. Create the addons directory at the root of your project if you don't have one.

Activation

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)

custom_rule_gdscript

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.

godot_wakatime_control

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.