Zum Inhalt springen
Michael Blaess
IT-Consulting
Michael Blaess
EN

Ratatui, Textual und Terminal.Gui im Vergleich

12 Minuten Lesezeit TUITextualRatatuiTerminal.GuiPythonRustC#

Meine Terminal-Anwendungen (TUIs, kurz für Text User Interface) baue ich mit Textual, einem Framework für Python. So sind retro-amp, jira-timesheet, sitemap-tracker, console-error-scanner und christophorus entstanden.
Dazu kommen zwei eigene Erweiterungen:
textual-widgets mit Bausteinen wie Kontextmenü, Datumsauswahl und Log-Fenster, und textual-themes mit 41 Themes.

jira-timesheet im Terminal: die Jahresansicht mit einer Kachel je Monat, Fortschrittsbalken und gebuchten Stunden
jira-timesheet in der Jahresansicht, gebaut mit Textual. Die Daten im Bild sind Beispieldaten.

Meine Vermutung war bisher: Textual ist das beste Framework für TUIs und dürfte einmalig sein. Eine Vermutung ist aber kein Befund!
Deshalb gibt es hier den echten Vergleich mit zwei Bibliotheken, die in ihren Sprachen zu den besten Frameworks für die Erstellung von Konsolenanwendungen zählen:
Ratatui für Rust und Terminal.Gui für C#.
Für mich als leidenschaftlichen C#-Entwickler war insbesondere Terminal.Gui hochinteressant, stammt es doch von niemand Geringerem als Miguel de Icaza, dem Vater von Xamarin.

Ratatui ist 2023 als Fork der älteren Bibliothek tui-rs entstanden. Terminal.Gui ist das älteste der drei Repos und liegt seit Dezember 2017 auf GitHub. Textual liegt auf GitHub bei Textualize, derselben Organisation, bei der auch Rich liegt, eine Python-Bibliothek für formatierte Ausgabe im Terminal.

Die Zahlen von GitHub

Ratatui Textual Terminal.Gui
Sprache Rust Python C#
Repo angelegt 12.02.2023 08.04.2021 11.12.2017
Sterne 22.942 37.430 11.258
Forks 802 1.355 793
Offene Issues 140 245 44
Offene Pull Requests 57 118 8
Mitwirkende 292 185 134
Letzter Push 10.10.2026 09.10.2026 09.10.2026
Letzte Version 0.30.2 vom 19.06.2026 8.2.8 vom 30.06.2026 2.5.0 vom 11.09.2026
Lizenz MIT MIT MIT

Alle Werte wurden am 11. Oktober 2026 über die Schnittstelle von GitHub abgerufen, die Zeitangaben sind in UTC. „Mitwirkende“ ist die Zahl, die GitHub für das Repo ausweist, ohne anonyme Beiträge. Das Repo von Terminal.Gui lag früher unter gui-cs und liegt jetzt unter tui-cs, die alte Adresse leitet weiter.

Vorschaukarte des Repos Textualize/textual auf GitHub mit Mitwirkenden, Sternen und Forks Vorschaukarte des Repos ratatui/ratatui auf GitHub mit Mitwirkenden, Sternen und Forks Vorschaukarte des Repos tui-cs/Terminal.Gui auf GitHub mit Mitwirkenden, Sternen und Forks
Die Vorschaukarten der drei Repos auf GitHub, Stand 11. Oktober 2026.

Bei den Downloads zählt jedes Paketverzeichnis anders, die Werte lassen sich deshalb nicht nebeneinanderstellen:

  • Ratatui auf crates.io: 58,8 Millionen seit Bestehen, davon 21,3 Millionen in den letzten 90 Tagen.
  • Textual auf PyPI: 55,3 Millionen in den letzten 30 Tagen laut pypistats.org. Die Monatswerte von April bis September 2026 schwanken dort zwischen 55 und 445 Millionen. Die Ursache wurde nicht untersucht, als Maß für die Zahl der Entwickler taugt der Wert damit nicht.
  • Terminal.Gui auf NuGet: 2,14 Millionen seit Bestehen. Einen Wert für die letzten Wochen liefert die Schnittstelle nicht.

