Scatters

A CLI to instantly turn tabular data and audio files into interactive, self-contained HTML scatter plots.

scatters reads CSV, JSON, Parquet, Excel, and common audio files, then generates beautiful, interactive charts powered by ECharts. It works recursively on directories and saves each plot as a single .html file that requires no internet connection or server to view.

Features

• Broad Format Support: Process CSV, Parquet, JSON/JSONL, Excel (XLSX/XLS), and audio (WAV, MP3, FLAC).
• Interactive Plots: Output includes zoom/pan controls, a draggable legend, a toolbox to save the chart as an image, and tooltips for data points.
• Fully Self-Contained: Generates single HTML files with all necessary JS/CSS included from a CDN. No local dependencies or servers needed to view the plots.
• Intelligent Defaults: Automatically detects the best column for the X-axis (prioritizing datetimes) and plots all other numeric columns.
• Powerful Customization: Use CLI flags to specify X/Y columns, set a title, choose a light or dark theme, enable animations, and more.
• Directory Processing: Point it at a folder to recursively find and process all supported files.
• Special Markers: Use a | value in a string column to draw vertical marker lines on your plot for highlighting events.
• Large File Support: Intelligently downsample massive datasets using the --downsample flag to keep plots fast and responsive.

Installation

Ensure you have the Rust toolchain installed. You can then install scatters using Cargo:

cargo install scatters