Terminal- und CLI-Demos aufnehmen, denen man wirklich folgen kann

Terminal-Demos gehören zu den nützlichsten Videos, die Entwicklerinnen und Entwickler erstellen können. Und zu den anstrengendsten zum Anschauen. Winzige Monospace-Schrift, eine Wand aus scrollendem Output, ein Befehl, der oben aus dem Bild verschwindet, bevor ihn jemand lesen konnte – und nach zwei Minuten steigen die Zuschauer aus.

Die Lösung liegt fast vollständig in der Vorbereitung. Eine Terminal-Aufnahme, die funktioniert, entsteht vor dem Klick auf „Aufnehmen”, nicht in der Rettungsaktion danach. Hier ist der komplette Ablauf.

Warum Terminal-Aufnahmen schwer zu lesen sind

Bildschirmaufnahmen einer grafischen Oberfläche haben visuelle Ankerpunkte: Buttons, Icons, Layout. Ein Terminal hat davon nichts. Alles ist gleich groß, gleich farbig, und es bewegt sich schnell. Die Probleme sind immer dieselben:

• Zu kleine Schrift: Eine Schriftgröße, die auf Armlänge angenehm ist, wird in einem 1080p-Video in einem kleinen Fenster unlesbar
• Themes mit wenig Kontrast: Gedecktes Grau auf fast Schwarz sieht auf dem Monitor edel aus und verschwindet nach der Videokompression
• Output, der vorbeiscrollt: Die entscheidende Zeile rauscht durch, während Sie noch über den Befehl sprechen
• Unsichtbare Eingaben: Zuschauer sehen Ihre Tastenanschläge nicht, ein schnell getipptes Flag wirkt wie Zauberei
• Leerlauf: Installationen, Builds und Testsuiten produzieren dreißig Sekunden, in denen nichts passiert

Für jedes dieser Probleme gibt es eine Lösung, die keine fünf Minuten kostet.

Das Terminal vor der Aufnahme einrichten

Behandeln Sie Ihr Demo-Terminal als eigene Umgebung, getrennt vom Arbeitsterminal. Die meisten Terminal-Apps unterstützen Profile – legen Sie eines namens „Recording” an und konfigurieren Sie es einmal.

• Schriftgröße 18–24 pt: Ungefähr doppelt so groß wie üblich. Wenn es auf Ihrem Monitor absurd aussieht, ist es fürs Video vermutlich richtig
• Theme mit hohem Kontrast: Helle Schrift auf einheitlich dunklem Hintergrund. Verzichten Sie ganz auf Transparenz und Hintergrundbilder – beides komprimiert schlecht und erzeugt visuelles Rauschen
• Fenstergröße statt Vollbild: Ein übergroßes Vollbild-Terminal lässt den Text im Verhältnis zum Bild schrumpfen. Ein Fenster mit etwa 90–100 Spalten füllt ein 16:9-Bild angenehm
• Ligaturen abschalten, wenn sie verwirren: Hübsche Pfeilglyphen für -> und != irritieren alle, die Ihre Befehle abtippen wollen
• Zeilenabstand leicht erhöhen: Ein wenig Luft macht dichten Output deutlich übersichtlicher

Die Shell aufräumen

Prompt und History verraten mehr, als Sie denken. Vor der Aufnahme:

• Prompt vereinfachen: Ein langer Prompt mit Git-Branch, Node-Version, Zeitstempel und zweizeiligem Pfad frisst Breite und lenkt ab. Ein kurzes ~/project $ ist ideal
• Benutzernamen und Hostnamen ausblenden: Beide identifizieren Sie und Ihre Maschine in einem Video, das Sie vielleicht veröffentlichen
• Scrollback und History leeren: Frühere Befehle können Kundennamen, interne Hostnamen oder unbeteiligte Projekte offenlegen
• Umgebungsvariablen prüfen: env-Output im Video hat mehr API-Keys geleakt als jeder Code-Schnipsel
• Ein Wegwerf-Verzeichnis nutzen: Ein sauberer Projektordner verhindert fremde Dateien in der ls-Ausgabe
• Benachrichtigungen deaktivieren: Terminal-Glocke und Desktop-Popups zerstören beide eine Aufnahme

