plotille

library6.0.5pypypi✓ verified 82d ago

Plotille is a Python library that allows users to create plots, scatter plots, histograms, and heatmaps directly in the terminal using Unicode braille dots. It currently stands at version 6.0.5 and is actively maintained with frequent minor and major releases, focusing on terminal-based data visualization without external dependencies.

data

pip install plotille

github ↗package ↗

INSTALL

IMPORT

SIG · PLOTILLE

plotille

datapythonv6.0.5

Install

2.0s avg

Import

58ms

Disk

16MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v6.0.5 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.920 runs

installs and imports cleanly · install 0.0s · import 0.048s · 18.2MB

glibc

py 3.10–3.920 runs

installs and imports cleanly · install 2.0s · import 0.046s · 19MB

16MB installed

● package 16MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

plot

✓ from plotille import plot

✗ import plotille

scatter

✓ from plotille import scatter

✗ import plotille

hist

✓ from plotille import hist

✗ import plotille

This quickstart demonstrates how to create a simple line plot using `plotille.plot` and a more customizable plot using the `plotille.Figure` class. It plots sine and cosine functions in the terminal.

import plotille import numpy as np X = np.linspace(0, 2*np.pi, 100) Y = np.sin(X) print(plotille.plot(X, Y, width=70, height=20, X_label='Angle', Y_label='Sine Value', linesep='\n')) # Example with Figure class fig = plotille.Figure() fig.width = 70 fig.height = 20 fig.x_label = 'Angle' fig.y_label = 'Cosine Value' fig.plot(X, np.cos(X), label='cos(x)', lc='blue') print(fig.show())

Debug

Known issues

breakingPython 2.7 support was dropped in Plotille v5.0.0. Projects still using Python 2.7 must use Plotille v4.x or earlier.

fix

Upgrade to Python 3.10+ or downgrade plotille to a version <= 4.x.

affects: >=5.0.0

breakingThe API for handling colors in `Dots`, `Canvas`, and `Figure` changed significantly in v4.0.0. The `color_mode` argument was renamed to `mode` in many cases, and a `color_kwargs` argument was introduced for finer control over color functions.

fix

Review your color-related code for `Dots`, `Canvas`, and `Figure`. Adapt to using `mode` instead of `color_mode` and pass keyword arguments for color functions via `color_kwargs`.

affects: >=4.0.0

gotchaPlotille's rendering relies on specific terminal properties (monospaced braille characters, ANSI escape codes for colors). Plots may appear misaligned, garbled, or without colors in non-compliant terminal emulators or IDE output panes that don't correctly interpret these features.

fix

Run your applications in a true terminal emulator (e.g., Alacritty, iTerm2, Kitty, Windows Terminal, gnome-terminal) with a font that has good support for Unicode braille characters (e.g., Cascadia Code, Unscii). Avoid running directly in IDE output consoles if alignment issues occur.

affects: All versions

gotchaCustomizing time-based X-axis labels for real-time or complex time series plots can be challenging. The library's internal tick calculation might not always align perfectly with desired datetime formats or intervals.

fix

For fine-grained control over datetime axes, explore `x_ticks_fkt` and `register_label_formatter` as described in the documentation or GitHub issues (e.g., issue #57) to provide custom formatting functions for axis labels.

affects: All versions

Upgrade

Version history

6.0.5latest on PyPI · released Feb 17, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/tammoippen/plotille ↗

packagehttps://pypi.org/project/plotille/ ↗