NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI
PyPI, #3082 most downloaded on PyPI
plotext plots directly on terminal
Latest stable
6.1.0
Last release 2 months ago
07 Sep 2026
Ships unpredictably
gaps range from 2 weeks to 1.9 years
Some releases are documented
notes for 7 of 18 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
19 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
A maintenance release, mainly from three reports by henryiii.
A maintenance release, mainly from three reports by henryiii.
Windows: two pieces of C++ that strict compilers refuse are gone, arrays taking their size while the program runs, and the words and, or and not in place of their symbols. They stopped conda-forge from building plotext (236).
macOS: the plot came out empty when the machine's alphabet setting was missing: plotext now turns it into utf-8 bytes itself, on every machine (237).
Large numbers: plots of large values stopped with an error about NaN. Every position is now held with twice the precision (238). The same loss of precision was naming the wrong day on a date axis, which is fixed with it.
Labels: large numbers on the ticks now reach the exponential form, and all the labels of a ruler share one form and one number of decimals.
Printing: show() now flushes python's output before drawing, and the plot's own after, so a print before the plot comes out before it, and a print after comes out after.
The whole list is in the change log, and the credits page now says where AI helped.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Fixed
conda-forge could not build plotext on Windows. Three arrays took their size while the program ran, which is not proper C++, and the words and, or and not are refused by Microsoft's compiler. Both are gone, as reported in Issue 236.
On macOS the plot came out empty when the machine's alphabet setting was missing. |plotext| now writes it as utf-8 bytes itself, on every machine, as reported in Issue 237.
Plots of large numbers stopped with an error about NaN. Every position is now held with twice the precision, as reported in Issue 238.
A date axis showed the wrong day, a date being held as a number large enough for the lost precision to push a tick past midnight:
fig.draw(fig.signal(["01/01/2024", "10/01/2024"], [1, 2])) # its last label read 09/01/2024
Changed
Large numbers on the tick labels take the exponential form, which only small ones reached before.
The labels of one axis could mix the two forms, one plain and the next exponential, and the exponential ones could each show a different number of decimals. They now all share one form and one number of decimals.
figure.show() flushes what python still holds before drawing, and its own output after, so the plot and your own prints come out in the order you wrote them.
Values too close for the machine to tell apart are drawn on one spot, with a warning, instead of stopping the plot.
The first public build of plotext 6 , a rewrite of the package around one master figure and a new drawing kernel written in C++.
The first public build of plotext 6, a rewrite of the package around one master figure and a new drawing kernel written in C++.
Install it with:
pip install --pre plotextPlain pip install plotext keeps giving 5.3.2, this being a beta.
Version 5 code will not run unchanged: plots are now methods of plotext.figure, drawn through figure.draw(). The change log names every replacement.
Reports of anything broken, on any system, are very welcome.
This s a complete rewrite of version 5.
To install it, as explained here, use:
pip install plotext --upgrade
Main changes
plotext.figure is the plot, holding the tools necessary to build it, from the drawings to the way it looks and rendered; version 5 offered the same as separate functions of the package. When a grid of subplots is present,
plotext.subplot() gives the subplot figure, holding the same tools.plotext.marker, holding the symbol drawn at each point together with its coloring, in place of the marker parameter of version 5: it accepts a symbol name, a text of several characters, a
colorize string or a whole matrix.plotext.figure.draw(). See the signal page.plotext.doc.bar(), or through the interactive menu plotext.doc(), inside the terminal.The change log lists every renamed, removed and changed method, section by section.
Links
Thank you to everyone who reported an issue, asked a question or sent a pull request over time.
A major rewrite, compared here against version 5.3.2, the latest published one. In version 5 a plot was made by calling functions of the package itself, as plotext.scatter(); in version 6 they are methods of one master figure, plotext.figure, and the rendering is done by a new kernel written in C++.
New
The rendering kernel is written in C++, in plotext/_kernel/cpp/, reached from Python through the clink bindings; it is compiled during the installation, and the package warns, without failing, when no compiler is found.
plotext.pixel bundles a foreground color, a background color and a style into one object, accepted wherever a color was given before.
plotext.matrix is a grid of colored characters, sliceable in two dimensions, stackable, saveable and convertible to a web page; it is what figure.build() gives back.
plotext.marker builds a symbol with its own coloring, and accepts a matrix or a colorize object, so that a marker may cover several cells.
plotext.line() builds a line character marker, merging with the others at their crossings.
The whole tree is mapped in structure.txt, one line per file, each taken from the opening comment of the file itself.
Changed
plotext.colorize is now a class, not a function: it holds a string with its coloring, prints with colorize.print(), stacks with + and /, and is sliceable. Its fullground parameter is gone, the coloring living in the pixel.
The package is reorganized: _primitives/ for pixel, colorize, matrix, marker and box, _signal/ for the signal and its points, _plotter/ for the figure, its drawing methods, its frame and its legend, _kernel/ for the public interface and the bridge to C++, _correct/ for the parameter validation, _methods/ for the standalone tools, _settings/ for the defaults and the themes, _constants/ for the accepted names, _doc/ for the docstrings, _demos/ for the reference tables, _data/ for the sample files, _tests/ for the test suite, _cli/ for the command line tool, and prettydoc/ for the docstring builder and its interactive menu.
Markers
sd is renamed full and lightning is renamed zigzag; gclef and note are replaced by eighth, beamed, flat and sharp.
The ten digit markers, from zero to nine, and osiris are removed.
Twenty two are added: brick, sun, cloud, umbrella, emptystar, square, emptysquare, circle, emptycircle, diamond, emptydiamond, up, down, left, right, arrowup, arrowdown, arrowleft, arrowright, infinity, check and xmark.
A marker may also be a plain string of several characters, a matrix or a colorize object, stamped whole at each point, or a list of any of these, one per point.
Themes
Six are kept: default, dark, dreamland, matrix, retro and windows.
Ten are removed: clear, elegant, girly, grandpa, mature, pro, sahara, salad, scream and serious.
Six are added: colorless, dusk, garden, sand, simple and wine.
Colors and styles
yellow is accepted, as another name for orange+; the gold of the version 5 color sequence, which was never a valid color, is gone.
The eight style codes are unchanged, and several of them now combine in one string.
Defaults
The number of numerical ticks is 7 on the x axis and 5 on the y one; version 5 had 5 and 7.
The rulers are written in blue+ instead of black.
The legend appears on its own when something is labelled, as described above.
Renamed
scatter() and plot() become one figure.signal() method, whose result is passed to figure.draw(); the connecting lines are set on the signal itself, with signal.lines().
bar(), multiple_bar() and stacked_bar() become one figure.bar() method: a list of height sequences groups the bars, and stacked = True stacks them.
A bar of value zero draws nothing, where version 5 painted its base row; in a stacked bar that row covered the group below it, as reported in Issue 187.
event_plot() becomes figure.event(), matrix_plot() becomes figure.heatmap(), image_plot() becomes figure.image(), and confusion_matrix() becomes figure.cmatrix().
Removed
simple_bar(), simple_multiple_bar() and simple_stacked_bar(): the same frame-less look is now a recipe of the regular bar plot, described in the simple bar style section.
indicator(): it is now built from figure.text() and a couple of settings, as shown in the indicator section.
The heatmap() of version 5, which took a pandas dataframe, printed it as a side effect and carried no documentation; the new figure.heatmap() takes a two dimensional sequence of numbers, or of (r, g, b) triples.
Changed
figure.candlestick() takes one dictionary, with keys date, open, close, high and low, instead of the two positional arguments of version 5, and gains the style parameter, candle or ohlc, with its tick length, as asked in Issue 149.
figure.box() is complete: it was added in version 5.3, as asked in Issue 169, and marked there as needing further development.
figure.error() takes its errors as leading arguments, (x, y, yerr, xerr), instead of the xerr and yerr named parameters.
figure.bar() accepts a list of markers, one per bar, so each bar can carry its own color, as figure.signal() already accepts one per point; a shorter list repeats. Version 5 painted every bar of a call the same, as asked in Issue 204.
Its labeled parameter takes a list beside True, writing your own text in each bar instead of its height, each entry a string, a colorize or a matrix; grouped and stacked bars take one such list per series, as the heights are given.
Every plotting method returns a signal and draws nothing by itself: figure.draw() puts it on the plot. figure.line() and figure.event() reach the plot on their own instead, since they draw across the whole canvas rather than at data points.
New
The signal is the object every plotting method returns, configured before being drawn: signal.lines() and signal.line() for the connecting lines, signal.fillx(), signal.filly() and signal.fill() for the fills, signal.label() for the legend entry.
signal.density() chooses how densely the connecting and filling lines are drawn, simple or full, on the lines, the fills or both.
Changed
The fillx and filly parameters of version 5 accepted True, a number or the word internal; signal.fillx() and signal.filly() now take a boolean alone, and a varying fill level comes from signal.fill(), given another signal.
Renamed
xlim(), ylim(), xscale(), yscale(), xticks(), yticks(), xfrequency() and yfrequency() become methods of the ruler returned by figure.ruler(): ruler().lim(), ruler().scale(), ruler().ticks() and ruler().frequency().
xreverse() and yreverse() become ruler().direction(), taking 1 or -1.
grid() becomes ruler().grid(), so that each axis carries its own lines, with their style and colors.
frame(), xaxes() and yaxes() become one figure.axes() method, acting on all four sides by default.
New
ruler().alignment() sets where the axis limits sit inside their cells, and where each tick label sits with respect to its position.
ruler().pixel() colors the tick labels and the strip they sit in; ruler().clear() resets the selected rulers alone.
Changed
One call reaches several axes at once: the axis and side parameters accept a list, or the word both, so figure.ruler("both", "both") addresses all four rulers.
Renamed
xlabel() and ylabel() become one figure.label() method, taking the axis and side.
Changed
The legend appears on its own as soon as a signal, or a line, carries a label, and lists only what is labelled; version 5 listed every drawn signal, naming the unlabelled ones signal[n]. figure.legend() is now needed only to place it, color it, draw its box in another line style, or hide it with active = False.
figure.title() and figure.label() accept a colorize or a matrix object beside a plain string, so that the animated text of plotext.effect() can be used as a title.
The signal label() accepts them too, so one legend entry can carry more than one color; the colors are no longer counted as characters, which in version 5 widened the legend box and pushed a centered label off center, as reported in Issue 144.
Renamed
The color, style and background parameters, scattered across the version 5 methods, become one pixel parameter, taking a pixel object, a bare color, or a (foreground, background, style) tuple.
canvas_color() becomes figure.canvas(), taking a background color alone, since the canvas holds no characters of its own.
That color may be default, which leaves the canvas unpainted, so a plot drawn inside another program keeps whatever is behind it, as asked in Issue 230.
axes_color(), ticks_color() and ticks_style() become the pixel of each element: figure.axes(), ruler().pixel() and figure.legend().
New
plotext.add_theme() registers a custom theme, from its canvas background, its text pixel, its color sequence and its grid pixel, ready to be applied like a built-in one.
plotext.line_styles() previews the five line styles.
Changed
figure.theme() colors the grid lines too, which stayed blue under every version 5 theme.
The default theme is literally the out of the box look, so that applying it leaves a fresh figure untouched.
Several styles combine in one string, as "bold italic".
Renamed
vertical_line() and horizontal_line() become one figure.line() method, taking the position and the orientation, and gaining a style parameter, so the line is no longer always ─, as asked in Issue 145.
New
figure.segment() draws a straight line between two points.
figure.rectangle() takes a label, written centered inside it, with colors picked automatically; figure.polygon() takes up, placing a vertex or a flat side on top.
Changed
figure.text() loses its color, background and style parameters: a colorize label carries its own colors.
The line styles are named default, double, heavy, dotted and rounded, the last one available on the axes alone.
Renamed
The nine date functions of version 5, date_form(), set_time0(), today_datetime(), today_string(), datetime_to_string(), datetimes_to_strings(), string_to_datetime(), string_to_time() and strings_to_time(), become the six methods of the date selection returned by figure.date(): date().activate(), date().convert(), date().today(), date().origin(), date().active() and date().clear().
Changed
Date support belongs to one axis, turned on by date().activate(), which also takes the date form and the time origin; that axis then accepts strings, timestamps and datetime objects alike, with no separate date plotting method.
A date axis is written in a zone of its own, set by the zone parameter of date().activate() as the hours from UTC, where version 5 always wrote UTC, as reported in Issue 193.
The colors of a candle, green when the price rises and red when it falls, are named in the defaults, candlestick_up_color and candlestick_down_color, so a theme of your own can change them once for every plot.
Renamed
play_gif() becomes plotext.gif() and play_video() becomes plotext.video().
Removed
play_youtube() and get_youtube(): a YouTube address given to plotext.video() plays through yt-dlp directly.
New
plotext.image() paints an image into a matrix, printed as it is, roughly five to ten times faster than figure.image().
The media methods take gray, width, height and ratio, and the animated ones loop and seconds, stopping the playback after a given time.
Changed
Any path may be a url: the file is downloaded once, into a plotext folder inside the system temporary one, and reused on later calls.
A missing optional package now prints a clear message naming the extra to install, instead of failing on the first use.
figure.image() shrinks the picture to the size of the whole figure rather than to the terminal size, so a picture drawn inside a subplot taller than the terminal fills it instead of coming out with blank rows between its lines.
Removed
main() and active(): a subplot is reached by figure.subplot() and used directly, while figure.master(), figure.parent(), figure.position(), figure.size() and figure.log() navigate and inspect the tree.
take_min(): the same choice is now the policy parameter of figure.plot_size(), minimum or maximum.
Renamed
limit_size() becomes terminal.limit().
Changed
figure.plot_size() gains direction, deciding which subplot absorbs the space left over, and policy, deciding how disagreeing subplots are harmonized.
Renamed
clear_figure() becomes figure.clear(), clear_data() becomes clear.data(), clear_color() becomes clear.pixels() and clear_terminal() becomes terminal.clean().
New
clear.settings(), clear.styles(), clear.size() and clear.subplots() reset one aspect of the plot each, leaving the rest untouched.
Changed
Clearing the figure no longer resets the terminal settings: the prompt height and the size limits survive a figure.clear(), so a loop that clears and redraws keeps them, and only terminal.clear() puts them back to their defaults.
Renamed
save_fig() becomes matrix.save(), called on the matrix that figure.build() gives back, as in figure.build().save("plot.html"); the format follows the extension, html, ansi or plain text.
interactive() becomes figure.interactive().
time() becomes figure.time(), printing the duration of each rendering step, subplots included.
Changed
figure.build() gives back a matrix instead of a string, so that the plot can be sliced, stacked, saved or turned into a web page.
A plot saved as html is a whole web page, naming the character set and a monospaced font, so a browser draws it as the terminal does; version 5 wrote the colored block alone, which a browser read with a guessed character set and a proportional font, as reported in Issue 215. matrix.html() still gives that block alone, to sit inside a page of your own.
plotext.sleep() returns nothing, where version 5 gave back the seconds slept.
Renamed
parent_folder(), join_paths(), save_text(), read_data(), write_data(), download() and delete_file() become the methods of the file toolkit: file.parent(), file.join(), file.write(), file.csv(), file.string(), file.download() and file.delete(), plus file.read() and file.exists().
With file.delete(), only files inside the folder the program runs in can be removed; anything outside is refused with a note, unless safe = False is passed. Version 5 removed whatever path it was handed, as asked in Issue 234.
terminal_size(), terminal_width() and terminal_height() become terminal.size(), giving both dimensions.
from_matplotlib() becomes plotext.matplotlib(), turning a matplotlib figure into the plotext one.
Removed
transpose() and script_folder(); the folder of the running script is given by file.parent() called with no argument.
Every short alias: version 6 defines none at all, so clf, cld, clc, clt, cmatrix, datetimes_to_string, eventplot, hline, vline, limitsize, plotsize, savefig, takemin, ts, tw and th are gone, each method having one name only.
New
plotext.noise() generates gaussian test data, and plotext.sample() gives the path of a file shipped with the package: pizzas, stock, puppy and shaq.
terminal.is_pressed() tells whether a key was typed, without pausing the program, and terminal.prompt() sets the rows left free below the plot, two by default, so a plot no longer runs under the prompt, as asked in Issue 181.
plotext.effect() colors a text with a moving effect, shimmer, pulse, rainbow or gradient, animated by its step parameter.
Changed
plotext.sin() gains an offset parameter; the file methods take a log parameter, printing a short report of the operation; plotext.uncolorize() accepts a colorize or a matrix object beside a string.
New
The prettydoc module builds the colored docstrings, and the whole documentation of the package is written with it.
plotext.doc holds every docstring: plotext.doc.bar() prints one, and plotext.doc() opens the interactive menu, three scrollable columns holding the sections, the methods and the docstring of the picked one.
Every documented method gains a doc() method of its own, printing its colored docstring, while its __doc__ keeps the plain one.
Changed
plotext.test() no longer draws a sample plot: it runs the test suite of the package, over the primitives, the built plots, the dates and every bug already fixed, plus a few whole plots frozen by their hash; plotext.prettydoc.test() runs the one of prettydoc.
Changed
The command line tool is rewritten: the version 5 subcommands, scatter, plot, plotter, bar, hist, image, gif, video and youtube, each with its own flags, are replaced by a chain of methods mirroring the Python ones, as plotext --figure --sin --signal --lines --draw --show.
New
A method is written as -- followed by its name; the words after it are its arguments, and name=value sets a named parameter.
--figure and --terminal select the object the following methods act on; --draw puts the waiting signal on the plot, and --show renders the figure.
@path:<path> reads a csv file, on disk or at a url, with the endings :2, :1,3 and :dict; @sample:<name> reads a bundled sample; - reads the piped input.
The test data functions feed the next plotting method: --sin --signal draws a sinusoid, and --sin periods=1 --sin periods=2 --signal hands the two waves to the same call.
--doc opens the documentation menu, --method --doc prints one docstring, and --methods lists every reachable method.
plotext -c "<code>" runs Python code directly, for the cases the chain cannot express.
Removed
TAB completion of the command names, which version 5 offered through the shtab package: the tool no longer reads a fixed list of subcommands, so the completions have to be written again for the new chain of methods.
The first public build of plotext 6, a rewrite of the package around one master figure and a new drawing kernel written in C++.
The first public build of plotext 6, a rewrite of the package around one master figure and a new drawing kernel written in C++.
Install it with:
pip install --pre plotext
Plain pip install plotext keeps giving 5.3.2, this being a beta.
Version 5 code will not run unchanged: plots are now methods of plotext.figure, drawn through figure.draw(). The change log names every replacement.
Reports of anything broken, on any system, are very welcome.
Version 5.3.2 init .py update
Version 5.3.2 init.py update
solved issue Issue 153 allowing bar plots to handle 0 data sets
xside and yside parameters to candlestick() function, solving Issue 152xlim() and ylim() methods, solving Issue 138marker parameter to the from_matplotlib() method, solving Issue 134from_matplotlib() method compatible with matplotlib 3.6, solving Issue 133Nothing published for this version
Nothing published for this version
Nothing published for this version
Added norm parameter in ~plotext._plotter.plot.plot_class.hist function as requested in Issue 76 _ and incorporated changes from Pull 79 _.
Nothing published for this version
Entire code re-written for better performance.
Improvements
Entire code re-written for better performance.
Improved plotting speed.
Changed 2 x 2 marker to hd (high resolution) instead of small.
Added higher resolution 3 x 2 Unicode mosaic markers (not available in Windows), called fhd (full high resolution).
Added new color codes, including 256 color codes and full RGB colors.
Introduced multiple and stacked bar charts.
Added date-time scatter and plot functions.
Added date-time class for better handling of date-time objects.
Added matrix_plot() and image_plot() functions.
Plots can now be saved in color using .html extension.
Added file class for better file and path handling.
Data can now be plotted on the upper x axis.
Added unittest file named test.py.
Introduced xside and yside parameters for many related functions.
Added span() function to span columns and rows in the matrix of subplots.
Added more clear functions.
Added limit_size() function to control plot dimensions relative to terminal size, inspired by Issue 33.
Added optional legend extra characters for axis identification.
Added time() function to check plotting computational time.
Renamed xfreq() to xfrequency() and yfreq() to yfrequency().
Added doc class for easy access to function docstrings.
Renamed get_canvas() to build().
Reinstated frame() function.
Bug Fixes
Solved bar chart log scale issue on both axes.
Solved bar chart zero value issue.
Nothing published for this version
Nothing published for this version
Nothing published for this version
Nothing published for this version
Plot now shows actual data ticks using a simpler algorithm.
Plot now shows actual data ticks using a simpler algorithm.
Changed ticks_number to ticks.
Updated set functions like set_title() to title().
Added optional grid and fill parameter.
Changed axes_color() to facecolor() to align with matplotlib.
Improved legend positioning and introduced new color codes.
Code restructured and revised.
Nothing published for this version
Nothing published for this version
Nothing published for this version
One column per quarter.