# mkaz/termgraph **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mkaz-termgraph).** 3,259 stars · 168 forks · Python · mit ## Links - GitHub: https://github.com/mkaz/termgraph - awesome-repositories: https://awesome-repositories.com/repository/mkaz-termgraph.md ## Description Termgraph is a terminal data visualization library and command line analytics tool used to render bar charts, histograms, and heatmaps directly in the shell. It utilizes ANSI escape sequences and Unicode characters to generate colorful visual data representations within a text-based environment. The tool provides specialized capabilities for transforming raw datasets into horizontal or vertical bar graphs, column charts, and stacked charts. It also functions as a heatmap generator, mapping time-series data to a calendar layout to visualize temporal patterns over a year. The library supports multi-variable data parsing and applies color styling to differentiate between data variables. It employs linear scale normalization and coordinate mapping to translate dataset values into terminal columns and rows. ## Tags ### Data & Databases - [Command Line Analytics Tools](https://awesome-repositories.com/f/data-databases/command-line-analytics-tools.md) — Transforms raw datasets into visual bar and column charts for quick analysis without leaving the terminal. - [Bar Charts](https://awesome-repositories.com/f/data-databases/data-analysis-visualization/analytical-platforms-engines/data-analysis-tools/bar-charts.md) — Renders horizontal and vertical bar graphs from multi-variable datasets, including stacked formats and custom tick marks. ([source](https://cdn.jsdelivr.net/gh/mkaz/termgraph@main/README.md)) - [Command Line Analytics](https://awesome-repositories.com/f/data-databases/command-line-analytics.md) — Transforms raw datasets into visual bar and column charts for comparative analysis within a terminal environment. - [ANSI Renderers](https://awesome-repositories.com/f/data-databases/data-analysis-visualization/analytical-platforms-engines/data-analysis-tools/bar-charts/ansi-renderers.md) — Provides a utility for generating terminal-based bar charts using ANSI escape sequences for colorful data representations. - [Data Visualization Charts](https://awesome-repositories.com/f/data-databases/data-visualization-charts.md) — Generates a variety of graphical representations, including bar charts and histograms, directly in the terminal. ([source](https://github.com/mkaz/termgraph/tree/main/docs/)) - [Time-Series Visualizers](https://awesome-repositories.com/f/data-databases/data-visualization-charts/time-series-visualizers.md) — Renders time-indexed data using calendar-aware grid layouts to visualize temporal patterns over a year. - [Data Parsing](https://awesome-repositories.com/f/data-databases/data-engineering-infrastructure/data-extraction-ingestion/data-parsing.md) — Analyzes and translates raw input data streams into structured formats for stacked or grouped visual representation. - [Histogram Plotters](https://awesome-repositories.com/f/data-databases/data-management/unique-identifier-generators/uniqueness-enforcement/distribution-histograms/histogram-plotters.md) — Visualizes data distributions by grouping numerical values into bins and rendering them as terminal-based histogram bars. ([source](https://cdn.jsdelivr.net/gh/mkaz/termgraph@main/README.md)) ### Part of an Awesome List - [Heatmap Visualization](https://awesome-repositories.com/f/awesome-lists/data/heatmap-visualization.md) — Visualizes temporal data patterns using calendar-based heatmap grids to identify trends over days or months. - [Command Line Utilities](https://awesome-repositories.com/f/awesome-lists/devtools/command-line-utilities.md) — Generates basic graphs in the terminal. ### Operating Systems & Systems Programming - [ANSI Escape Sequence Renderers](https://awesome-repositories.com/f/operating-systems-systems-programming/terminal-command-line-environments/terminal-management/output-rendering-engines/ansi-escape-sequence-renderers.md) — Generates raw ANSI terminal control codes to manipulate text color and formatting for data visualization. ### User Interface & Experience - [Data Visualizations](https://awesome-repositories.com/f/user-interface-experience/ansi-terminal-ui-libraries/data-visualizations.md) — Provides a library for rendering bar charts, histograms, and heatmaps using ANSI and Unicode characters in the shell. - [Activity Heatmaps](https://awesome-repositories.com/f/user-interface-experience/calendars/activity-heatmaps.md) — Maps time-series data to a color-coded heatmap grid based on a calendar layout. ([source](https://cdn.jsdelivr.net/gh/mkaz/termgraph@main/README.md)) - [Character-Based Visual Elements](https://awesome-repositories.com/f/user-interface-experience/character-based-visual-elements.md) — Represents quantitative data values through the repetition of Unicode or ASCII characters to create visual bars. - [Bar Column Renderers](https://awesome-repositories.com/f/user-interface-experience/character-based-visual-elements/coordinate-based-character-rendering/bar-column-renderers.md) — Simulates visual bars using Unicode block characters or custom glyphs for vertical and horizontal scaling. - [Calendar Grid Layouts](https://awesome-repositories.com/f/user-interface-experience/fixed-grid-layouts/calendar-grid-layouts.md) — Arranges time-series data into a fixed matrix reflecting calendar weeks and months to visualize yearly patterns. - [Terminal Data Visualizations](https://awesome-repositories.com/f/user-interface-experience/terminal-data-visualizations.md) — Renders complex data and system states using text-based graphics, bars, and histograms in a terminal. - [Chart Color Theming](https://awesome-repositories.com/f/user-interface-experience/color-themes/chart-color-theming.md) — Applies specific color schemes and ANSI styling to data visualization components to differentiate variables. ([source](https://cdn.jsdelivr.net/gh/mkaz/termgraph@main/README.md)) ### Graphics & Multimedia - [Grid Coordinate Mapping](https://awesome-repositories.com/f/graphics-multimedia/visualization-mapping/visualization-frameworks/coordinate-systems/page-coordinate-mapping/grid-coordinate-mapping.md) — Translates dataset values into a two-dimensional grid coordinate system to determine exact character positions on the shell screen. ### Scientific & Mathematical Computing - [Numerical Range Scaling](https://awesome-repositories.com/f/scientific-mathematical-computing/numerical-range-scaling.md) — Performs proportional transformation of raw input values into a fixed range of terminal columns and rows. ### Software Engineering & Architecture - [Variable Visualizers](https://awesome-repositories.com/f/software-engineering-architecture/stacks/stack-trace-formatters/variable-aware-formatting/variable-visualizers.md) — Transforms raw variable data from complex input structures into formatted visual representations for analysis. ### System Administration & Monitoring - [CLI Reporting Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/cli-reporting-dashboards.md) — Provides capabilities for building text-based reports and visual summaries of system metrics for quick shell viewing.