WakatimeBlender is a simple plugin for the Blender 3D graphics software that sends time-tracking statistics to the Wakatime online service using official wakatime client.
To install the plugin you need to download the source code archive from Releases section.
Chose the version made for your version of Blender.
Save it somewhere, open the Blender, go to Edit->Preferences...->Add-ons->Install...
Select the downloaded .zip
and click Install Addon
.
Then check the check-box near the plugin name in the list to enable it.
After that a dialog prompting to enter the Wakatime API key may appear. Enter your key here and push "OK". If the key is incorrect and an attempt to send statistics fails the dialog will show up again.
If wish to change the key or other settings, press Space to summon the floating search menu, then start type "wakatime" until corresponding actions are shown. Select "Wakatime Preferences" to summon the dialog again.
Another way to get to this dialog is through the Blender->System-> menu
When setup is finished, the plugin should start sending the time you've spent on the currently loaded .blend file automatically in the background. Note, that unless you save a newly created file no stats are gathered, because Wakatime needs a filepath.
If you need to re-download wakatime client, use the menu/search action "Download wakatime client". The progress will be reported in the "Info" window as well as on the status bar.
Wakatime will try to detect the projects name, e.g. from the git-repo.
If you do not work with git, the project's name would be "Unknown Project" within Wakatime.
So this Add-On can construct the project name from the current .blend
file name or from the name of its parent folder.
To fine-tune the project's name there are some options available under Blender->System->Wakatime Preferences (or through the global search menu).
The first two check-boxes allow you to decide whether to always use the guessed name from this Add-On, effectively overwriting WakaTime discovered name (i.e. the git-repo).
.blend
fileThe following options only work when the Overwrite project-discovery with the name from below is enabled.
The Use folder-name as projectname check-box enables the use of .blend file parent folder name as the base of the Wakatime-project-name:
.blend
extension) is used.blend
file is usedWith the project-name extracted, further processing takes place:
The Heartbeat Frequency option allows to change the interval (in minutes) of sending idle activity reports to wakatime server.
When working on issues and/or new features, please, use the latest stable Blender and the python it bundles.
Before submitting a PR, always format the code with black
. I don't particularly like
its style myself, but it's the easiest-to-set-up common ground.