Dieselbe Anwendung dreimal implementiert

Damit der Aufwand vergleichbar wird, gibt es in allen drei Frameworks dieselbe kleine Anwendung:
eine Titelliste mit drei Einträgen, Auswahl mit den Pfeiltasten, eine Fußzeile mit dem Hinweis „q Beenden“, Beenden mit q in beiden Schreibweisen, und Tests, die ohne echtes Terminal laufen. Alle drei Fassungen sind mit Claude Code entstanden.

Bei Terminal.Gui stand zuerst die Frage nach der Version. Gebaut wurde mit 2.5.0, weil das die aktuelle stabile Fassung ist. Version 2 ist nach Angabe des Projekts eine vollständige Neufassung, die erste stabile 2.0.0 erschien am 28. April 2026.

Ratatui 0.30.2 Textual 8.2.8 Terminal.Gui 2.5.0
Zeilen der Anwendung 50 16 37
Zeilen der Tests 31 20 37
Direkte Abhängigkeiten 1 1 1
Alle Pakete, mit der Bibliothek 63 9 24
Zusätzlich für die Tests nichts pytest und pytest-asyncio 4 Pakete aus der xUnit-Vorlage
Tests 2 bestanden 3 bestanden 3 bestanden

Gezählt wurden Zeilen ohne Leerzeilen. Gemessen wurde am 11. Oktober 2026 unter Windows 11 mit Rust 1.99, Python 3.12 und dem .NET SDK 10. Bei Ratatui sind die 63 Pakete jene, die ein Release-Build unter Windows übersetzt.

Die Fassung mit Textual im Terminal: Titelliste mit blauem Rahmen, Fußzeile mit q Beenden und dem Hinweis auf die Command Palette Die Fassung mit Ratatui im Terminal: Titelliste mit einfachem Rahmen, die Auswahl ist mit einem Pfeil markiert, darunter q Beenden Die Fassung mit Terminal.Gui im Terminal: Titelliste mit einfachem Rahmen, die Auswahl ist weiß hinterlegt, darunter q Beenden
Dieselbe Anwendung mit Textual, Ratatui und Terminal.Gui, jeweils in Windows PowerShell.

Textual: am wenigsten Code

Die Fassung mit Textual ist die kürzeste. Die Liste, die Fußzeile und die Tastenbelegung sind fertige Bausteine, der Rahmen um die Liste ist eine Zeile CSS:

class TrackList(App[None]):
    CSS = "ListView { border: round $primary; }"
    BINDINGS = [
        Binding("q,Q", "quit", "Beenden", key_display="q"),
    ]

    def compose(self) -> ComposeResult:
        yield ListView(*(ListItem(Label(track)) for track in TRACKS))
        yield Footer()

Die Fußzeile baut Textual aus der Tastenbelegung selbst. Der Test startet die Anwendung über run_test() ohne Terminal und drückt Tasten über ein Objekt namens Pilot. Geprüft wird dabei der Zustand der Widgets, also welcher Eintrag markiert ist. Für den Vergleich ganzer Bildschirme beschreibt die Dokumentation Snapshot-Tests mit einem eigenen Plugin, das wurde hier nicht ausprobiert.

Eine Eigenheit kenne ich aus meinen Anwendungen:
Tastenbelegungen unterscheiden Groß- und Kleinschreibung. Wer nur q belegt, kann mit eingeschalteter Feststelltaste nicht beenden. Deshalb steht oben q,Q.

Ratatui: das Input-Handling muss man selber implementieren

Ratatui ist eine Bibliothek und kein Framework. In der Dokumentation steht dazu der Satz „Ratatui does not include any input handling“. Die Anwendung besteht deshalb aus drei Teilen, die man selbst schreibt:
dem Zustand, einer Funktion zum Zeichnen und einer Schleife, die auf Tasten wartet.

