Wakatime-Leaderboards 1.2.4

Automated WakaTime Leaderboards for your GitHub profile

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

1. Get your WakaTime API Key
2. Save it as GitHub Secret in your profile repository
3. 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 }}

4. 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

1. Wakatime API Key: API key is required to fetch your account details. Get your API key from here.
2. 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