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

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

Documentation

Refer to https://pkg.go.dev/github.com/rivo/tview for the package's documentation.

Dependencies

This package is based on github.com/gdamore/tcell (and its dependencies) as well as on github.com/rivo/uniseg.

Your Feedback

Add your issue here on GitHub. Feel free to get in touch if you have any questions.