This GitHub Action collects your GitHub data and coding activity from WakaTime. It updates a part of your README.md file with cool metrics from this data and then commits and pushes the changes to your repository.

1. Special Repository: To make this Action work, you need a special repository with the same name as your GitHub username (e.g., username/username). This is a special repository on GitHub where the README will show up on your profile.

2. Update the Markdown File: You need to add two special comments to your Markdown (.md) file. These comments will be used to update the file with the metrics. You can add these comments anywhere in the file, but it's recommended to add them at the end of the file.

   <!--START_SECTION:readme-stats-->
   <!--END_SECTION:readme-stats-->

   The Action will replace everything between these two comments with the metrics. You can also specify a section name in the SECTION_NAME environment variable.

3. GitHub Access Token: To get commit information, you need a GitHub Access Token with repo and user permissions, available here.

   Although giving repo access might seem risky, this Action only accesses commit timestamps and lines of code added or deleted in the repositories you contributed to, which is completely safe.

4. WakaTime API Key (Optional): If you want to use the WAKATIME_SPENT_TIME metric, you will need a WakaTime API Key. You can get this from your WakaTime Account Settings.

5. Store Access Keys in Secrets: You need to store the WakaTime API Key and GitHub Access Token in your repository secrets. You can find this option in the Settings of your GitHub repository. Make sure to save them under the following names:

   • WAKATIME_API_KEY: Your WakaTime API Key.
   • GH_TOKEN: Your GitHub Access Token.

The SHOW_METRICS environment variable is used to specify the metrics to show in the README.md file. You can choose from the following metrics:

COMMIT_TIMES_OF_DAY: The distribution of your commits across different times of the day, such as morning, daytime, evening, and night.

🕒 I'm An Afternoon Warrior 🥷🏻

 🌅 Morning                136 commits         ███████░░░░░░░░░░░░░░░░░░   29.18%
 🌞 Daytime                265 commits         ██████████████░░░░░░░░░░░   56.87%
 🌆 Evening                1 commit            ░░░░░░░░░░░░░░░░░░░░░░░░░   00.21%
 🌙 Night                  64 commits          ███░░░░░░░░░░░░░░░░░░░░░░   13.73%

COMMIT_DAYS_OF_WEEK: The days of the week you make commits.

📅 I'm Most Productive on Sundays

 Sunday                   112 commits         ██████░░░░░░░░░░░░░░░░░░░   24.03%
 Monday                   57 commits          ███░░░░░░░░░░░░░░░░░░░░░░   12.23%
 Tuesday                  58 commits          ███░░░░░░░░░░░░░░░░░░░░░░   12.45%
 Wednesday                73 commits          ████░░░░░░░░░░░░░░░░░░░░░   15.67%
 Thursday                 94 commits          █████░░░░░░░░░░░░░░░░░░░░   20.17%
 Friday                   31 commits          ██░░░░░░░░░░░░░░░░░░░░░░░   06.65%
 Saturday                 41 commits          ██░░░░░░░░░░░░░░░░░░░░░░░   08.80%

LANGUAGE_PER_REPO: The languages you use in each repository.

🔥 I Mostly Code in Go

Go                       6 repos             █████████████████████░░░░   85.71%
TypeScript               1 repo              ████░░░░░░░░░░░░░░░░░░░░░   14.29%

LANGUAGES_AND_TOOLS: The languages and tools you used on your projects.

💬 Languages & Tools

WAKATIME_SPENT_TIME: The time you spent coding on WakaTime.

Use the WAKATIME_DATA environment variable to specify the data to show.

• EDITORS: The editors you use.

  📝 Editors:
  PhpStorm                 42 hrs 14 mins      ███████████████████████░░   93.02%
  GoLand                   3 hrs 10 mins       ██░░░░░░░░░░░░░░░░░░░░░░░   06.98%
  