fn run(terminal: &mut DefaultTerminal) -> io::Result<()> {
    let mut app = App::new();
    while !app.quit {
        terminal.draw(|frame| app.draw(frame))?;
        if let Event::Key(key) = event::read()?
            && key.kind == KeyEventKind::Press
        {
            app.on_key(key.code);
        }
    }
    Ok(())
}

Das sind mehr Zeilen, dafür ist nichts verborgen. Der Test zeichnet in ein TestBackend und liest danach die Zeichen aus dem Puffer. Ein zusätzliches Paket braucht er nicht. Das fertige Programm ist eine einzelne Datei mit 433 Kilobyte.

Terminal.Gui: viele fertige Bedienelemente, aber zwei Stolperstellen

Terminal.Gui arbeitet wie ein klassisches Toolkit für Desktop-Oberflächen. Es gibt Fenster, Bedienelemente mit Eigenschaften und Ereignisse. Die Position wird relativ beschrieben, zum Beispiel Height = Dim.Fill (1) für „alles bis auf eine Zeile“.

List = new ()
{
    Title = "Titel",
    BorderStyle = LineStyle.Single,
    Width = Dim.Fill (),
    Height = Dim.Fill (1),
    Source = new ListWrapper<string> (tracks),
    Value = 0,
    KeystrokeNavigator = null
};

Für Tests bringt die Bibliothek einen eigenen Treiber, das Einspielen von Tasten und Mausklicks und eine virtuelle Uhr mit. Der Bildschirm lässt sich als Text auslesen, der Test hier prüft darüber die Liste und die Fußzeile.

Zwei Dinge liefen nicht beim ersten Versuch:

  • Die Tests ließen sich zunächst nicht übersetzen. Die Beispiele in der Dokumentation zeigen InjectKey und VirtualTimeProvider, aber nicht die beiden Namensräume, in denen sie liegen (Terminal.Gui.Testing und Terminal.Gui.Time).
  • Die Taste q kam nicht an. Die Liste hat eine eingebaute Suche beim Tippen, und die hat den Buchstaben verbraucht. Erst mit KeystrokeNavigator = null erreichte die Taste das Fenster.

Fähigkeiten im Überblick

Ratatui Textual Terminal.Gui
Bauart Bibliothek, Schleife und Eingaben schreibt man selbst Framework mit eigener Schleife, Widget-Baum und Nachrichten Framework mit Hierarchie aus Views, Kommandos und Ereignissen
Mitgelieferte Widgets 17 42 71
Anordnung Constraints im Code CSS: vertikal, horizontal, Raster, Andocken Pos und Dim im Code, relativ zu anderen Views
Gestaltung Style-Objekte im Code eigenes CSS mit Selektoren Schemes und Themes über Konfiguration
Mitgelieferte Themes nicht geprüft 21 6
Maus über die Terminal-Bibliothek crossterm, nicht über Ratatui ja ja
Asynchrone Tasks keine eigene Lösung, es gibt eine Vorlage mit async Worker-Schnittstelle async und Invoke, Oberfläche nur im Hauptthread
Command Palette (Suchfeld für alle Befehle) keine gefunden eingebaut, Strg+P keine gefunden
Tests ohne Terminal TestBackend run_test() und Pilot, Snapshot-Tests eigener Treiber, eingespielte Eingaben, virtuelle Uhr
Betrieb im Browser Ratzilla, eigenes Projekt textual-serve, eigenes Projekt nichts gefunden

Die Angaben stammen aus der Dokumentation und dem Quelltext der drei Projekte, Stand 11. Oktober 2026. „Keine gefunden“ heißt: Eine Suche im Dateibaum des Repos blieb ohne Treffer. Ausprobiert wurden davon nur die Liste, die Tastenbelegung und die Tests.

