{"id":19429794,"url":"https://github.com/soraxas/terminal-plot","last_synced_at":"2026-03-08T22:33:21.178Z","repository":{"id":48814180,"uuid":"384702026","full_name":"soraxas/terminal-plot","owner":"soraxas","description":"A terminal plotter for tensorboard and csv","archived":false,"fork":false,"pushed_at":"2024-07-20T14:56:59.000Z","size":372,"stargazers_count":10,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-02-22T19:44:01.825Z","etag":null,"topics":["tensorboard","terminal","termplot","tui"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/terminal-plot/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/soraxas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2021-07-10T13:16:35.000Z","updated_at":"2025-02-21T08:36:54.000Z","dependencies_parsed_at":"2022-09-26T20:12:04.111Z","dependency_job_id":"fb2ed3b1-af56-40c7-ad4a-8c4a1d173c09","html_url":"https://github.com/soraxas/terminal-plot","commit_stats":null,"previous_names":["soraxas/tensorboard-termplot","soraxas/termplot"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/soraxas/terminal-plot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soraxas%2Fterminal-plot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soraxas%2Fterminal-plot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soraxas%2Fterminal-plot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soraxas%2Fterminal-plot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/soraxas","download_url":"https://codeload.github.com/soraxas/terminal-plot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/soraxas%2Fterminal-plot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30275569,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-08T20:45:49.896Z","status":"ssl_error","status_checked_at":"2026-03-08T20:45:49.525Z","response_time":56,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["tensorboard","terminal","termplot","tui"],"created_at":"2024-11-10T14:21:24.002Z","updated_at":"2026-03-08T22:33:21.160Z","avatar_url":"https://github.com/soraxas.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Terminal-plot for Tensorboard and CSV\n\n[![pypi](https://img.shields.io/pypi/v/terminal-plot)](https://pypi.org/project/terminal-plot/)\n[![python-version](https://img.shields.io/pypi/pyversions/terminal-plot)](https://pypi.org/project/terminal-plot/)\n[![Master Update](https://img.shields.io/github/last-commit/soraxas/terminal-plot/master.svg)](https://github.com/soraxas/terminal-plot/commits/master)\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![License](https://img.shields.io/github/license/soraxas/terminal-plot.svg)](https://github.com/soraxas/terminal-plot/blob/master/LICENSE)\n\nA plotter for multiple different data source (e.g. tensorboard, csv), directly within your terminal. This is useful when you are training your neural network on a remote server, and you just want to quickly peek at the training curve without launching a tensorboard instance and mess with forwarding ports.\n\n## Install\n\nYou can install the package published in PyPI with\n```sh\n$ pip install terminal-plot\n# or install with matplotlib backend dependency\n$ pip install terminal-plot[matplotlib-backend]\n\n# or install with an isolated environment\n# $ pipx install terminal-plot[matplotlib-backend]\n```\n\n## Autocomplete\n\nYou can use [`argcomplete`](https://kislyuk.github.io/argcomplete) to enable autocomplete for this script. For example, you can use the following for the fish shell:\n```sh\nregister-python-argcomplete --shell fish termplot \u003e ~/.config/fish/completions/termplot.fish\n```\n\n## Usage\n\n```sh\n$ termplot FOLDER/FILE\n```\nFor example,\n```sh\n$ termplot ~/my_amazing_nn/runs\n```\nwhere `runs` is the folder that tensorboard had created.\n\nOr, using csv as a data source:\n```sh\n$ termplot ~/my_stats/output.csv --csv\n# use the -x flag to select which stat will be used as x-axis\n# $ termplot ~/my_stats/output.csv --csv -x time\n```\n\nOr, using matplotlib as a plotting backend:\n```sh\n$ termplot ~/my_stats/output.csv --csv -m\n```\n\n# Example\n\nRunning the executable on a tensorboard output folder:\n\n![](https://raw.githubusercontent.com/soraxas/termplot/master/docs/images/example-output.png)\n\nOr with the consolidated flag `-c/--consolidate` to combine multiple stats with a common prefix (most stats in the bottom figure had empty values):\n\n![](https://raw.githubusercontent.com/soraxas/termplot/master/docs/images/example-output-consolidated.png)\n\n\n# Help\n\n```\n$ termplot --help\nusage: termplot [-h] [--version] [--debug]\n                [--backend {plotext,matplotlib,matplotlib-terminal}]\n                [--data-source {tensorboard,csv}] [-m] [--csv] [--latest]\n                [--plotsize WIDTH,HEIGHT] [-c] [--as-scatter]\n                [--canvas-color CANVAS_COLOR] [--axes-color AXES_COLOR]\n                [--ticks-color TICKS_COLOR] [--grid] [--colorless] [-d]\n                [--no-iter-color] [--force-label] [-f] [-n secs]\n                [-w keyword [keyword ...]] [-b keyword [keyword ...]]\n                [-x XAXIS_TYPE] [--xlog [row,col ...]] [--ylog [row,col ...]]\n                [--xsymlog [row,col ...]] [--ysymlog [row,col ...]]\n                [--xlim row,col=min,max [row,col=min,max ...]]\n                [--ylim row,col=min,max [row,col=min,max ...]]\n                [--as-raw-bytes] [-s [0-1]] [--smooth-poly-order poly-order]\n                [--terminal-width TERMINAL_WIDTH]\n                [--terminal-height TERMINAL_HEIGHT]\n                FOLDER\n\npositional arguments:\n  FOLDER                Source folder or file\n\noptional arguments:\n  -h, --help            show this help message and exit\n  --version             show program's version number and exit\n  --debug\n  --backend {plotext,matplotlib,matplotlib-terminal}\n                        Set the plotting backend\n  --data-source {tensorboard,csv}\n                        Set the plotting data source\n  -m, --matplotlib      Alias of --backend matplotlib\n  --csv                 Alias of --data-source csv\n  --latest, -l          Monitor the given folder, and always plot the latest\n                        modified. The given argument must be a folder if this\n                        flag is set.\n  --plotsize WIDTH,HEIGHT\n                        Manually set the size of each subplot, e.g., 50,20.\n  -c, --consolidate     Consolidate based on prefix. If -cc is given,\n                        everything will consolidated regardless of prefix\n  --as-scatter          Plot as scatter (instead of line plot)\n  --canvas-color CANVAS_COLOR\n                        set the color of the plot canvas (the area where the\n                        data is plotted)\n  --axes-color AXES_COLOR\n                        sets the background color of all the labels\n                        surrounding the actual plot, i.e. the axes, axes\n                        labels and ticks, title and legend, if present\n  --ticks-color TICKS_COLOR\n                        sets the (full-ground) color of the axes ticks and of\n                        the grid lines.\n  --grid                Show grid.\n  --colorless           Remove color.\n  -d, --dark-theme      A collection of flags. If set, it is equivalent to\n                        setting canvas-color and axes-color to black, and\n                        setting ticks-color to red. Can be overwritten\n                        individually.\n  --no-iter-color       Stop iterating through different colors per plot.\n  --force-label         Force showing label even for plot with one series.\n  -f, --follow          Run in a loop to update display periodic.\n  -n secs, --interval secs\n                        seconds to wait between updates\n  -w keyword [keyword ...], --whitelist keyword [keyword ...]\n                        Keyword that the stat must contain for it to be\n                        plotted, case sensitive.\n  -b keyword [keyword ...], --blacklist keyword [keyword ...]\n                        Keyword that the stat must not contain for it to be\n                        plotted, case sensitive.\n  -x XAXIS_TYPE, --xaxis-type XAXIS_TYPE\n                        Set value type to be used for x-axis. Tensorboard only\n                        supports 'step' or 'time' as x-axis.\n  --xlog [row,col ...]  Set the list of subplots to use log scale in x-axis\n  --ylog [row,col ...]  Set the list of subplots to use log scale in y-axis\n  --xsymlog [row,col ...]\n                        Set the list of subplots to use symlog scale in x-axis\n  --ysymlog [row,col ...]\n                        Set the list of subplots to use symlog scale in y-axis\n  --xlim row,col=min,max [row,col=min,max ...]\n                        Set the list of xlim for the specified subplot.\n  --ylim row,col=min,max [row,col=min,max ...]\n                        Set the list of ylim for the specified subplot.\n  --as-raw-bytes        Writes the raw image bytes to stdout.\n  -s [0-1], --smooth [0-1]\n                        A value from 0 to 1 as a smoothing factor.\n  --smooth-poly-order poly-order\n                        Polynomial order for the savgol smoothing algorithm.\n  --terminal-width TERMINAL_WIDTH\n                        Manually set the terminal width.\n  --terminal-height TERMINAL_HEIGHT\n                        Manually set the terminal height.\n\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoraxas%2Fterminal-plot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsoraxas%2Fterminal-plot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsoraxas%2Fterminal-plot/lists"}