Version: 0.6.0
License: MIT
Author: RK Riad Khan
Repository: github.com/rkriad585/termatplotlib
A lightweight, zero-dependency Python library for rendering ASCII plots directly in the terminal. Visualize data with bar charts, scatter plots, line charts, pie charts, histograms, area charts, box plots, and heatmaps — all with ANSI color support, grid lines, legends, and file output.
- 28 chart types — bar, grouped bar, stacked bar, diverging bar, vertical bar, scatter, line, pie, histogram, area, box plot, violin plot, heatmap, calendar heatmap, candlestick, sparkline, radar, waterfall, gantt, step chart, bubble chart, strip plot, sankey, funnel, bullet, donut, pareto, wordcloud
- Zero dependencies — pure Python, stdlib only, Python >=3.6
- Logarithmic axes —
log_x/log_yfor scatter, line, area - Error bars —
error_yon bar charts, and per-series on scatter/line - Threshold lines — horizontal/vertical reference lines on scatter/line charts
- Custom ticks & formatters —
custom_xticks,custom_yticks,tick_formatterfor full axis control - Theme presets — 7 built-in themes via
apply_theme() - Multi-figure layout —
Figureclass to compose multiple charts - Configuration system —
set_default()/reset_defaults()for global styling - CLI tool — pipe data from stdin into charts via
termtplotlibcommand - ANSI colors — 8 named colors for all chart elements
- Grid lines — optional
+,-,|grid overlay - Legends — auto-generated per-series legends
- Axis limits — custom
xlim/ylimfor zooming - File output — save to
.txtfiles with ANSI codes automatically stripped - Terminal auto-detect — fits to terminal width by default
- Multi-series — any number of series on scatter, line, area
- Type hints — full PEP 484 type annotations