HackerReposA FIELD GUIDE TO OPEN SOURCE
ProSponsor the shelf♧ 0
← Back to top all-time
dankamongmen
notcurses
C2019–2026
dankamongmen / notcurses

notcurses

blingful character graphics/TUI library. definitely not curses.

30Distinct people
48Mentions
0Explicit recommenders
4.8KGitHub stars
REPOSITORY AT A GLANCE

What to know before exploring

What it is

blingful character graphics/TUI library. definitely not curses.

GitHub

Where it is used

No documented product use was verified in the last source check.

What people are saying

No recommendation phrase was found in the indexed comments.

No classified warning is attached to this page. Read the discussions before treating silence as approval.

Also in these discussions

Mentioned in the same Hacker News threads. That is not proof they are substitutes.

This week on Hacker News

Nov 9–Nov 16 UTC · Direct repository links and separately labeled related project stories. Indexed through 11/16/2026, 4:59:52 AM UTC.

No direct repository links were found in the indexed HN discussions over the past seven days. Older discussions are available below.

Mentions over time

HN mentions by year48 dated mentions

Observed mentions: 2019-12-10 13:10:42 UTC to 2026-02-18 15:01:32 UTC.

0510152019-01-01 00:00:00 UTC to 2020-01-01 00:00:00 UTC (exclusive): 1 mentions; 1 submissions, 0 comments20192020-01-01 00:00:00 UTC to 2021-01-01 00:00:00 UTC (exclusive): 8 mentions; 3 submissions, 5 comments2021-01-01 00:00:00 UTC to 2022-01-01 00:00:00 UTC (exclusive): 15 mentions; 4 submissions, 11 comments2022-01-01 00:00:00 UTC to 2023-01-01 00:00:00 UTC (exclusive): 12 mentions; 0 submissions, 12 comments20222023-01-01 00:00:00 UTC to 2024-01-01 00:00:00 UTC (exclusive): 5 mentions; 0 submissions, 5 comments2024-01-01 00:00:00 UTC to 2025-01-01 00:00:00 UTC (exclusive): 5 mentions; 3 submissions, 2 comments2025-01-01 00:00:00 UTC to 2026-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments2026-01-01 00:00:00 UTC to 2027-01-01 00:00:00 UTC (exclusive): 1 mentions; 0 submissions, 1 comments. Incomplete calendar period.2026*

* An incomplete calendar period is marked with an outlined bar. Its count is not directly comparable with a full period.

Counts come from the repository’s dated source evidence. Index cutoff: 2026-11-02 08:16:59 UTC.

View mention counts and date ranges
UTC ranges include their start and exclude their end. Select a period to filter the source evidence.
PeriodStart (UTC)End (exclusive, UTC)MentionsSubmissionsComments
20192019-01-01 00:00:00 UTC2020-01-01 00:00:00 UTC110
20202020-01-01 00:00:00 UTC2021-01-01 00:00:00 UTC835
20212021-01-01 00:00:00 UTC2022-01-01 00:00:00 UTC15411
20222022-01-01 00:00:00 UTC2023-01-01 00:00:00 UTC12012
20232023-01-01 00:00:00 UTC2024-01-01 00:00:00 UTC505
20242024-01-01 00:00:00 UTC2025-01-01 00:00:00 UTC532
20252025-01-01 00:00:00 UTC2026-01-01 00:00:00 UTC101
2026 (partial)2026-01-01 00:00:00 UTC2027-01-01 00:00:00 UTC101

From the project README

An excerpt from the repository, fetched Nov 13, 2026.