Wenn Ihre Demo echte Zugangsdaten berührt, arbeiten Sie mit Dummy-Werten. Nachträgliches Unkenntlichmachen ist deutlich mehr Arbeit, als vorab API_KEY=demo-key-1234 zu setzen.

Die Befehlsabfolge planen

Schreiben Sie Ihre Befehle vor der Aufnahme auf – in eine Notizdatei, nicht ins Gedächtnis. Ein kurzes Skript mit genau dem, was Sie in welcher Reihenfolge tippen, leistet dreierlei: Es verhindert Tippfehler unter Druck, hält die Demo auf einer Linie und ist gleichzeitig die Gliederung Ihrer Erzählung.

Gehen Sie das Ganze dann einmal komplett durch, ohne aufzunehmen. So kommen die Überraschungen ans Licht: ein bereits warmer Cache, eine fehlende Abhängigkeit, eine Rückfrage, die Sie vergessen hatten. Setzen Sie das Verzeichnis anschließend zurück, damit der aufgezeichnete Durchlauf im gleichen Zustand startet.

Aufnahmeeinstellungen für Terminal-Arbeit

Terminal-Inhalte sind größtenteils statischer Text – in mancher Hinsicht nachsichtig, in anderer anspruchsvoll.

• Fenster statt gesamten Bildschirm erfassen: Fensteraufnahme hält den Bildausschnitt eng am Terminal und blendet den Rest des Desktops aus
• 30 fps reichen völlig: Text braucht keine 60 fps. Niedrigere Bildraten bedeuten bei gleicher Bitrate außerdem schärfere Schrift
• In der nativen Auflösung des Displays aufnehmen: Text nachträglich hochzuskalieren ist die Ursache für unscharfe Ergebnisse
• Webcam weglassen oder klein halten: In einer Terminal-Demo ist der Output das Thema. Ein großes Bild-im-Bild verdeckt die untere Ecke – genau dort, wo neuer Output erscheint

Das Tempo: Was die meisten falsch machen

Der Rhythmus einer guten Terminal-Demo ist nicht der Rhythmus Ihrer Arbeit.

1. Sagen Sie, was Sie gleich tun, bevor Sie tippen: „Jetzt installiere ich die CLI global”
2. Tippen Sie gleichmäßig und bewusst – langsamer als sonst, aber nicht künstlich langsam
3. Halten Sie vor der Eingabetaste kurz inne, damit der vollständige Befehl sichtbar und lesbar ist
4. Schweigen Sie, während der Output erscheint, und sprechen Sie danach darüber
5. Zeigen Sie auf das Wesentliche, statt die gesamte Ausgabe vorzulesen

Lange Befehle können Sie in zwei sichtbaren Schritten tippen – erst der Basisbefehl, dann die Flags – und dabei erklären, was jedes Flag bewirkt. Das ist viel leichter zu verfolgen als eine vierzig Zeichen lange Zeile, die auf einen Schlag dasteht.

Lang laufende Befehle handhaben

Niemand möchte einem neunzig Sekunden langen npm install zusehen. Sie haben drei gute Optionen:

• Speed-Ramping: Der Befehl bleibt sichtbar, die Wartezeit läuft in 4- bis 10-facher Geschwindigkeit – man sieht, dass es passiert ist, ohne es auszusitzen
• Wartezeit herausschneiden: Vom Start des Befehls bis kurz vor das Ergebnis schneiden. Auf einer Prompt-Zeile geschnitten, ist der Schnitt unsichtbar
• Cache vorwärmen: Den Befehl vor der Aufnahme einmal laufen lassen, dann ist er im Take in wenigen Sekunden durch

Sagen Sie in jedem Fall laut, wie lange es tatsächlich dauert – „das läuft normalerweise etwa zwei Minuten” – damit niemand überrascht wird, der es selbst ausprobiert.

Output im Editor lesbar machen

Im Schnitt wird aus einer soliden Terminal-Aufnahme eine gute.

