Skip to content

Datacmd is the fastest, coolest way to turn raw data into stunning terminal dashboards. No setup, no fluff — just run a command and boom, your CSV or API becomes a live data experience. ⚡ CLI dashboards have never been this fun.

License

Notifications You must be signed in to change notification settings

VincenzoManto/Datacmd

Repository files navigation

🪄 Datacmd: auto-generative dashboards from different sources in your CMD

The Ultimate Terminal Dashboard

Turn any data source into a stunning interactive dashboard, directly in your terminal. No fluff, no GUI, just pure terminal sorcery. ⚡


Full documentation

The full documentation is available here: Datacmd Code Wiki

Why you'll love Datacmd

Tired of bloated web UIs? datacmd brings data visualization back to where real devs live: the terminal.

  • One Command = Instant Dashboard
  • Dynamic Widgets: Tables, charts, gauges, pies, radars & more
  • Smart Layout Engine: Auto-generates from data OR use YAML to customize
  • Real-Time Feeds: From APIs, metrics, JSON, CSV
  • Zero Setup: No deps, no bullshit, just go run

Think of it like htop meets grafana, but cooler and terminal-native.

It follows my obsession with data, which I developed by building https://datastripes.com, the web data engine that transform data analysis into simple flows.


Demo

screen-gif
Realtime stock tracker via datacmd --source=stock.json


🧰 Installation (pick your style)

Option 1: Download prebuilt binary (Recommended)

No setup, no Go, no stress.

✅ macOS · 🪟 Windows · 🐧 Linux

📦 Go to the Releases page and download the latest binary for your OS.

Then:

# macOS / Linux
chmod +x datacmd
./datacmd --generate --source=your-data.csv

# Windows
datacmd.exe --generate --source=your-data.csv

Option 2: Run from source (for Developers)

git clone https://github.com/VincenzoManto/Datacmd.git
cd datacmd
go mod tidy
go run main.go --generate --source=your-data.csv

How it works

# Auto-generate a dashboard from any CSV or JSON
datacmd --generate --source=./data.csv

# Or load your own layout
datacmd --config=dashboard.yml

Data sources supported:

  • .csv 📂
  • .json 📜
  • REST APIs 🌐
  • Live system metrics (CPU, RAM, disk) 🖥️

Widgets you can use

  • Table – Paginated, sortable
  • Gauge – Perfect for usage stats, thresholds
  • Pie Chart – Categorical comparisons
  • Line Chart – Trends, time-series
  • Radar – Multi-metric comparisons
  • Text Box – Notes, alerts, logs
  • Number – Big, bold KPIs
  • Funnel – Visualize stages in a process
  • Scatter – Correlation in dots
  • Histogram – Numeric distribution

Customize via YAML, or let --generate do it all.

Enhanced Gauge Widget

The gauge widget can be used to display aggregated values from your data. You can use the aggregation property to specify the aggregation type (sum, avg, median, max, min). The max_value property sets the upper bound for the gauge. If not provided, it's inferred from the data.

Here is an example of a gauge that shows the average CPU usage:

- type: gauge
  title: "Average CPU Usage"
  value_col: "cpu_usage_percent"
  aggregation: "avg"
  max_value: 100

Installation

git clone https://github.com/VincenzoManto/Datacmd.git
cd datacmd
go mod tidy

Quick Start

Example: stock.json

[
  {"ticker": "AAPL", "price": 175.50, "volume": 1200000},
  {"ticker": "GOOG", "price": 140.25, "volume": 950000},
  {"ticker": "MSFT", "price": 280.75, "volume": 1500000}
]
go run main.go --generate --source=stock.json

Instantly shows:

  • Table of stocks
  • Volume gauges
  • Market share pie chart

YAML Customization

layout:
  - type: table
    source: stock.json
    fields: [ticker, price, volume]

  - type: pie
    title: "Market Share"
    field: volume

Your dashboard, your rules.


🧬 Inspired by Datastripes. Rebuilt for Power Users.

datacmd is the spiritual open source successor to Datastripes, reimagined with more muscle, more magic, and zero fluff.


Linked resources

Based on datacmd, with the team @ Datatripes, we developed our complete and curated toolkit for data analysis

🤝 Community

We’re building more than a CLI, we’re starting a movement. Star the repo ⭐, submit PRs, file issues, or just show us the wild dashboards you build.


License

Apache 2.0, free as in freedom and fast as in Go.


GitHub Repo stars GitHub downloads Last commit GitHub License

Star History Chart

The full documentation is available here: Datacmd Code Wiki

I built `datacmd`, a tool that turns CSV/JSON/API into live dashboards,  directly in your terminal

✅ No deps
🪄 Auto layout
⚡ One command

→ https://github.com/VincenzoManto/datacmd

About

Datacmd is the fastest, coolest way to turn raw data into stunning terminal dashboards. No setup, no fluff — just run a command and boom, your CSV or API becomes a live data experience. ⚡ CLI dashboards have never been this fun.

Topics

Resources

License

Stars

Watchers

Forks

Languages