Read the project’s introduction
Notcurses: blingful TUIs and character graphics What it is: a library facilitating complex TUIs on modern terminal emulators, supporting vivid colors, multimedia, threads, and Unicode to the maximum degree possible. Things can be done with Notcurses that simply can't be done with NCURSES. It is furthermore fast as shit. What it is not: a source-compatible X/Open Curses implementation, nor a replacement for NCURSES on existing systems. for more information, see dankwiki and the man pages. in addition, there is Doxygen output. i wrote a coherent guidebook, which is available for free download (or paperback purchase). i've not yet added many documented examples, but src/poc/ and src/pocpp/ contain many small C and C++ programs respectively. notcurses-demo covers most of the functionality of Notcurses. If you're running Notcurses applications in a Docker, please consult "Environment notes" below. Introduction Notcurses abandons the X/Open Curses API bundled as part of the Single UNIX Specification. For some necessary background, consult Thomas E. Dickey's superb and authoritative NCURSES FAQ. As such, Notcurses is not a drop-in Curses replacement. Wherever possible, Notcurses makes use of the Terminfo library shipped with NCURSES, benefiting greatly from its portability and thoroughness. Notcurses opens up advanced functionality for the interactive user on workstations, phones, laptops, and tablets, possibly at the expense of e.g. some industrial and retail terminals. Fundamentally, Curses assumes the minimum and allows you (with effort) to step up, whereas Notcurses assumes the maximum and steps down (by itself) when necessary. The latter approach probably breaks on some older hardware, but the former approach results in new software looking like old hardware. Why use this non-standard library? Thread safety, and efficient use in parallel programs, has been a design consideration from the beginning. A more orderly surface than that codified by X/Open: Exported identifiers are prefixed to avoid common namespace collisions. Where reasonable, static inline header-only code is used. This facilitates compiler optimizations, and reduces loader time. Notcurses can be built without its multimedia functionality, requiring a significantly lesser set of dependencies. All APIs natively support the Universal Character Set (Unicode). The nccell API is based around Unicode's Extended Grapheme Cluster concept. Visual features including images, fonts, video, high-contrast text, sprites, and transparent regions. All APIs natively support 24-bit color, quantized down as necessary for the terminal. Portable support for bitmapped graphics, using Sixel, Kitty, and even the Linux framebuffer console. Support for unambiguous keyboard protocols. "TUI mode" facilitates high-performance, non-scrolling, full-screen applications. "CLI mode" supports scrolling output for shell utilities, but with the full power of Notcurses. It's Apache2-licensed in its entirety, as opposed to the drama in several acts that is the NCURSES license (the latter is summarized as "a restatement of MIT-X11"). Much of the above can be had with NCURSES, but they're not what NCURSES was designed for. On the other hand, if you're targeting industrial or critical applications, or wish to benefit from time-tested reliability and portability, you should by all means use that fine library. Requirements Minimum versions generally indicate the oldest version I've tested with; it may well be possible to use still older versions. Let me know of any successes! (build) CMake 3.21.0+ and a C17 compiler (OPTIONAL) (OpenImageIO, testing, C++ bindings): A C++17 compiler (build+runtime) From NCURSES: terminfo 6.1+ (build+runtime) GNU libunistring 0.9.10+ (OPTIONAL) (build+runtime) libgpm 1.20+ (OPTIONAL) (build+runtime) From QR-Code-generator: libqrcodegen 1.5.0+ (OPTIONAL) (build+runtime) From FFmpeg: libswscale 5.0+, libavformat 57.0+, libavutil 56.0+, libavdevice 57.0+ (OPTIONAL) (build+runtime) OpenImageIO 2.15.0+, requires C++ (OPTIONAL) (testing) Doctest 2.3.5+ (OPTIONAL) (documentation) pandoc 1.19.2+ (OPTIONAL) (python bindings): Python 3.7+, CFFI 1.13.2+, pypandoc 1.5+ (runtime) Linux 2.6+, FreeBSD 11+, DragonFly BSD 5.9+, Windows 10 v1093+, or macOS 11.4+ More information on building and installation is available in INSTALL.md. Wrappers If you wish to use a language other than C to work with Notcurses, numerous wrappers are available. Several are included in this repository, while others are external. Language Lead(s) Repository Ada Jeremy Grosser JeremyGrosser/notcursesada C++ Marek Habersack, nick black internal Dart Nelson Fernandez kascote/dart_notcurses Julia Dheepak Krishnamurthy kdheepak/Notcurses.jl Nim Michael S. Bradley, Jr. michaelsbradleyjr/nim-notcurses Python nick black internal Python igo95862 internal Rust José Luis Cruz dankamongmen/libnotcurses-sys Zig Jakub Dundalek dundalek/notcurses-zig-example Raku Matt Doughty m-doughty/Notcurses-Native Included tools Nine executables are installed as part of Notcurses: ncls: an ls that displays multimedia in the terminal ncneofetch: a neofetch ripoff ncplayer: renders visual media (images/videos) nctetris: a tetris clone notcurses-demo: some demonstration code notcurses-info: detect and print terminal capabilities/diagnostics notcurses-input: decode and print keypresses notcurses-tester: unit testing tfman: a swank manual browser To run notcurses-demo from a checkout, provide the data directory via the -p argument. Demos requiring data files will otherwise abort. The base delay used in notcurses-demo can be changed with -d, accepting a floating-point multiplier. Values less than 1 will speed up the demo, while values greater than 1 will slow it down. notcurses-tester likewise requires that data, populated with the necessary data files, be specified with -p. It can be run by itself, or via make test. Documentation With -DUSE_PAND
Read the full README on GitHub

What Hacker News says

8 sources

Unicode 13 sextants advances state-in-the-art terminal rendering

