Vizb

A tabular visualization engine for CSV, JSON, and benchmark output. Turns numeric columns into interactive charts and descriptive statistics in one self-contained HTML file — no server, no dependencies, no build step.

Getting Started · Parser Guide · Tabular Data · CLI Commands · Grouping · Merging · CI/CD
_{Full documentation at vizb.goptics.org}

Installation

Quick Install

Linux / macOS

curl -fsSL https://vizb.goptics.org/install.sh | bash

Windows

irm https://vizb.goptics.org/install.ps1 | iex

Quick Example

Run one command to turn your GitHub contribution history into a 3D skyline of your activity over time. Each year stacks as a new layer; within it, every day is a column whose height is your contribution count. Replace <your-github-username> with your GitHub username and open the generated index.html.

torvalds-contribution-history.mp4

_{Example: torvalds contribution history}

Linux / macOS

curl -s "https://github-contributions-api.jogruber.de/v4/<your-github-username>" \
  | vizb bar \
      --group date \
      --group-pattern '[z{Year}-y{Month}-x{Date}]' \
      --json-path '.contributions' \
      --select 'count{Contributions}' \
      --stat \
      --output index.html

Windows

(iwr "https://github-contributions-api.jogruber.de/v4/<your-github-username>").Content `
  | vizb bar `
      --group date `
      --group-pattern '[z{Year}-y{Month}-x{Date}]' `
      --json-path '.contributions' `
      --select 'count{Contributions}' `
      --stat `
      --output index.html

Flags used:

• --group date — group rows by date
• --group-pattern '[z{Year}-y{Month}-x{Date}]' — split each date into Year / Month / Day axes (z / y / x)
• --json-path '.contributions' — pull the nested contributions array out of the API envelope
• --select 'count{Contributions}' — keep only the count column and rename it to Contributions
• --stat — add the statistics panel
• --output index.html — write a self-contained HTML file

Go Toolchain

go install github.com/goptics/vizb@latest

Download Binary

Pre-built binaries for Linux, macOS, and Windows are available on the releases page.

Contributing

Contributions are welcome! See CONTRIBUTING.md for setup, build/test commands, and how to add a parser.

License

This project is licensed under the MIT License — see the LICENSE file for details.