DEV Community

JUNG SEUNGHOON
JUNG SEUNGHOON

Posted on

I built a terminal-style ASCII GitHub stats generator

I recently built a small project that turns GitHub stats into terminal-style ASCII art.

If you like retro vibes, terminals, or ASCII aesthetics, this might be for you.

GitHub logo seuthootDev / github-readme-insight-terminal-ascii

A tool to generate terminal-style ASCII SVGs from your GitHub profile contribution data

GitHub README Insight Terminal ASCII

A tool to generate terminal-style ASCII SVGs from your GitHub profile contribution data.
Like github-readme-stats, you can embed it in your README or GitHub profile with a single URL.

  • Themes: macOS Terminal / Windows PowerShell / Ubuntu GNOME styles
  • CLI: Run locally to print to terminal and save SVG
  • API: Returns SVG via GET /svg?user=USER&theme=... (default grass) or GET /svg/:type?user=USER&theme=...
  • Tooltip: Hover each cell to see date and contribution count

theme=mac — macOS Terminal (zsh)

mac

theme=window — Windows PowerShell

window

theme=ubuntu — Ubuntu GNOME Terminal

ubuntu

Stats previews (mac / window / ubuntu)

mac stats window stats ubuntu stats

Top-language previews (mac / window / ubuntu)

mac top language window top language ubuntu top language


Introduction

  • Enter a GitHub username to fetch the last year's contribution data and render a contribution grid.
  • Renders a terminal-style SVG directly in Node.js, including hover tooltips with date and contribution count.
  • Each theme has a distinct terminal window style (title…

You can just drop it into your README like this:

![GitHub stats](https://github-readme-insight-terminal-asci.vercel.app/svg?user=YOUR_ID&theme=mac)

There are already great tools like github-readme-stats,
but I wanted something a bit more retro

If you’re into this kind of style or have ideas, feel free to open an issue or PR

Top comments (0)