termdash alternatives and similar packages
Based on the "Advanced Console UIs" category
Do you think we are missing an alternative of termdash or a related project?
Termdash is a cross-platform customizable terminal based dashboard.
This rewrite focuses on code readability, maintainability and testability, see the [design goals](doc/design_goals.md). It aims to achieve the following [requirements](doc/requirements.md). See the [high-level design](doc/hld.md) for more details.
Public API and status
The public API surface is documented in the wiki.
Private packages can be identified by the presence of the /internal/ directory in their import path. Stability of the private packages isn't guaranteed and changes won't be backward compatible.
There might still be breaking changes to the public API, at least until the project reaches version 1.0.0. Any breaking changes will be published in the [changelog](CHANGELOG.md).
Current feature set
- Full support for terminal window resizing throughout the infrastructure.
- Customizable layout, widget placement, borders, margins, padding, colors, etc.
- Dynamic layout changes at runtime.
- Binary tree and Grid forms of setting up the layout.
- Focusable containers and widgets.
- Processing of keyboard and mouse events.
- Periodic and event driven screen redraw.
- A library of widgets, see below.
- UTF-8 for all text elements.
- Drawing primitives (Go functions) for widget development with character and sub-character resolution.
To install this library, run the following:
go get -u github.com/mum4k/termdash
The usage of most of these elements is demonstrated in [termdashdemo.go](termdashdemo/termdashdemo.go). To execute the demo:
go run github.com/mum4k/termdash/termdashdemo/termdashdemo.go
Please refer to the Termdash wiki for all documentation and resources.
Allows users to interact with the application, each button press runs a callback function. Run the [buttondemo](widgets/button/buttondemo/buttondemo.go).
go run github.com/mum4k/termdash/widgets/button/buttondemo/buttondemo.go
Allows users to interact with the application by entering, editing and submitting text data. Run the [textinputdemo](widgets/textinput/textinputdemo/textinputdemo.go).
go run github.com/mum4k/termdash/widgets/textinput/textinputdemo/textinputdemo.go
Displays the progress of an operation. Run the [gaugedemo](widgets/gauge/gaugedemo/gaugedemo.go).
go run github.com/mum4k/termdash/widgets/gauge/gaugedemo/gaugedemo.go
Visualizes progress of an operation as a partial or a complete donut. Run the [donutdemo](widgets/donut/donutdemo/donutdemo.go).
go run github.com/mum4k/termdash/widgets/donut/donutdemo/donutdemo.go
Displays text content, supports trimming and scrolling of content. Run the [textdemo](widgets/text/textdemo/textdemo.go).
go run github.com/mum4k/termdash/widgets/text/textdemo/textdemo.go
Draws a graph showing a series of values as vertical bars. The bars can have sub-cell height. Run the [sparklinedemo](widgets/sparkline/sparklinedemo/sparklinedemo.go).
go run github.com/mum4k/termdash/widgets/sparkline/sparklinedemo/sparklinedemo.go
Displays multiple bars showing relative ratios of values. Run the [barchartdemo](widgets/barchart/barchartdemo/barchartdemo.go).
go run github.com/mum4k/termdash/widgets/barchart/barchartdemo/barchartdemo.go
Displays series of values on a line chart, supports zoom triggered by mouse events. Run the [linechartdemo](widgets/linechart/linechartdemo/linechartdemo.go).
go run github.com/mum4k/termdash/widgets/linechart/linechartdemo/linechartdemo.go
Displays text by simulating a 16-segment display. Run the [segmentdisplaydemo](widgets/segmentdisplay/segmentdisplaydemo/segmentdisplaydemo.go).
go run github.com/mum4k/termdash/widgets/segmentdisplay/segmentdisplaydemo/segmentdisplaydemo.go
If you are willing to contribute, improve the infrastructure or develop a widget, first of all Thank You! Your help is appreciated.
Please see the [CONTRIBUTING.md](CONTRIBUTING.md) file for guidelines related to the Google's CLA, and code review requirements.
As stated above the primary goal of this project is to develop readable, well designed code, the functionality and efficiency come second. This is achieved through detailed code reviews, design discussions and following of the [design guidelines](doc/design_guidelines.md). Please familiarize yourself with these before contributing.
If you're developing a new widget, please see the [widget development](doc/widget_development.md) section.
Termdash uses this branching model. When you fork the repository, base your changes off the devel branch and the pull request should merge it back to the devel branch. Commits to the master branch are limited to releases, major bug fixes and documentation updates.
Similar projects in Go
Projects using Termdash
- datadash: Visualize streaming or tabular data inside the terminal.
- grafterm: Metrics dashboards visualization on the terminal.
This is not an official Google product.
*Note that all licence references and agreements mentioned in the termdash README section above are relevant to that project's source code only.