---
id: textual-plotext
version: "1.0.1"
license: MIT
license_treatment: permissive
maintenance: dormant
---

# textual-plotext — A Textual widget wrapper for the Plotext plotting library

License: permissive · Maintenance: dormant · Downloads: 259.7K/mo

## What it is and what it does

textual-plotext bridges Plotext, a terminal plotting library, into Textual applications by providing a `PlotextPlot` widget. Instead of calling Plotext functions directly, you access them through the widget's `plt` property, which handles rendering within the Textual event loop and automatically manages plot display without needing explicit `show()` calls.

The widget supports most Plotext plotting functions (scatter, line, bar, etc.) and utility functions like `sin()` and `colorize()`, but excludes file I/O, interactive REPL features, and GIF/video playback. It includes custom themes prefixed with `textual-` that use RGB colors for consistent appearance across terminals, and automatically switches between dark and light mode themes when the Textual app changes modes.

Use it for:

- Build terminal dashboards that display live data plots alongside other Textual widgets.
- Create monitoring tools that render real-time metrics as terminal-based charts.
- Embed scatter, line, or bar plots in CLI applications without leaving the terminal UI framework.
- Visualize mathematical functions or test signals directly within a Textual TUI.
- Develop data exploration tools that combine Textual forms and navigation with Plotext visualizations.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Wraps the Plotext plotting library as a Textual widget, allowing terminal-based plots to be embedded and rendered within Textual applications.

Yes, if you are already using Textual and need terminal-based plotting. The package has low install friction, no security vulnerabilities, and a permissive license. However, note that it is dormant (622 days since last release); adopt it for stable use cases but verify compatibility with your Plotext version and monitor for any upstream breaking changes.

## Install

pip install textual-plotext
uv add textual-plotext
poetry add textual-plotext

## Installing textual-plotext

Before you install: Low install friction with only two runtime dependencies (plotext and textual). The package is dormant but has a stable last commit and no known vulnerabilities, making it safe to adopt for existing Textual projects.

License in practice: MIT license is permissive and imposes no significant restrictions on use, modification, or distribution in commercial or private projects.

Quickstart:

from textual.app import App, ComposeResult
from textual_plotext import PlotextPlot

class PlotApp(App):
    def compose(self) -> ComposeResult:
        yield PlotextPlot()
    def on_mount(self) -> None:
        plt = self.query_one(PlotextPlot).plt
        plt.scatter(plt.sin())
        plt.title("Plot")

Requires Textual and Plotext as runtime dependencies; Python 3.8.1 or later.

Verify before relying:

- Whether the dormant status (622 days since last release) indicates ongoing maintenance or abandonment risk.
- Performance characteristics when rendering large datasets or frequent plot updates in Textual apps.
- Compatibility with recent Plotext versions and any breaking changes since the last release.

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: dormant
- Downloads: 259.7K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

terminal plotting widget, textual charting integration, plotext textual wrapper, tui data visualization, terminal-based graphs, plotext widget, textual plot rendering, terminal-ui, data-visualization, textual-widget

[View on SkillFed](https://skillfed.io/packages/textual-plotext) · [View on PyPI](https://pypi.org/project/textual-plotext/)