Wakatime-Leaderboards📶
Automated GitHub Action and Docker container to display your WakaTime leaderboard stats in your profile README.
Badges
Workflow Status
Code Quality & Coverage
Packaging & Deployment
License & Security
Time Tracking
Sample Output
Wakatime Leaderboards (Worldwide)
Public Leaderboards (Weekly)
| Ranked | Hours Coded | Daily Avg |
|---|---|---|
| 5230 | 19 hrs 27 mins | 2 hrs 46 mins |
Top Language (YAML)
| Ranked | Hours Coded | Daily Avg |
|---|---|---|
| 85 | 7 hrs 34 mins | 1 hr 4 mins |
Quick Start
- Get your WakaTime API Key
- Save it as GitHub Secret in your profile repository
- Add to your workflow:
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: Wakatime Leaderboards
uses: nicconike/wakatime-leaderboards@master
with:
WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
- Add markdown comments to your README:
<!-- Wakatime-Start -->
<!-- Wakatime-End -->
Features
| Feature | Description |
|---|---|
| 🏆 Global Leaderboards | Worldwide coding stats |
| 💻 Language Rankings | Top language leaderboards |
| ⚡ Automated Updates | Scheduled via GitHub Actions |
| 🐳 Docker Support | Containerized execution |
Prerequisites
- Wakatime API Key: API key is required to fetch your account details. Get your API key from here.
- Markdown Comments: Update the markdown file by adding the comments where your Wakatime Leaderboard Stats will be embedded to.
[!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 on how to show up in the Leaderboards.
Support 💙
Star ⭐ this project if you find it useful!
For detailed support options: Contributing Guide
🐛 Report Issues • 💬 Discussions
1 maintainer
Metadata
1 maintainer
Release files for Wakatime-Leaderboards 1.2.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| wakatime_leaderboards-1.2.4.tar.gz | 10.7 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| wakatime_leaderboards-1.2.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 15.7 kB
Release files / wakatime_leaderboards-1.2.4.tar.gz
| Download URL | wakatime_leaderboards-1.2.4.tar.gz |
|---|---|
| Size | 10.7 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
be6cef81b27f6d060eb2f3cb52412e927aaa217c388ba7331f9f8be0a2fa7b97
|
|
BLAKE2b-256 checksum How to use checksums |
5b437cb4b227d914e5fbee86366f2e841262e7f2ac5bf065daa4cfd69aebc304
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2025.
Transparency logRelease files / wakatime_leaderboards-1.2.4-py3-none-any.whl
| Download URL | wakatime_leaderboards-1.2.4-py3-none-any.whl |
|---|---|
| Size | 4.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
64c64338a697bcf3ff3b2b50236372c6630a0ced181f5df0458976013ef47d2e
|
|
BLAKE2b-256 checksum How to use checksums |
c794386504666f40235d7ffc0af50c6e3b91b44d8e8f9817c22ba3a81e7212a5
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 9, 2025.
Transparency log
