PAC-CONTRIBUTIONS Backend

PAC-CONTRIBUTIONS

// eat your github history //

github.com/

PAC SPEED:

SOURCE

SVG

CACHE

MISS

TOTAL

STATUS

READY

SCORE: 000000

371 CELLS LEFT

100% EATEN

Waiting for data

LIVE PREVIEW

skp8500's GitHub Contributions

README EMBEDProfile README setup guide

Pac-Man GitHub Contribution Graph — Setup Guide

Transform your GitHub contribution graph into an animated Pac-Man display for your profile README.

Features

Animated Pac-Man contribution graph

Dark mode support

Light mode support

Automatic daily updates via GitHub Actions

Compatible with any GitHub profile README

STEP 1 — CREATE YOUR GITHUB PROFILE REPOSITORY

Your GitHub profile repository must follow this format:

YOUR_USERNAME/YOUR_USERNAME

Example:

skp8500/skp8500

If the repository does not exist:

1. Go to GitHub

2. Create a new repository

3. Set the repository name as your GitHub username

4. Make the repository public

5. Initialize it with a README

STEP 2 — CREATE THE WORKFLOW FILE

Inside your profile repository, create the following file:

.github/workflows/pacman.yml

Add the following configuration:

Workflow YAML

name: Generate Pac-Man

on:
  schedule:
    - cron: "17 3 * * *"
    - cron: "47 15 * * *"

  workflow_dispatch:

permissions:
  contents: write

concurrency:
  group: generate-pacman-svg
  cancel-in-progress: true

jobs:
  generate:
    runs-on: ubuntu-latest
    timeout-minutes: 15

    steps:
      - uses: actions/checkout@v5

      - uses: skp8500/PAC-CONTRIBUTIONS@main
        with:
          github_token: ${{ secrets.GITHUB_TOKEN }}

STEP 3 — ENABLE WORKFLOW WRITE PERMISSIONS

Navigate to:

Repository → Settings → Actions → General

Under Workflow permissions, enable:

Read and write permissions

Click Save.

This permission is required for the workflow to generate and push SVG files to the output branch.

STEP 4 — RUN THE WORKFLOW

1. Open the Actions tab

2. Select Generate Pac-Man

3. Click Run workflow

The workflow typically completes within a minute.

STEP 5 — VERIFY THE OUTPUT BRANCH

After the workflow completes successfully, a new branch named:

output

will be created.

The branch should contain:

pacman-dark.svg
pacman-light.svg

STEP 6 — ADD PAC-MAN TO YOUR README

Open your README.md file.

Dark Mode Only HTML

<img alt="Pac-Man contribution graph"
     src="https://raw.githubusercontent.com/skp8500/skp8500/output/pacman-dark.svg?v=1" />

Automatic Dark & Light Mode HTML

<picture>
  <source media="(prefers-color-scheme: dark)"
          srcset="https://raw.githubusercontent.com/skp8500/skp8500/output/pacman-dark.svg" />

  <img alt="Pac-Man contribution graph"
       src="https://raw.githubusercontent.com/skp8500/skp8500/output/pacman-light.svg" />
</picture>

EXAMPLE

If your GitHub username is:

skp8500

Use:

<img alt="Pac-Man contribution graph"
     src="https://raw.githubusercontent.com/skp8500/skp8500/output/pacman-dark.svg?v=1" />

AUTOMATIC UPDATES

The workflow updates the graph daily using:

schedule:
  - cron: "17 3 * * *"
  - cron: "47 15 * * *"

Using two off-peak schedules reduces the chance of delayed or dropped scheduled runs.

The output branch also gets a small heartbeat update on every run so GitHub is less likely to disable the schedule for inactivity.

TROUBLESHOOTING

404 Not Found

Possible causes:

The output branch has not been created yet

The workflow failed

GitHub automatically disabled scheduled workflows after 60 days with no repository activity

Solutions:

Run the workflow manually

Ensure workflow permissions are enabled

Verify that the output branch exists

Re-enable the workflow from the Actions tab if GitHub disabled its schedule

Workflow Permission Error

Settings → Actions → General → Read and write permissions

Contribution Graph Not Updating

GitHub may cache SVG files aggressively.

To force a refresh, update the version parameter:

?v=2

Example:

<img src="https://raw.githubusercontent.com/skp8500/skp8500/output/pacman-dark.svg?v=2" />

Increase the version number whenever you want to refresh the cache.

FINAL RESULT

Animated Pac-Man contribution graph

Dark mode support

Light mode support

Automatic daily updates

Fully automated GitHub profile animation

API ENDPOINT

/api/contributions/skp8500

RESPONSE SHAPE

{
  "username": "skp8500",
  "source": "svg",
  "cached": false,
  "generatedAt": null,
  "totalContributions": 0,
  "contributions": [
    {
      "date": "2000-01-01",
      "count": 0,
      "level": 0
    },
    {
      "date": "2000-01-01",
      "count": 0,
      "level": 0
    }
  ]
}

BUILT BY skp8500 · OPEN SOURCE · MIT