• Auf wichtigen Output zoomen: Ein Zoom auf die drei entscheidenden Zeilen wirkt deutlich besser, als die Zuschauer auf einen Bildschirm voller Logs blinzeln zu lassen
• Textoverlays für Schlüsselbefehle: Der Befehl als Einblendung gibt den Zuschauern etwas zu lesen, während Sie erzählen
• Fehlermeldungen annotieren: Wenn Sie bewusst ein Scheitern zeigen, heben Sie die erklärende Zeile hervor
• Kapitel hinzufügen: Installation, Konfiguration, Erster Lauf, Fehlersuche – Terminal-Demos werden mitgemacht, und dafür springt man zurück
• Stille entfernen: Automatische Stilleentfernung strafft die Pausen rund um die Befehle, ohne Ihren Vortrag anzutasten

Terminal mit anderen Fenstern kombinieren

Die wenigsten echten Demos bestehen nur aus dem Terminal. Sie führen einen Befehl aus, prüfen den Browser, bearbeiten eine Konfigurationsdatei.

• Layout vor der Aufnahme festlegen: Terminal und Browser nebeneinander oder Vollbildwechsel – entscheiden Sie sich für eines und bleiben Sie dabei
• Vor dem Fensterwechsel kurz pausieren: Geben Sie den Zuschauern eine halbe Sekunde, den Wechsel zu registrieren, bevor Sie weitersprechen
• Schriftgrößen angleichen: Eine große Terminal-Schrift neben einer winzigen Editor-Schrift macht den Editor unlesbar
• Bereichsaufnahme erwägen: Bei festem Zwei-Fenster-Layout hält die Aufnahme dieses Bereichs den Bildausschnitt über das ganze Video stabil

Checkliste vor der Aufnahme

[ ] Aufnahmeprofil aktiv: große Schrift, kontrastreiches Theme, keine Transparenz
[ ] Prompt vereinfacht, Benutzer- und Hostname ausgeblendet
[ ] Scrollback und History geleert
[ ] Geheimnisse durch Dummy-Werte ersetzt
[ ] Befehlsabfolge notiert und einmal geprobt
[ ] Arbeitsverzeichnis auf sauberen Zustand zurückgesetzt
[ ] Benachrichtigungen und Terminal-Glocke deaktiviert
[ ] Fensteraufnahme gewählt, 30 fps, native Auflösung
[ ] Zehnsekündige Testaufnahme auf Lesbarkeit geprüft

Der letzte Punkt zählt am meisten. Nehmen Sie zehn Sekunden auf, spielen Sie sie in der Größe ab, in der Ihr Publikum sie tatsächlich sieht, und fragen Sie sich, ob der Text bequem lesbar ist. Wenn nicht, Schrift vergrößern und erneut prüfen – bevor Sie sich auf einen zwölfminütigen Take einlassen.

Häufige Fehler

• Vollbildaufnahme auf einem 4K-Display: Der Text wird im exportierten Video mikroskopisch klein
• Ständiges Leeren des Bildschirms: Den Zuschauern geht der Zusammenhang zum eben Gesehenen verloren
• Terminal während der Aufnahme skalieren: Der Text fließt neu um und wirkt sprunghaft
• Output wörtlich vorlesen: Fassen Sie zusammen – „alle zwölf Tests laufen durch”
• Blinkenden Cursor auf einem Standbild stehen lassen: Schneiden Sie diese Ausläufer weg, sie lassen das Video hängen wirken
• Annehmen, dass alle Ihre Aliase kennen: Wenn Sie gs tippen, sagen Sie, dass das git status ist

Fazit

Eine Terminal-Demo steht und fällt mit der Lesbarkeit. Schrift groß, Theme kontrastreich, Prompt aufgeräumt, Abfolge geprobt, und vor jedem Enter ein Takt Pause. Im Editor halten Zoomeffekte und Speed-Ramping die Aufmerksamkeit dort, wo der Output zählt. Dann sind Ihre Kommandozeilen-Walkthroughs nichts mehr, was man erträgt, sondern etwas, das man mitmacht – mit offenem Terminal daneben.