+0
Daily
4,863
stars
272
forks
35
watchers
271
prs
560
issues
50
releases
README
Cursive
Cursive is a TUI (Text User Interface) library for rust. It uses the [crossterm] backend by default, but other backends are available.
It allows you to build rich user interfaces for terminal applications.
[crossterm]: https://github.com/crossterm-rs/crossterm
Documentation
It is designed to be safe and easy to use:
toml
[dependencies]
cursive = "0.21"
Or to use the latest git version:
toml
[dependencies]
cursive = { git = "https://github.com/gyscos/cursive" }
rust,no_run
use cursive::views::{Dialog, TextView};
fn main() {
// Creates the cursive root - required for every application.
let mut siv = cursive::default();
// Creates a dialog with a single "Quit" button
siv.add_layer(Dialog::around(TextView::new("Hello Dialog!"))
.title("Cursive")
.button("Quit", |s| s.quit()));
// Starts the event loop.
siv.run();
}
Larger applications can look like this (showcase example):
Check out the other examples to get these results, and more:
_(Colors may depend on your terminal configuration.)_
Tutorials
These tutorials may help you get started with cursive:
Starting with cursive: (1/3)
Starting with cursive: (2/3)
Starting with cursive: (3/3)
Third-party views
Here are a few crates implementing new views for you to use:
cursive-aligned-view: A view wrapper which aligns child views.
cursive-async-view: A loading-screen wrapper.
cursive_calendar_view: A basic calendar view implementation.
cursive-flexi-logger-view: An alternative debug view using flexi_logger.
cursive_hexview: A simple hexview.
cursive-hjkl: Wraps any view to use Vim-like hjkl controls.
cursive-image: A graphical image view. Supported formats include PNG, GIF, JPEG, SVG, and PDF.
cursive-markup: A view that renders HTML or other markup.
cursive-multiplex: A tmux like multiplexer.
cursive-spinner-view: A spinner view.
cursive-split-panel: A split panel view with a movable divider.
cursive_table_view: A basic table view component.
cursive-tabs: Tabs.
cursive-tree: A tree view implementation.
Showcases
Here are some cool applications using cursive:
RustyChat: Chat client made using Rust and Cursive.
checkline: Checkbox line picker from stdin to stdout.
clock-cli: A clock with stopwatch and countdown timer functionalities.
fui: Add CLI & form interface to your program.
game2048-rs: a tui game2048 using Rust and cursive.
git-branchless: Branchless workflow for Git.
grin-tui: Minimal implementation of the MimbleWimble protocol.
kakikun: A paint and ASCII art application for the terminal.
launchk: Manage launchd agents and daemons on macOS.
markline: Marker-based line picker from stdin to stdout.
mythra: CLI to search for music.
ncspot: Cross-platform ncurses Spotify client.
rbmenu-tui: A TUI for bookmark management.
retris: A simple implementation of the classic tetris game.
ripasso: A simple password manager written in Rust.
rusty-man:Top issues
#199Pause Cursive program and pass stdin and stdout to subprocess26 comments · 2018-01-28#463Always showing scrollbar in nested view?16 comments · 2020-06-28#90Add text decorations16 comments · 2016-12-06#142Termion backend is slow15 comments · 2017-06-13#519A few ideas from developing a non-trivial application with cursive13 comments · 2020-10-14#411Use something other than ncurses by default13 comments · 2019-12-14#653[BUG] - Garbled characters rendering under OpenBSD 7.111 comments · 2022-06-02#420View for showing other TUI apps?9 comments · 2020-01-20
Discussions
#869Problems setting focus to a View inside a View ... inside a Dialog1 comments · 2026-04-25#863Can it use Rc or Arc in Canvas document?0 comments · 2026-03-21#862Can we use it without adding layer?1 comments · 2026-03-16#852Better TableView crate for Cursive1 comments · 2026-01-19#845Blueprint for TreeView?2 comments · 2025-10-13#844Builder with nested Linear Layout?1 comments · 2025-10-13#842Dynamically adjust width? What's the right layout for what I want to do?1 comments · 2025-09-24#834Pre-fill EditText box with variable, and update TextView upon changes?1 comments · 2025-09-09
Latest release
cursive-core-v0.4.6 cursive-core-v0.4.6 2025-10-14Remove serde_yaml dependency (moved to dev-dependency)