https://github.com/nicconike/wakatime-leaderboards
Display your Wakatime Leaderboards Stats in your GitHub profile
https://github.com/nicconike/wakatime-leaderboards
coding coding-activity leaderboard public-leaderboards wakatime wakatime-api wakatime-leaderboard wakatime-stats
Last synced: about 2 months ago
JSON representation
Display your Wakatime Leaderboards Stats in your GitHub profile
- Host: GitHub
- URL: https://github.com/nicconike/wakatime-leaderboards
- Owner: Nicconike
- License: mit
- Created: 2024-07-22T21:58:59.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2025-06-29T18:47:34.000Z (4 months ago)
- Last Synced: 2025-06-30T22:51:51.481Z (4 months ago)
- Topics: coding, coding-activity, leaderboard, public-leaderboards, wakatime, wakatime-api, wakatime-leaderboard, wakatime-stats
- Language: Python
- Homepage: https://hub.docker.com/r/nicconike/wakatime-leaderboards
- Size: 220 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: .github/CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: .github/CODE_OF_CONDUCT.md
- Codeowners: .github/CODEOWNERS
- Security: .github/SECURITY.md
Awesome Lists containing this project
README
# Wakatime-Leaderboards📶
[](https://github.com/Nicconike/Wakatime-Leaderboards/actions/workflows/wakatime.yml)
[](https://github.com/Nicconike/Wakatime-Leaderboards/actions/workflows/release.yml)
[](https://github.com/Nicconike/Wakatime-Leaderboards/actions/workflows/bandit.yml)
[](https://github.com/Nicconike/Wakatime-Leaderboards/actions/workflows/codeql.yml)
[](https://sonarcloud.io/summary/new_code?id=Nicconike_Wakatime-Leaderboards)
[](https://codecov.io/gh/Nicconike/Wakatime-Leaderboards)
[](https://scorecard.dev/viewer/?uri=github.com/Nicconike/Wakatime-Leaderboards)
[](https://www.bestpractices.dev/projects/10748)
[](https://wakatime.com/badge/user/018e538b-3f55-4e8e-95fa-6c3225418eed/project/0caf06ca-663f-49f6-a95a-6282a945d92b)
[](https://badges.pufler.dev)
> ### Automated WakaTime Leaderboards for your GitHub Profile
***
## Prerequisites
1. **Wakatime API Key:** API key is required to fetch your account details. Get your API key from [here](https://wakatime.com/api-key).
2. **Markdown Comments:** Update the markdown file by adding the comments where your Wakatime Leaderboard Stats will be embedded to. Refer [here](#Update-Readme) to learn more.
> [!NOTE]
> **Coding Activity:** Total hours coded over the last 7 days from Yesterday, using default 15 minute timeout, only shows coding activity from known languages.
>
> **Public Leaderboards:** You will appear in the public leaderboards only if your weekly coded hours is around 10 hrs *(Changes from time to time)*.
>
> **Not in the Leaderboards?** You can follow their [Guidelines](https://wakatime.com/faq#missing-from-leaderboard) on how to show up in the Leaderboards.
***
## Example
### Wakatime Leaderboards (Worldwide)
#### Public Leaderboards (Weekly)
| Ranked | Hours Coded | Daily Avg |
| ------ | ----------- | --------- |
| 2999 | 26 hrs 53 mins | 3 hrs 50 mins |
#### Top Language (PowerShell)
| Ranked | Hours Coded | Daily Avg |
| ------ | ----------- | --------- |
| 1 | 17 hrs 27 mins | 2 hrs 29 mins |
***
## Update README
Add below comment in your markdown file for Wakatime Leaderboards Stats
```md
```
***
## Setup with Example
After completing the steps mentioned in the [Prerequisites](#Prerequisites), you have to save all the mentioned keys(except markdown comments) like Wakatime API Key as Secrets in your Github repo's settings.
> Repo Settings -> Security -> Secrets and Variables -> Actions -> Add in Repository Secrets
If you are new to **Github Secrets** then you can checkout this official doc [here](https://docs.github.com/en/actions/security-guides/using-secrets-in-github-actions).
**Sample Workflow File**
`wakatime.yml`
```yaml
name: Wakatime Leaderboards
on:
schedule:
# Runs every Monday at 12AM IST (UTC+5:30)
- cron: "30 18 * * 0"
workflow_dispatch:
push:
branches: master
jobs:
update-readme:
name: Wakatime Leaderboards
runs-on: ubuntu-latest
steps:
- name: Run Wakatime Leaderboards
uses: nicconike/wakatime-leaderboards@master
with:
WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
```
***
## Contributions
Star⭐ and Fork🍴 the Repo to start with your feature request(or bug) and experiment with the project to implement whatever Idea you might have and sent the Pull Request through 🤙
Please refer [Contributing.md](https://github.com/Nicconike/Wakatime-Leaderboards/blob/master/.github/CONTRIBUTING.md) to get to know how to contribute to this project.
And thank you for considering to contribute.
***