Zu den Widgets drei Anmerkungen, weil die Zahlen verschieden zustande kommen:

  • Ratatui: Die 17 stehen in der Liste des Pakets ratatui-widgets. Zwei davon sind das Logo und das Maskottchen des Projekts. Eingabefeld, Knopf oder Auswahlfeld sind nicht darunter, dafür gibt es Pakete von Dritten.
  • Textual: 42 Klassen exportiert das Modul textual.widgets in Version 8.2.8, darunter Hilfsklassen wie Tab und ListItem. Die Dokumentation hat 37 Seiten zu Widgets.
  • Terminal.Gui: Die Übersicht der Views hat 71 Einträge, darunter generische Varianten und Basisklassen. Das Projekt selbst spricht von mehr als 50. Dazu gehören Dinge, die Textual nicht mitbringt, etwa Dateidialoge, ein Assistent mit mehreren Schritten, eine Hex-Ansicht und eine Menüleiste.

Bei der Zahl der fertigen Bedienelemente liegt also Terminal.Gui vorn und nicht Textual.

Was macht Textual besonders?

Innerhalb dieser drei hat nur Textual:

  • CSS. Aussehen und Anordnung stehen in einer eigenen Sprache mit Selektoren, getrennt vom Programmcode.
  • Eine eigene Schnittstelle für asynchrone Tasks. Die Worker gibt es seit Version 0.18.0.
  • Eine eingebaute Command Palette. Das ist ein Suchfeld, das mit Strg+P aufgeht und alle Befehle der Anwendung anbietet, wie in Visual Studio Code.
  • Den unveränderten Betrieb im Browser. Mit textual-serve startet ein Server die Anwendung als Unterprozess und verbindet sie über einen Websocket mit dem Browser.

Es gibt aber einige Features, bei denen die anderen Frameworks genauso gut sind:

  • Einen Baum aus Bedienelementen mit Ereignissen hat Terminal.Gui auch.
    Dort heißen sie Views, mit Kommandos, Tastenbelegungen und Ereignissen.
  • Tests ohne Terminal können alle drei.
    Bei Terminal.Gui lassen sich im Test auch Mausklicks simulieren, und die Uhr stellt der Test selbst weiter, statt auf einen Timer zu warten.
  • In den Browser kommt auch Ratatui.
    Ratzilla übersetzt eine Anwendung nach WebAssembly. Das Beispiel in der README benutzt dafür ein eigenes Backend und einen eigenen Aufruf zum Zeichnen. Ob sich eine bestehende Anwendung ohne Umbau übernehmen lässt, wurde nicht ausprobiert.
    Vorschaukarte des Repos ratatui/ratzilla auf GitHub
    Ratzilla auf GitHub, Stand 11. Oktober 2026.

Dazu kommen in Rust und .NET weitere Libraries, die in dieselbe Richtung gehen:

  • r3bl_tui für Rust nennt in seiner README Flexbox-Anordnung und eine Gestaltung nach Art von CSS (485 Sterne).
  • textual-rs ist ein ausdrücklicher Nachbau von Textual in Rust, mit CSS, Nachrichten und Workern. Das Repo hat 3 Sterne, der letzte Push war im April 2026.
  • tui-realm setzt wiederverwendbare Komponenten nach dem Vorbild von React und Elm auf Ratatui (1.003 Sterne).
  • Cursive ist die zweite größere Bibliothek für Rust (4.856 Sterne). Die letzte Version auf crates.io stammt vom August 2024.
  • Consolonia für .NET bringt Avalonia ins Terminal, ein Toolkit für Desktop-Oberflächen. Die README nennt Styles, Datenbindung und Vorlagen, das Projekt bezeichnet sich selbst als Beta (837 Sterne).

Außerhalb von Python, Rust und .NET gibt es zwei Projekte mit mehr Sternen als Textual:
Bubble Tea für Go mit 45.435 und Ink für JavaScript mit 40.090. Beide wurden hier nicht untersucht.

Mein Zwischenstand:
Ich war ehrlich erstaunt, dass Terminal.Gui so einen Reifegrad hat. Von Ratatui hatte ich mir dagegen mehr erhofft.

Besonders an Textual ist für mich nicht ein einzelnes Feature. CSS gibt es auch anderswo, einen Baum aus Bedienelementen ebenfalls. Was ich in Rust und .NET nicht gefunden habe, ist alles zusammen in einem Paket:
CSS, Worker, Command Palette und der Betrieb im Browser.

