https://github.com/rivo/tview Skip to content Navigation Menu Toggle navigation Sign in * Product + Actions Automate any workflow + Packages Host and manage packages + Security Find and fix vulnerabilities + Codespaces Instant dev environments + Copilot Write better code with AI + Code review Manage code changes + Issues Plan and track work + Discussions Collaborate outside of code Explore + All features + Documentation + GitHub Skills + Blog * Solutions For + Enterprise + Teams + Startups + Education By Solution + CI/CD & Automation + DevOps + DevSecOps Resources + Learning Pathways + White papers, Ebooks, Webinars + Customer Stories + Partners * Open Source + GitHub Sponsors Fund open source developers + The ReadME Project GitHub community articles Repositories + Topics + Trending + Collections * Pricing Search or jump to... Search code, repositories, users, issues, pull requests... Search [ ] Clear Search syntax tips Provide feedback We read every piece of feedback, and take your input very seriously. [ ] [ ] Include my email address so I can be contacted Cancel Submit feedback Saved searches Use saved searches to filter your results more quickly Name [ ] Query [ ] To see all available qualifiers, see our documentation. Cancel Create saved search Sign in Sign up You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session. You switched accounts on another tab or window. Reload to refresh your session. Dismiss alert {{ message }} rivo / tview Public * * Notifications * Fork 530 * Star 9.9k * Terminal UI library with rich, interactive widgets -- written in Golang License MIT license 9.9k stars 530 forks Branches Tags Activity Star Notifications * Code * Issues 51 * Pull requests 46 * Actions * Projects 0 * Wiki * Security * Insights Additional navigation options * Code * Issues * Pull requests * Actions * Projects * Wiki * Security * Insights rivo/tview This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository. master BranchesTags Go to file Code Folders and files Name Name Last commit message Last commit date Latest commit History 740 Commits .github .github demos demos CONTRIBUTING.md CONTRIBUTING.md LICENSE.txt LICENSE.txt README.md README.md ansi.go ansi.go application.go application.go borders.go borders.go box.go box.go button.go button.go checkbox.go checkbox.go doc.go doc.go dropdown.go dropdown.go flex.go flex.go form.go form.go frame.go frame.go go.mod go.mod go.sum go.sum grid.go grid.go image.go image.go inputfield.go inputfield.go list.go list.go modal.go modal.go pages.go pages.go primitive.go primitive.go semigraphics.go semigraphics.go strings.go strings.go styles.go styles.go table.go table.go textarea.go textarea.go textview.go textview.go treeview.go treeview.go tview.gif tview.gif util.go util.go View all files Repository files navigation * README * MIT license Rich Interactive Widgets for Terminal UIs PkgGoDev Go Report This Go package provides commonly used components for terminal based user interfaces. Screenshot Among these components are: * Input forms (including text input, selections, checkboxes, and buttons) * Navigable multi-color text views * Editable multi-line text areas * Sophisticated navigable table views * Flexible tree views * Selectable lists * Images * Grid, Flexbox and page layouts * Modal message windows * An application wrapper They come with lots of customization options and can be easily extended to fit your needs. Usage To add this package to your project: go get github.com/rivo/tview@master Hello World This basic example creates a box titled "Hello, World!" and displays it in your terminal: package main import ( "github.com/rivo/tview" ) func main() { box := tview.NewBox().SetBorder(true).SetTitle("Hello, world!") if err := tview.NewApplication().SetRoot(box, true).Run(); err != nil { panic(err) } } Check out the GitHub Wiki for more examples along with screenshots. Or try the examples in the "demos" subdirectory. For a presentation highlighting this package, compile and run the program found in the "demos/presentation" subdirectory. Projects using tview * K9s - Kubernetes CLI * IRCCloud Terminal Client * Window manager for tview * CLI bookmark manager * A caving database interface written in Go * Interactive file browse and exec any command. * A complete TUI for LDAP * A simple CRM * Terminal UI for todist * Graphical kubectl wrapper * Decred Decentralized Exchange * A CLI file browser for Raspberry PI * A tool to manage projects. * A simple app for BMI monitoring * Stream TIDAL from command line * Secure solution for fully decentralized password management * A growing collection of convenient little tools to work with systemd services * A terminal based browser for Redis written in Go * First project for the Computer Networks course. * Test your typing speed in the terminal! * TUI Client for Docker * SSH client using certificates signed by HashiCorp Vault * A go terminal based pos software. * VMware vCenter Text UI * Bookmarks on terminal * A UDP testing utility * A simple Kanban board for your terminal * The personal information dashboard for your terminal. * MySQL database to Golang struct * Discord, TUI and SIXEL. * A CLI Audio Player * GLab, a GitLab CLI tool * Browse your AWS ECS Clusters in the Terminal * The CLI Task Manager for Geeks * Fast disk usage analyzer written in Go * Multiplayer Chess On Terminal * Scriptable TUI music player * MangaDesk : TUI Client for downloading manga to your computer * Go How Much? a Crypto coin price tracking from terminal * dbui: Universal CLI for Database Connections * ssmbrowse: Simple and elegant cli AWS SSM parameter browser * gobit: binance intelligence terminal * viddy: A modern watch command * s3surfer: CLI tool for browsing S3 bucket and download objects interactively * libgen-tui: A terminal UI for downloading books from Library Genesis * kubectl-lazy: kubectl plugin to easy to view pod * podman-tui: podman user interface * tvxwidgets: tview extra widgets * Domino card game on terminal * goaround: Query stackoverflow API and get results on terminal * resto: a CLI app can send pretty HTTP & API requests with TUI * twad: a WAD launcher for the terminal * pacseek: A TUI for searching and installing Arch Linux packages * 7GUIs demo * tuihub: A utility hub/dashboard for personal use * l'oggo: A terminal app for structured log streaming (GCP stack driver, k8s, local streaming) * reminder: Terminal based interactive app for organising tasks with minimal efforts. * tufw: A terminal UI for ufw. * gh: the GitHub CLI * piptui: Terminal UI to manage pip packages * cross-clipboard: A cross-platform clipboard sharing * tui-deck: nextcloud deck frontend * ktop: A top-like tool for your Kubernetes clusters * blimp: UI for weather, network latency, application status, & more * Curly - A simple TUI leveraging curl to test endpoints * amtui: Alertmanager TUI * A TUI CLI manager * PrivateBTC * play: A TUI playground to experiment with your favorite programs, such as grep, sed, awk, jq and yq * gorest: Enjoy making HTTP requests in your terminal, just like you do in Insomnia. * Terminal-based application to listen Radio Stations around the world! * ntui: A TUI to manage Hashicorp Nomad clusters * lazysql: A cross-platform TUI database management tool written in Go * redis-tui: A Redis Text-based UI client in CLI * fen: File manager Documentation Refer to https://pkg.go.dev/github.com/rivo/tview for the package's documentation. Also check out the Wiki. Dependencies This package is based on github.com/gdamore/tcell (and its dependencies) as well as on github.com/rivo/uniseg. Sponsor this Project Become a Sponsor on GitHub to further this project! Versioning and Backwards-Compatibility I try really hard to keep this project backwards compatible. Your software should not break when you upgrade tview. But this also means that some of its shortcomings that were present in the initial versions will remain. In addition, at least for the time being, you won't find any version tags in this repo. The newest version should be the one to upgrade to. It has all the bugfixes and latest features. Having said that, backwards compatibility may still break when: * a new version of an imported package (most likely tcell) changes in such a way that forces me to make changes in tview as well, * I fix something that I consider a bug, rather than a feature, something that does not work as originally intended, * I make changes to "internal" interfaces such as Primitive. You shouldn't need these interfaces unless you're writing your own primitives for tview. (Yes, I realize these are public interfaces. This has advantages as well as disadvantages. For the time being, it is what it is.) Your Feedback Add your issue here on GitHub. Feel free to get in touch if you have any questions. Code of Conduct We follow Golang's Code of Conduct which you can find here. About Terminal UI library with rich, interactive widgets -- written in Golang Topics golang user-interface terminal-based Resources Readme License MIT license Activity Stars 9.9k stars Watchers 122 watching Forks 530 forks Report repository Sponsor this project Sponsor Learn more about GitHub Sponsors Used by 3.3k * @jplozf * @LinPr * @ajrudzitis * @VoltaicGRiD * @Hank-TNguyen * @13inary * @cthdarren * @Gistrup-Lan-Weekend + 3,308 Contributors 88 * @rivo * @millerlogic * @benweidig * @tslocum * @SamWhited * @ardnew * @tjhowse * @mjwhitta * @navidys * @paololazzari * @ajcarvajal * @dundee * @mikeschinkel * @kvj + 74 contributors Languages * Go 100.0% Footer (c) 2024 GitHub, Inc. Footer navigation * Terms * Privacy * Security * Status * Docs * Contact * Manage cookies * Do not share my personal information You can't perform that action at this time.