Skip to content

Nicconike/Wakatime-Leaderboards

Use this GitHub action with your project
Add this Action to an existing workflow or create a new one
View on Marketplace

Wakatime-LeaderboardsπŸ“Ά

Automated GitHub Action and Docker container to display your WakaTime leaderboard stats in your profile README.

Badges

Workflow Status

Wakatime Leaderboards Release CodeQL & Pylint Bandit Codecov Scorecard Security Dependency Review

Code Quality & Coverage

Pylint pre-commit.ci status codecov Quality Gate Status Maintainability Rating Security Rating Reliability Rating Coverage Code Smells Bugs Vulnerabilities Lines of Code Duplicated Lines (%) Technical Debt

Packaging & Deployment

Docker Image Size (tag) Docker Pulls GitHub Release Python Version from PEP 621 TOML PyPI - Version PyPI - Implementation Pepy Total Downloads PyPI - Format PyPI - Status

License & Security

GitHub License OpenSSF Scorecard OpenSSF Best Practices

Time Tracking

wakatime

Sample Output

Wakatime Leaderboards (Worldwide)

Public Leaderboards (Weekly)

Ranked Hours Coded Daily Avg
None 9 hrs 45 mins 1 hr 23 mins

Top Language (YAML)

Ranked Hours Coded Daily Avg
215 5 hrs 26 mins 46 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 }}
  1. 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

Sponsor this project

  •  

Packages

 
 
 

Contributors 4

  •  
  •  
  •  
  •