Unterstützung durch KI-Modelle

Wie gut ein Modell mit einem Framework umgehen kann, lässt sich nur begrenzt messen. Belegen lassen sich drei Dinge:
was die Projekte für Modelle bereitstellen, wie aktiv sie gepflegt werden, und was beim Build der drei Fassungen passiert ist.

Was die Projekte bereitstellen

Eine Datei llms.txt ist eine Kurzanleitung für Sprachmodelle. Auf den Webseiten der drei Dokumentationen gab es sie am 11. Oktober 2026 nicht, alle drei Adressen antworteten mit 404. In den Repos sieht es verschieden aus:

  • Terminal.Gui hat eine llms.txt mit 405 Zeilen, eine Datei ai-v2-primer.md, dazu AGENTS.md, CLAUDE.md und Regeldateien für weitere Werkzeuge. Ein eigener Ordner enthält eine Anleitung zum Bau von Anwendungen und eine Sammlung von Mustern.
  • Textual hat eine AI_POLICY.md. Sie regelt, unter welchen Bedingungen das Projekt Pull Requests annimmt, die von einer KI stammen. Eine Anleitung für Modelle ist das nicht.
  • Ratatui hat Anweisungen für die Code-Prüfung durch GitHub Copilot. Auch das richtet sich an Beiträge zum Projekt und nicht an jemanden, der eine Anwendung baut.

Der Grund für den Aufwand bei Terminal.Gui steht in der Datei selbst. Version 2 hat eine andere Schnittstelle als Version 1, und die Versionen der Reihe 1 erschienen von April 2021 bis Juni 2025. Die llms.txt beginnt deshalb mit der Aufforderung, Wissen aus der Zeit vor 2025 zu verwerfen, und einer Tabelle „falsch in Version 1, richtig in Version 2“.

Aber Achtung: Auch diese Hilfen sind nicht frei von Widersprüchen. Die llms.txt nennt RadioGroup ausdrücklich als veraltet. Die Übersicht der Bedienelemente, auf die sie als Referenz für Modelle verweist, führt RadioGroup weiterhin auf.

Wie aktiv werden die Projekte gepflegt?

Alle drei Projekte leben. In jedem Repo gab es in den Tagen vor dem 11. Oktober 2026 einen Push, und alle drei haben in den letzten zwölf Monaten Versionen veröffentlicht:

  • Textual: 34 Versionen
  • Terminal.Gui: 25 Versionen, die Vorabversionen nicht mitgezählt
  • Ratatui: 3 Versionen des Hauptpakets, dazu zwei Betas

Aber Achtung:
Viele Updates heißen auch, dass sich die Schnittstelle ändert.

  • Ratatui steht bei 0.30.2 und hat keine Version 1.0 erreicht. Die Liste der Brüche führt für 0.30.0 vom 26. Dezember 2025 fünfzehn Einträge. Das Projekt pflegt dafür eine eigene Datei mit Hinweisen zur Umstellung.
  • Textual hat von 1.0.0 am 12. Dezember 2024 bis 8.0.0 am 16. Februar 2026 acht Hauptversionen veröffentlicht. Der Bruch in 8.0.0 ist laut Änderungsprotokoll eine Umbenennung: Select.BLANK heißt jetzt Select.NULL.
  • Terminal.Gui hat mit Version 2 die Schnittstelle neu gefasst. Auch 2.5.0 enthält nach der eigenen Dokumentation vier geplante Brüche, obwohl es nur ein kleiner Versionssprung ist.

Die Umbenennung bei Textual kenne ich aus der Praxis, sie steht in meinen Notizen als Stolperstelle. Dasselbe gilt für Static:
Den Inhalt liest man in Textual 8.2 über .content, das frühere .renderable gibt es nicht mehr. Ein Modell, das mit älteren Beispielen trainiert wurde, dürfte an solchen Stellen den alten Namen vorschlagen. Gemessen habe ich das nicht.

