{"id":13438683,"url":"https://github.com/fdehau/tui-rs","last_synced_at":"2025-10-05T19:30:16.580Z","repository":{"id":37412745,"uuid":"73169350","full_name":"fdehau/tui-rs","owner":"fdehau","description":"Build terminal user interfaces and dashboards using Rust","archived":true,"fork":false,"pushed_at":"2023-08-06T07:35:02.000Z","size":3869,"stargazers_count":10810,"open_issues_count":0,"forks_count":486,"subscribers_count":75,"default_branch":"master","last_synced_at":"2024-05-21T21:44:13.431Z","etag":null,"topics":["dashboard","rust","terminal","tui"],"latest_commit_sha":null,"homepage":"","language":"Rust","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/fdehau.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-11-08T09:19:25.000Z","updated_at":"2024-05-19T22:22:56.000Z","dependencies_parsed_at":"2022-07-12T21:01:15.274Z","dependency_job_id":"ec68340e-448b-46a9-b264-e127ff6f2a3c","html_url":"https://github.com/fdehau/tui-rs","commit_stats":{"total_commits":540,"total_committers":99,"mean_commits":5.454545454545454,"dds":0.4574074074074074,"last_synced_commit":"fafad6c96109610825aad89c4bba5253e01101ed"},"previous_names":[],"tags_count":36,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdehau%2Ftui-rs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdehau%2Ftui-rs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdehau%2Ftui-rs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fdehau%2Ftui-rs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fdehau","download_url":"https://codeload.github.com/fdehau/tui-rs/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":234922686,"owners_count":18907828,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["dashboard","rust","terminal","tui"],"created_at":"2024-07-31T03:01:07.530Z","updated_at":"2025-10-05T19:30:15.267Z","avatar_url":"https://github.com/fdehau.png","language":"Rust","funding_links":[],"categories":["Libraries","Rust","Others","库 Libraries","HarmonyOS","tui","库","Rust 🦀","TUI Frameworks \u0026 Libraries","Table of Contents"],"sub_categories":["Command-line","命令行 Command-line","Windows Manager","命令行"],"readme":"# tui-rs\n\n⚠️ **August 2023: This crate is no longer maintained. See https://github.com/ratatui-org/ratatui for an actively maintained fork.** ⚠️\n\n[![Build Status](https://github.com/fdehau/tui-rs/workflows/CI/badge.svg)](https://github.com/fdehau/tui-rs/actions?query=workflow%3ACI+)\n[![Crate Status](https://img.shields.io/crates/v/tui.svg)](https://crates.io/crates/tui)\n[![Docs Status](https://docs.rs/tui/badge.svg)](https://docs.rs/crate/tui/)\n\n\u003cimg src=\"./assets/demo.gif\" alt=\"Demo cast under Linux Termite with Inconsolata font 12pt\"\u003e\n\n`tui-rs` is a [Rust](https://www.rust-lang.org) library to build rich terminal\nuser interfaces and dashboards. It is heavily inspired by the `Javascript`\nlibrary [blessed-contrib](https://github.com/yaronn/blessed-contrib) and the\n`Go` library [termui](https://github.com/gizak/termui).\n\nThe library supports multiple backends:\n  - [crossterm](https://github.com/crossterm-rs/crossterm) [default]\n  - [termion](https://github.com/ticki/termion)\n\nThe library is based on the principle of immediate rendering with intermediate\nbuffers. This means that at each new frame you should build all widgets that are\nsupposed to be part of the UI. While providing a great flexibility for rich and\ninteractive UI, this may introduce overhead for highly dynamic content. So, the\nimplementation try to minimize the number of ansi escapes sequences generated to\ndraw the updated UI. In practice, given the speed of `Rust` the overhead rather\ncomes from the terminal emulator than the library itself.\n\nMoreover, the library does not provide any input handling nor any event system and\nyou may rely on the previously cited libraries to achieve such features.\n\n**I'm actively looking for help maintaining this crate. See [this issue](https://github.com/fdehau/tui-rs/issues/654)**\n\n### Rust version requirements\n\nSince version 0.17.0, `tui` requires **rustc version 1.56.1 or greater**.\n\n### [Documentation](https://docs.rs/tui)\n\n### Demo\n\nThe demo shown in the gif can be run with all available backends.\n\n```\n# crossterm\ncargo run --example demo --release -- --tick-rate 200\n# termion\ncargo run --example demo --no-default-features --features=termion --release -- --tick-rate 200\n```\n\nwhere `tick-rate` is the UI refresh rate in ms.\n\nThe UI code is in [examples/demo/ui.rs](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/demo/ui.rs) while the\napplication state is in [examples/demo/app.rs](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/demo/app.rs).\n\nIf the user interface contains glyphs that are not displayed correctly by your terminal, you may want to run\nthe demo without those symbols:\n\n```\ncargo run --example demo --release -- --tick-rate 200 --enhanced-graphics false\n```\n\n### Widgets\n\nThe library comes with the following list of widgets:\n\n  * [Block](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/block.rs)\n  * [Gauge](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/gauge.rs)\n  * [Sparkline](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/sparkline.rs)\n  * [Chart](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/chart.rs)\n  * [BarChart](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/barchart.rs)\n  * [List](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/list.rs)\n  * [Table](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/table.rs)\n  * [Paragraph](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/paragraph.rs)\n  * [Canvas (with line, point cloud, map)](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/canvas.rs)\n  * [Tabs](https://github.com/fdehau/tui-rs/blob/v0.19.0/examples/tabs.rs)\n\nClick on each item to see the source of the example. Run the examples with with \ncargo (e.g. to run the gauge example `cargo run --example gauge`), and quit by pressing `q`.\n\nYou can run all examples by running `cargo make run-examples` (require\n`cargo-make` that can be installed with `cargo install cargo-make`).\n\n### Third-party widgets\n\n* [tui-logger](https://github.com/gin66/tui-logger)\n* [tui-textarea](https://github.com/rhysd/tui-textarea): simple yet powerful multi-line text editor widget supporting several key shortcuts, undo/redo, text search, etc.\n* [tui-rs-tree-widgets](https://github.com/EdJoPaTo/tui-rs-tree-widget): widget for tree data structures.\n\n### Apps using tui\n\n* [spotify-tui](https://github.com/Rigellute/spotify-tui)\n* [bandwhich](https://github.com/imsnif/bandwhich)\n* [kmon](https://github.com/orhun/kmon)\n* [gpg-tui](https://github.com/orhun/gpg-tui)\n* [ytop](https://github.com/cjbassi/ytop)\n* [zenith](https://github.com/bvaisvil/zenith)\n* [bottom](https://github.com/ClementTsang/bottom)\n* [oha](https://github.com/hatoo/oha)\n* [gitui](https://github.com/extrawurst/gitui)\n* [rust-sadari-cli](https://github.com/24seconds/rust-sadari-cli)\n* [desed](https://github.com/SoptikHa2/desed)\n* [diskonaut](https://github.com/imsnif/diskonaut)\n* [tickrs](https://github.com/tarkah/tickrs)\n* [rusty-krab-manager](https://github.com/aryakaul/rusty-krab-manager)\n* [termchat](https://github.com/lemunozm/termchat)\n* [taskwarrior-tui](https://github.com/kdheepak/taskwarrior-tui)\n* [gping](https://github.com/orf/gping/)\n* [Vector](https://vector.dev)\n* [KDash](https://github.com/kdash-rs/kdash)\n* [xplr](https://github.com/sayanarijit/xplr)\n* [minesweep](https://github.com/cpcloud/minesweep-rs)\n* [Battleship.rs](https://github.com/deepu105/battleship-rs)\n* [termscp](https://github.com/veeso/termscp)\n* [joshuto](https://github.com/kamiyaa/joshuto)\n* [adsb_deku/radar](https://github.com/wcampbell0x2a/adsb_deku#radar-tui)\n* [hoard](https://github.com/Hyde46/hoard)\n* [tokio-console](https://github.com/tokio-rs/console): a diagnostics and debugging tool for asynchronous Rust programs.\n* [hwatch](https://github.com/blacknon/hwatch): a alternative watch command that records the result of command execution and can display its history and diffs.\n* [ytui-music](https://github.com/sudipghimire533/ytui-music): listen to music from youtube inside your terminal.\n* [mqttui](https://github.com/EdJoPaTo/mqttui): subscribe or publish to a MQTT Topic quickly from the terminal.\n* [meteo-tui](https://github.com/16arpi/meteo-tui): french weather via the command line.\n* [picterm](https://github.com/ksk001100/picterm): preview images in your terminal.\n* [gobang](https://github.com/TaKO8Ki/gobang): a cross-platform TUI database management tool.\n* [oxker](https://github.com/mrjackwills/oxker): a simple tui to view \u0026 control docker containers.\n* [trippy](https://github.com/fujiapple852/trippy): a network diagnostic tool.\n* [cotp](https://github.com/replydev/cotp): a trustworthy, encrypted, command-line TOTP/HOTP authenticator app with import functionality.\n* [hg-tui](https://github.com/kaixinbaba/hg-tui): view [hellogithub.com](https://hellogithub.com/) website on the terminal.\n\n### Alternatives\n\nYou might want to checkout [Cursive](https://github.com/gyscos/Cursive) for an\nalternative solution to build text user interfaces in Rust.\n\n## License\n\n[MIT](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdehau%2Ftui-rs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffdehau%2Ftui-rs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffdehau%2Ftui-rs/lists"}