| Type | 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: |
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
|
## đī¸ Obtaining a WakaTime token
Create a [WakaTime account](https://wakatime.com) and retrieve API key in [Account settings](https://wakatime.com/settings/account).

Then setup [WakaTime plugins](https://wakatime.com/plugins) to be ready to go!
## âšī¸ Examples workflows
```yaml
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 }}
```