I'm the author of a blingful TUI/character graphics library by the name of Notcurses. One of the core competencies of Notcurses is rendering images and video to a terminal (without undue shrinking of the font). Leaving aside asymmetric rendering such as that performed by caca (see Notcurses documentation for an explanation of why I don't think this a good general approach), common symmetric rendering techniques include spaces and Unicode half blocks ( and ). This last method is employed by tools like viu and mpv's TCT output, and can be considered the general "state of the art". Notcurses had already gone past this with its Quadblitter, making use of Unicode 3.2's quadrant blocks to map 2x2 pixels to a terminal cell. With the advent of Unicode 13's Legacy Computing Symbols (and rollout of font support for them), a powerful new symmetric b
Read the rest
litting method is made available, mapping 3 rows of 2 columns each to a single cell. This blitter is available as NCBLIT_3x2 in the upcoming Notcurses 2.0.3. I was worried that color loss would be more of a problem, but it ended up looking great! The following images are rendered using all four blitters: https://nick-black.com/images/worldmap-sexblitter.png (left to right: S, Q, H, ASCII) https://nick-black.com/images/sexblitter-perfection.png (clockwise from upper left: ASCII, H, Q, S) The algorithm is described here: https://github.com/dankamongmen/notcurses/issues/1086 code here: https://github.com/dankamongmen/notcurses/blob/master/src/lib/blit.c notcurses: https://nick-black.com/dankwiki/index.php?title=Notcurses hype video: https://www.youtube.com/watch?v=cYhZ7myXyyg enjoy! hack on!
9 points · Open discussion
A semi-relevant rant about CMake, for those interested in that kind of thing: The CMake scripting language is just awful. It breaks with convention to do things in its own unintuitive way. (Who though the endfunction() syntax was a good idea? Or the bizarre function-call syntax?) It's error-prone, it shows cryptic error-messages, it's able to break in subtle ways, much of the documentation is for deprecated functionality, and worst of all, it lacks a consistent design pattern. One shouldn't have to think when making a Find... CMake script so that CMake can find an installed package. It should be a very boring task of adapting existing boilerplate. But it's not so. It's an agonising uphill battle with this atrocious language. Subtle bugs like [0] wouldn't even be possible in a well-designed build-system, but CMake lets you shoot yourself i
Read the rest
n the foot as punishment for not knowing its every subtlety. It's unfortunate that CMake is the least bad build system we have. You should probably still use CMake for multi-platform code. You shouldn't expect people to learn some obscure rival build-system just to work on your code. I'll certainly continue using CMake for what little C++ I write myself. Once you've beaten your CMake scripts into submission (generally thanks to the extensive body of knowledge on StackOverflow, in my experience), CMake works a treat on a bunch of different platforms. It's just a pity the language is so terrible. [0] https://github.com/dankamongmen/notcurses/issues/711
In Allowing CMake functions to return(value)
Many of us have been pursuing personal projects to breathe new life into old technologies: Nick Black has been doing great work creating a successor to ncurses. He took the latest and greatest modern C++ / UNICODE development practices, and made it work really well for the old school terminal stuff from decades ago, which was easier said that done. https://github.com/dankamongmen/notcurses See also Cosmopolitan, which is more focused on the use case: "All I want is stdio and math; how can I do that without all the breaking builds and broken hearts?" https://github.com/jart/cosmopolitan Please consider supporting us. These old technologies are widely supported and have stood the test of time. Any positive developments towards making them fresh again, is going to benefit both you and the technology community as a whole.
In Rediscovering the beauty of text on the internet
Thanks, I've added CPPurses to the Notcurses OTHERS.md file: https://github.com/dankamongmen/notcurses/blob/master/OTHERS... Taking a quick look, I don't want to besmirch anyone else's efforts, and both of these projects look great. libtickit appears to be missing any kind of multimedia/pixel-based approach along the lines of Notcurses's ncvisual -- I'm not sure about CPPurses, but that one being written in C++ would seem to exclude pure C programs (obviously not if it's using POD structures etc). Both look like good efforts, and there's plenty of room for more than one project in this space. I wish them both luck!
In Hacking the Planet With Notcurses: A Guide to TUIs and Character Graphics [pdf]

Marriage of ffmpeg and terminal TUIs, notcurses 1.1.0

I just cut 1.1.0 of my new(ish) TUI library, notcurses. I started work on it back in November, and it's now IMHO pretty fit for general use. 1.1.0 demo: https://www.youtube.com/watch?v=-H1WkopWJNM github: https://github.com/dankamongmen/notcurses wiki: https://nick-black.com/dankwiki/index.php/Notcurses notcurses is an obvious intellectual descendant of NCURSES, which Thomas E. Dickey has masterfully developed and maintained for decades. notcurses breaks away from the prelapsarian X/Open Curses API, but its interface will be quite familiar to experienced NCURSES programmers. For new TUI developers, I hope that notcurses has fewer gotchas than NCURSES. notcurses supports 24-bit DirectColor RGB as its primary color specification (though palette indexed color is also supported, for its bandwidth benefits). Almost anything you can do in NCURS
Read the rest
ES can be done in notcurses, though a few things (most especially menus) must currently be handrolled. In addition, there's rich support for various types of transparency/color blending, image rendering, fades, giant virtual planes, z-axis depths of thousands of planes, and other good stuff. Experimental Python wrappers are included in this release. I hope to cut C++ and Rust wrappers soon. Please take a look, and give the demo a local run if you've the time. Feedback and/or bug reports would both be invaluable. If you'd like to see a real app using notcurses, my growlight tool has been adapted to it: https://github.com/dankamongmen/growlight This was several thousand lines of NCURSES UI code. Switching it to notcurses was a generally painless procedure of a few hours.
1 points · Open discussion

MAKE YOURSELF AT HOME

A few shortcuts

/
Search the collection
?
Open this guide
Esc
Close dialogs and navigation

Your saved repositories and interests stay in this browser.