guessmyname5 days ago
People have been posting about these Charm projects for a few years now [1]. I think they look cool and, while I know they exist, I have never found myself in a position where I want to add them to my consumer-facing projects, nor even my personal projects. Does anyone have examples of (public) non-trivial Terminal programs that make use of these libraries?
[1] https://news.ycombinator.com/from?site=github.com/charmbrace...
terminaltrove5 days ago
We have a lot here which this list is exclusively TUI programs.
https://terminaltrove.com/categories/tui
and another list which are terminal tool of the week where some TUIs are complex, like dolphie, kaskade, trippy or pug for example.
https://terminaltrove.com/tool-of-the-week/
https://terminaltrove.com/dolphie/
https://terminaltrove.com/kaskade/
bewuethr4 days ago
The GitHub CLI (https://cli.github.com/) uses Bubble Tea. There's no good way to find popular dependents, but you can browse https://github.com/charmbracelet/bubbletea/network/dependent... to see GitHub repos that import the module.
wlamartin4 days ago
Just as a note, the GitHub CLI doesn't use bubbletea itself right now, though it does use other charm libraries such as lipgloss and glamour. That said, it's quite likely that at some point we will use huh for our prompting library, which does use bubbletea.
bewuethr3 days ago
Oh wow, I could have sworn! Did you never use bubble tea and bubbles, or did you remove them at some point?
woodruffw5 days ago
I similarly haven't used them, but vhs[1] looks very cool and useful (at least for my purposes, where I like to have lots of terminal demos in my documentation).
oulipo4 days ago
I'm using `gum` in my personal shell scripts when I want basic interaction (show a list, checkboxes, etc)
pointlessone4 days ago
Animated images in the readme are not a very good experience. I’m trying to read the output and make sense of it and it just blinks out. There’s no good reason to have animation here. We all know how text is typed in the terminal.
arcanemachiner4 days ago
Good use case for Asciinema.
https://github.com/asciinema/asciinema
EDIT: Looks like image generator might be from one of their own projects:
Gormo4 days ago
Given the purpose of the tool, it seems like the most appropriate solution would be to use ANSI itself to animate the text.
zellyn4 days ago
Is that not what asciinema does?
Gormo4 days ago
No, asciinema uses a custom data format to store the terminal data, then uses custom JS to play it back within a web site.
I'm talking about just distributing ANSI files.
kreetx4 days ago
It shows the CLI use, seems pretty useful to me.
Timwi4 days ago
It doesn't show anything a still image that I can just read wouldn't also show. It has no upside and only downsides.
aumerle5 days ago
Or run
kitty --dump-commands program-whose-output-you-want-to-inspect
You can even save the --dump-commands output as edit it and then replay it with
kitty --dump-commands program > commands.txt
kitty --replay-commands commands.txt
ljouhet5 days ago
Great work: this tool will be really useful to me!
(Note: the "terminal animations" in github make the examples difficult to read.)
EdSchouten5 days ago
Indeed. A screenshot of the resulting output would have been more useful.
frizlab4 days ago
I literally took a screenshot of the animation to be able to read it yeah.
jakeogh4 days ago
That's fantastic. Regarding the note about output detection, here is a short tcl script that attempts to trick the app into thinking it's writing to a terminal: https://github.com/jakeogh/colorpipe
jchook4 days ago
Isn't it true that ANSI sequences can vary depending on the terminal emulator? Does this program account for that somehow?
In my shell scripts I often use `tput bold` etc instead of hardcoding the sequences.
Joker_vD4 days ago
Well, yes, the meaning can depend, although many sequences have standardized meanings. The format of the sequences itself is also standardized but of course, the terminals don't need to use it either! There has been lots of terminals that use their own bespoke control sequences.
Still, nowadays people who write new terminal emulators tend to approach with "do what xterm/libvte does" attitude which is quite sensible: very few people use actual, physical terminals anymore, and the software ones are, well, are generally based on xterm or libvte (or that third library I keep forgetting).
And when was the last time terminfo has been updated anyhow? Not to mention that it lacks info about modern features such as e.g. the version of Unicode used/supported by the terminal.
zokier4 days ago
> And when was the last time terminfo has been updated anyhow?
Two weeks ago?
https://lists.gnu.org/archive/html/bug-ncurses/2024-11/msg00...
> misc/terminfo.src | 40 ++++++++++++++++++++++++++++++-------
Joker_vD4 days ago
Wow, reading the history at the end of that file is... depressing. Well, good luck to Thomas E. Dickey, testing the vt/xterm-compatibiity of all the newfangled terminal emulators and maintaining capabilities on stuff like DJGPP in perpetuity.
Gormo4 days ago
What's depressing about it?
teddyh4 days ago
> Isn't it true that ANSI sequences can vary depending on the terminal emulator?
Yes, historically, many terminals were not even ANSI compatible. That is why the terminfo database (and its predecessor termcap) exist; for programs to look at the TERM environment variable, use that to look up the terminal’s capabilities in terminfo, and see what the terminal can and cannot do, and then choose to output whatever sequences the terminal does support. Normally, a program uses yet another library, like ncurses, to do this, but you can do it yourself if you want to, like in a shell script or similar. Outputting raw escape codes is wrong, since the correct way is so very easy.
Joker_vD4 days ago
Don't forget to take care about the terminal code pages as well! Thankfully, terminfo tells you which commands to use when you want to print e.g. β, right?
teddyh4 days ago
The easy way is to either restrict yourself to ASCII, or to output raw characters in whatever encoding your locale (LC_CTYPE, LANG, etc.) specifies. If you want to get really fancy with ancient terminals, some of them have, for instance, line drawing characters (and, yes, sometimes things like β) hidden behind special escape sequences, which you can, IIRC, look up in terminfo.
Joker_vD4 days ago
So the "correct" way is not that easy, after all.
On the other hand, ignoring ancient terminals and simply pretending everything is color-enabled, VT-220 compatible, UTF-8 aware terminal emulator works well enough™ almost everywhere, including recent versions of Windows (which IIRC don't even have terminfo; not that it'd help since the legacy Windows console uses ioctl()-like interface instead of the escape sequences) — and is actually easy.
teddyh3 days ago
Outputting UTF-8 to a UTF-8 locale is not easy? Most of this is automatically handled by appropriate libraries.
I.e. I would expect
python3 -c 'print("\N{GREEK SMALL LETTER BETA}")'
binarybard4 days ago
Amazing!! Love seeing these tools from charmbracelet!
On a side note - VHS and mods have been super helpful to me.
junon4 days ago
Another banger from Charm! Adding this to my tool belt for sure.