Rich Interactive Widgets for Terminal UIs

This Go package provides commonly needed components for terminal based user interfaces.

Among these components are:

• Input forms (include input/password fields, drop-down selections, checkboxes, and buttons)
• Navigable multi-color text views
• Sophisticated navigable table views
• Flexible tree views
• Selectable lists
• 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.

Installation

go get github.com/rivo/tview

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

• IRCCloud Terminal Client
• Window manager for

  tview

• Password manager
• CLI bookmark manager
• A caving database interface written in Go
• App for rental of electic bikes
• Interactive file browse and exec any command.
• A simple CRM
• Terminal UI for todist
• Graphical kubectl wrapper
• Decred Decentralized Exchange
• Kubernetes CLI To Manage Your Clusters In Style!
• 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.
• CLI tool build in Golang for managing ssh connection
• 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
• Cryptowatch Go SDK
• 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

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.

Versioning and Backwards-Compatibility

I try really hard to keep this project backwards compatible. Your software should not break when you upgrade

tview

• 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.