Was beim Build passiert ist

  • Textual:
    Der erste Entwurf lief ohne Korrektur, alle Tests bestanden.
  • Terminal.Gui:
    Die Anwendung ließ sich beim ersten Versuch übersetzen. Die Tests brauchten zwei fehlende Namensräume, und für die Taste q brauchte es die Korrektur an der Liste. Vor dem Schreiben hatte Claude die llms.txt des Projekts gelesen. Ein Rückfall auf Version 1 kam nicht vor. Wie der Versuch ohne die Datei ausgegangen wäre, wurde nicht geprüft.
  • Ratatui:
    Die Fassung stammt aus einem früheren Durchgang. Ob der erste Entwurf dort Korrekturen brauchte, ist nicht festgehalten.

Das ist ein Versuch je Framework an einer sehr kleinen Anwendung und keine Messung.
Eine Aussage wie „Modelle können Textual besser“ lässt sich daraus nicht ableiten.

Was der Vergleich nicht zeigt

  • Die Anwendung ist sehr klein. Eine Liste mit drei Einträgen sagt nichts über Tabellen mit tausenden Zeilen, über Formulare oder über lange Laufzeiten.
  • Geprüft wurde über Tests. Im echten Terminal liefen die drei Fassungen nur für die Screenshots.
  • Geschwindigkeit und Speicher wurden nicht gemessen.
  • Die Zeilenzahlen hängen an der Formatierung. Rust und C# brauchen Zeilen für Klammern, Python nicht.
  • Beim Deployment unterscheiden sich die drei deutlich. Ratatui ergibt eine einzelne ausführbare Datei. Die Fassung mit Terminal.Gui belegt nach dotnet publish 17 Megabyte in 34 Dateien und braucht die .NET-Laufzeit. Textual braucht Python.
  • Es war ein Rechner mit Windows. Linux und macOS wurden nicht geprüft.
  • Für Textual habe ich Erfahrung aus mehreren Anwendungen, für die beiden anderen nicht. Was an Ratatui und Terminal.Gui im Alltag stört, steht deshalb nicht in diesem Beitrag.

Was ich daraus gelernt habe

Meine Vermutung, dass Textual das beste Framework ist, war zur Hälfte richtig.
Für dieselbe Anwendung brauchte Textual am wenigsten Code, und nur dort kamen Fußzeile, Tastenbelegung und Gestaltung fertig mit.
CSS im Terminal, Worker und Command Palette in einem Paket habe ich bei den beiden anderen nicht gefunden.

Zwei Dinge hatte ich nicht erwartet.
Terminal.Gui bringt mehr fertige Bedienelemente mit als Textual und kümmert sich von den dreien am sichtbarsten um Sprachmodelle.
Und Ratatui ist kein kleineres Textual, sondern etwas anderes:
eine Bibliothek zum Zeichnen, bei der die Anwendung selbst die Schleife in der Hand hat.

Wer in Python zu Hause ist und schnell eine bedienbare Oberfläche für die Konsole braucht, dürfte mit Textual am weitesten kommen.
Für ein einzelnes kleines Programm ohne Laufzeitumgebung spricht einiges für Ratatui.
Wer aus der Welt der Desktop-Oberflächen in .NET kommt, findet sich in Terminal.Gui schnell zurecht. Für meinen C#-Stack werde ich Terminal.Gui in Zukunft verwenden.

Quellen (geprüft am 11.10.2026): Ratatui auf GitHub · Textual auf GitHub · Terminal.Gui auf GitHub · Ratatui auf crates.io · Textual auf pypistats.org · Terminal.Gui auf NuGet · Dokumentation von Textual · Dokumentation von Terminal.Gui · Brüche in Ratatui · llms.txt von Terminal.Gui · textual-serve · Ratzilla

Steht bei Ihnen ein ähnliches Vorhaben an?

Ich unterstütze Sie von der Beratung und Planung über die Umsetzung bis zur Qualitätssicherung.

“Es ist nicht wenig Zeit, die wir haben, sondern viel Zeit, die wir nicht nutzen.”

- Seneca