project - STUI

STUI is a Simple, header-only library for building Text UIs for terminal applciations.

i originally started developing this because i wanted a framework for building my FBX debug tool and showing graphical output in the command line. inspired by gitui and its amazing TUI, i went looking for appropriate libraries, but i couldn't find one which was header-only and light-weight enough for my purposes (and written for C++).

so i ended up writing this library! it's about 3000 lines long in total and provides a variety of widgets along with a system for displaying them and taking control of the terminal. it supports ANSI terminal colours as well as Unicode special characters.

you should definitely look at the Github page linked at the top, but here's a brief rundown of the features:

• cross-platform - tested on Linux and Windows (including WSL)
• immediate-mode - draw to the screen whenver you want
• header-only - just add the header file(s) to your project and you're done
• extensible - write your own components if you like
• documented - thorough documentation both in source and as a separate tutorial document makes it easy to get started

i wrote this over the course of just two weeks, and learned a ton about how terminal emulators work on both Linux and Windows, and i made use of gprof to profile my code. STUI is capable of rendering at around 3000 frames per second for a complex UI on a mid-spec machine. not that you're likely to have a screen that refreshes that fast.

as you might have guessed, all of the images here are things i built with STUI to test and demo it. all of these are less than 300 lines of source, most are a lot less.