metrics/source/plugins/wakatime

← Back to plugins index
⏰ WakaTime plugin
This plugin displays statistics from your WakaTime account.
Supported features → Full specification	📗 Classic template
	👤 Users
	🗝️ plugin_wakatime_token

➡️ Available options

Option	Description
plugin_wakatime	Enable wakatime plugin
type: boolean default: no
plugin_wakatime_token	WakaTime API token
🔐 Token type: token
plugin_wakatime_days	Time range
type: string default: 7 allowed values: 7 30 180 365
plugin_wakatime_sections	Displayed sections time: show total coding time and daily average projects: show most time spent project projects-graphs: show most time spent projects graphs languages: show most language languages-graphs: show languages graphs editors: show most used code editor editors-graphs: show code editors graphs os: show most used operating system os-graphs: show code operating systems graphs
type: array default: time, projects, projects-graphs, languages, languages-graphs, editors, os allowed values: time projects projects-graphs languages languages-graphs editors editors-graphs os os-graphs
plugin_wakatime_limit	Display limit (per graph)
type: number (0 ≤ 𝑥) zero behaviour: disable default: 5
plugin_wakatime_url	WakaTime url Also compatible with self-hosted instance (wakapi)
type: string default: https://wakatime.com
plugin_wakatime_user	WakaTime username
⏯️ Cannot be preset type: string default: current
plugin_wakatime_languages_other	Include other languages
type: boolean default: no
plugin_wakatime_languages_ignored	Ignored languages
type: array (comma-separated)
plugin_wakatime_repositories_visibility	Repositories visibility Lets you hide private repositories.
type: string default: all allowed values: public all

🗝️ Obtaining a WakaTime token

Create a WakaTime account and retrieve API key in Account settings.

Then setup WakaTime plugins to be ready to go!

ℹ️ Examples workflows

name: WakaTime
uses: lowlighter/metrics@latest
with:
  filename: metrics.plugin.wakatime.svg
  token: NOT_NEEDED
  base: ""
  plugin_wakatime: yes
  plugin_wakatime_sections: time, projects, projects-graphs, languages, languages-graphs, editors, os
  plugin_wakatime_token: ${{ secrets.WAKATIME_TOKEN }}