{"id":7506,"library":"plotille","title":"Plotille","description":"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.","status":"active","version":"6.0.5","language":"python","source_language":"en","source_url":"https://github.com/tammoippen/plotille","tags":["terminal","plotting","braille","data visualization","charts","CLI","ASCII art","histogram","scatter","heatmap"],"install":[{"cmd":"pip install plotille","lang":"bash","label":"Install latest version"}],"dependencies":[],"imports":[{"wrong":"import plotille","symbol":"plot","correct":"from plotille import plot"},{"wrong":"import plotille","symbol":"scatter","correct":"from plotille import scatter"},{"wrong":"import plotille","symbol":"hist","correct":"from plotille import hist"}],"quickstart":{"code":"import plotille\nimport numpy as np\n\nX = np.linspace(0, 2*np.pi, 100)\nY = np.sin(X)\n\nprint(plotille.plot(X, Y, width=70, height=20,\n                     X_label='Angle', Y_label='Sine Value',\n                     linesep='\\n'))\n\n# Example with Figure class\nfig = plotille.Figure()\nfig.width = 70\nfig.height = 20\nfig.x_label = 'Angle'\nfig.y_label = 'Cosine Value'\nfig.plot(X, np.cos(X), label='cos(x)', lc='blue')\nprint(fig.show())\n","lang":"python","description":"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."},"warnings":[{"fix":"Upgrade to Python 3.10+ or downgrade plotille to a version <= 4.x.","message":"Python 2.7 support was dropped in Plotille v5.0.0. Projects still using Python 2.7 must use Plotille v4.x or earlier.","severity":"breaking","affected_versions":">=5.0.0"},{"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`.","message":"The 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.","severity":"breaking","affected_versions":">=4.0.0"},{"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.","message":"Plotille'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.","severity":"gotcha","affected_versions":"All versions"},{"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.","message":"Customizing 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.","severity":"gotcha","affected_versions":"All versions"}],"env_vars":null,"search_vec":"'6.0.5':31 'activ':34 'allow':8 'art':60 'ascii':59 'base':46 'braill':24,54 'chart':57 'cli':58 'creat':11 'current':27 'data':47,55 'depend':51 'direct':18 'dot':25 'extern':50 'focus':42 'frequent':37 'heatmap':17,63 'histogram':15,61 'librari':6 'maintain':35 'major':40 'minor':38 'plot':12,14,53 'plotill':1,2 'python':5 'releas':41 'scatter':13,62 'stand':28 'termin':21,45,52 'terminal-bas':44 'unicod':23 'use':22 'user':9 'version':30 'visual':48,56 'without':49","created_at":"2026-04-16T14:01:14.273416+00:00","updated_at":"2026-04-16T14:01:14.273416+00:00","problems":null,"ecosystem":"pypi","meta_description":null,"install_score":null,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"6.0.5","cli_name":"","cli_version":null,"type":"library","homepage":null,"github":"https://github.com/tammoippen/plotille","docs":null,"changelog":null,"pypi":"https://pypi.org/project/plotille/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["data"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-30","last_verified":"2026-06-30","next_check":"2026-07-30","install_tag":null}}