• LANGUAGES: The languages you code in.

  💬 Languages:
  Go                       22 hrs 19 mins      ████████████░░░░░░░░░░░░░   49.16%
  JavaScript               14 hrs 41 mins      ████████░░░░░░░░░░░░░░░░░   32.34%
  Python                   1 hr 53 mins        █░░░░░░░░░░░░░░░░░░░░░░░░   04.18%
  Java                     1 hr 27 mins        █░░░░░░░░░░░░░░░░░░░░░░░░   03.20%
  C++                      1 hr 15 mins        █░░░░░░░░░░░░░░░░░░░░░░░░   02.78%
  Ruby                     1 hr 12 mins        █░░░░░░░░░░░░░░░░░░░░░░░░   02.66%
  PHP                      52 mins             ░░░░░░░░░░░░░░░░░░░░░░░░░   01.92%
  TypeScript               43 mins             ░░░░░░░░░░░░░░░░░░░░░░░░░   01.58%
  Swift                    22 mins             ░░░░░░░░░░░░░░░░░░░░░░░░░   00.81%
  Rust                     15 mins             ░░░░░░░░░░░░░░░░░░░░░░░░░   00.56%
  Others                   16 mins             ░░░░░░░░░░░░░░░░░░░░░░░░░   00.80%
  

• PROJECTS: The projects you work on.

  📦 Projects:
  Project A                6 hrs 47 mins       ███████████████████░░░░░░   77.43%
  Project B                1 hr 35 mins        ████░░░░░░░░░░░░░░░░░░░░░   18.07%
  Project C                23 mins             █░░░░░░░░░░░░░░░░░░░░░░░░   4.49%
  

• OPERATING_SYSTEMS: The operating systems you use.

  💻 Operating Systems:
  Windows                  42 hrs 14 mins      ████████████████████░░░░░   70.00%
  Mac                      12 hrs 10 mins      ███████░░░░░░░░░░░░░░░░░░   20.00%
  Linux                    6 hrs  3 mins       ████░░░░░░░░░░░░░░░░░░░░░   10.00%
  

You can use the WAKATIME_RANGE environment variable to set the time range for WakaTime statistics. Each value will show a specific label as follows:

• last_7_days: What I Focused On in the Last 7 Days
• last_30_days: How I Spent My Time Over the Last 30 Days
• last_6_months: Where My Time Went in the Last 6 Months
• last_year: My Time Highlights from Last Year
• all_time: How I’ve Used My Time Across All Time

Note: If you don't provide the WAKATIME_API_KEY, the WAKATIME_SPENT_TIME metric will not be shown.

You can use the PROGRESS_BAR_VERSION environment variable to specify the version of the progress bar to use. The available versions are:

• 1: Default Progress Bar: Uses the default progress bar style.

████░░░░░░░░░░░░░░░░░░░░░

• 2 Square Symbol Progress Bar: Uses the square symbol for the progress bar. This version also shows the half block (the remaining percentage is not enough to fill a whole block) for the progress bar.

🟩🟩🟩🟩🟩🟩🟩🟩🟨⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜⬜

name: Update README.md

on:
  schedule:
    - cron: '0 0 * * *' # Runs every day at midnight
  workflow_dispatch:
jobs:
  update-readme:
    name: Update README.md
    runs-on: ubuntu-latest
    permissions:
      contents: write
    steps:
      - name: Checkout
        uses: actions/checkout@v4
      - name: Run GitHub Stats Action
        uses: thanhhaudev/github-stats@master
        env:
          BRANCH_NAME: ${{ github.ref_name }}
          GITHUB_TOKEN: ${{ secrets.GH_TOKEN }} # GitHub token, required
          WAKATIME_API_KEY: ${{ secrets.WAKATIME_API_KEY }}
          WAKATIME_DATA: "EDITORS,LANGUAGES,PROJECTS,OPERATING_SYSTEMS" # show data, separated by comma
          SHOW_METRICS: "COMMIT_TIMES_OF_DAY,LANGUAGE_PER_REPO,COMMIT_DAYS_OF_WEEK,WAKATIME_SPENT_TIME" # show metrics, separated by comma
          SHOW_LAST_UPDATE: "true" # show last update time
          ONLY_MAIN_BRANCH: "true" # only fetch data from the main branch

This project is inspired by waka-readme-stats, which is a similar project that uses GitHub Actions to update your README with awesome metrics.