Was ist tldr?
tldr ist der offizielle Rust-Client für tldr-pages, die von der Community gepflegte Sammlung vereinfachter Manpages: jede Seite besteht aus einer einzeiligen Beschreibung des Befehls und einer Handvoll der Beispiele, die man wirklich tippt. Das Upstream-Projekt heißt tlrc, Paket und Befehl heißen beide tldr. Es ist eine einzige statische Binärdatei ohne Abhängigkeiten, hält die ganze Sammlung in einem lokalen Cache, sodass jede Abfrage sofort und auch offline funktioniert, und frischt diesen Cache von selbst auf, wenn er alt wird. Die Seiten gibt es in Plattform-Varianten (Linux, macOS, Windows, Android, die BSDs) und in Dutzenden Sprachen, Farben und Layout der Ausgabe stehen in einer TOML-Datei, und das Paket bringt die Manpage sowie Vervollständigungen für bash, zsh und fish mit.
tldr ist ein anderes Programm, der Haskell-Client tldr-hs, und Debians tealdeer installiert ebenfalls ein /usr/bin/tldr; keines von beiden ist tlrc, dieses Repository ist also der Weg, den offiziellen Client über apt zu bekommen.
⚡ Hauptfunktionen von tldr
📄 Beispiele zuerst
tldr tar zeigt die acht Arten, wie du tar wirklich benutzt, statt der zweihundert Optionen, die es annimmt. Mehrteilige Befehle funktionieren so, wie du sie tippst: tldr git rebase, tldr docker compose.
⚡ Ein lokaler Cache, keine Anfrage
Der erste Start lädt die ganze Sammlung herunter; jede Abfrage danach ist ein Dateizugriff, die Seite steht also da, bevor der Finger die Eingabetaste verlässt, im Zug oder hinter einem Proxy. Der Cache aktualisiert sich selbst, sobald er älter ist als das eingestellte Alter, oder auf --update.
🖥️ Jede Plattform, ein Befehl
Die Seiten sind nach Plattform geordnet. Standardmäßig bekommst du die Linux-Seite und mit -p macos oder -p windows die für eine Maschine, die gerade nicht vor dir steht.
🌍 Deine Sprache
tldr-pages ist in Dutzende Sprachen übersetzt. tlrc folgt LANG und LANGUAGE und fällt Seite für Seite auf Englisch zurück, oder -L wählt eine Sprache für eine einzelne Abfrage.
🔍 Die Seite finden, die du nicht kennst
--list gibt jeden Seitennamen der aktuellen Plattform aus, --search durchsucht Namen und Beschreibungen, und --info sagt dir, wie alt der Cache ist und welche Sprachen er enthält.
🎨 Ganz nach deiner Konfiguration
Eine config.toml: jede Farbe und jeder Stil der gerenderten Seite, das Cache-Alter vor einer automatischen Aktualisierung, die herunterzuladenden Sprachen, die bevorzugte Plattform und ein Verzeichnis eigener Seiten, das vor dem Cache durchsucht wird.
apt upgrade hält dich auf der neuesten Version.
📦 Installation aus deb.griffo.io
Schritt 1: Repository hinzufügen
sudo install -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | sudo gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | sudo tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
sudo apt updateinstall -d -m 0755 /etc/apt/keyrings
curl -fsSL https://deb.griffo.io/EA0F721D231FDD3A0A17B9AC7808B4DD62C41256.asc | gpg --dearmor --yes -o /etc/apt/keyrings/deb.griffo.io.gpg
echo "deb [signed-by=/etc/apt/keyrings/deb.griffo.io.gpg] https://deb.griffo.io/apt $(lsb_release -sc 2>/dev/null) main" | tee /etc/apt/sources.list.d/deb.griffo.io.list > /dev/null
apt updatesudo apt install extrepo
sudo extrepo enable griffo
sudo apt update🆓 Es gibt einen für immer kostenlosen Spiegel. deb-free.griffo.io liefert Pakete für immer kostenlos — ohne Konto, ohne Abo, höchstens 2 Monate hinter Upstream, Sicherheitsfixes sofort. Derzeit enthält er cliamp, Ghostty, lazydocker, Oh My Posh, Uncloud und Zed; tldr ist nicht dabei, deshalb führt heute nur das Repository oben dorthin — auf Anfrage kann es aufgenommen werden.
🧩 Zur extrepo-Option. extrepo ist Debians eigenes Werkzeug für externe Repositories: Es legt die Sources-Datei an und installiert den Signaturschlüssel für dich, nachdem es ihn gegen signierte Metadaten geprüft hat. Dieses Repository ist dort als griffo registriert, der für immer kostenlose Spiegel als griffo-free. Unter Debian (bookworm, trixie, forky und sid) sind die Befehle oben damit die gesamte Einrichtung.
extrepo richtet nur die Sources-Datei und den Schlüssel ein; die Zugangsdaten eines Abos gehören weiterhin in /etc/apt/auth.conf.d/deb.griffo.io.conf. Ubuntu wird nicht abgedeckt, denn extrepo veröffentlicht Metadaten nur für Debian-Suites: dort nimmst du die Befehle mit sudo oder als root.
Schritt 2: tldr installieren
# Neuestes tldr installieren
# Ist tealdeer installiert, entfernt apt es zuerst: beide Pakete
# legen /usr/bin/tldr in den PATH, dieses hier ersetzt es also
sudo apt install tldr
# Installation prüfen
tldr --version# Neuestes tldr installieren
# Ist tealdeer installiert, entfernt apt es zuerst: beide Pakete
# legen /usr/bin/tldr in den PATH, dieses hier ersetzt es also
apt install tldr
# Installation prüfen
tldr --versionSchritt 3: Der erste Start
# Die erste Abfrage lädt den Seiten-Cache herunter und braucht
# deshalb einmal Internet; alles danach ist lokal
tldr tar
# Den Cache von Hand auffrischen, wann immer du willst
tldr --update
# Wo der Cache liegt, wie alt er ist und welche Sprachen er enthält
tldr --info
# Alle Optionen
tldr --help🎯 Grundlegende Verwendungsbeispiele
Nachschlagen:
# Die Seite zu einem Befehl
tldr tar
# Unterbefehle, so geschrieben, wie du sie tippen würdest
tldr git rebase
# Eine Seite für eine andere Plattform
tldr -p macos brew
tldr -p windows choco
# Eine Seite in einer anderen Sprache, für eine Abfrage
tldr -L de tar
# Jeder Seitenname dieser Plattform, und eine Suche durch
# Namen und Beschreibungen, wenn du den Befehl nicht kennst
tldr --list
tldr --search "compress"Die Ausgabe formen:
# Rohes Markdown, zum Weiterleiten an etwas anderes
tldr -R tar
# Leerzeilen weglassen auf einem kleinen Terminal
tldr --compact tar
# Keine Farben, für Logs und Skripte
tldr --color never tar
# Nie das Netz anfassen, auch wenn der Cache veraltet ist
tldr --offline tar
# Eine Seite rendern, die du schreibst, bevor du sie upstream schickst
tldr -r my-command.mdEs zu deinem machen:
# Woher die Konfiguration gelesen wird, und ein Standard zum Anfangen
tldr --config-path
mkdir -p "$(dirname "$(tldr --config-path)")"
tldr --gen-config > "$(tldr --config-path)"
# Dann in der config.toml: Cache-Alter vor einer automatischen
# Aktualisierung, die zu behaltenden Sprachen, die bevorzugte
# Plattform und die Farben jedes Teils einer Seite
# Den Cache löschen, falls ein Download schiefging
tldr --clean-cache🔧 Werkzeug-Integrationen
tldr ist ein Nachschlagewerk und passt deshalb neben die Werkzeuge, die du schon benutzt:
- Deine Shell: das Paket installiert Vervollständigungen für bash, zsh und fish,
tldr gi<tab>ergänzt also Seitennamen aus dem Cache, undman tldrgibt es für den Client selbst - fzf:
tldr --list | fzf | xargs tldrist ein unscharfer Seitenwähler in einer Zeile, und die--raw-Ausgabe füttert das Vorschaufenster - Eine Seite korrigieren:
tldr --edit targibt einen Link aus, der die Seite im GitHub-Web-Editor öffnet, eine Korrektur ist also nur einen Pull Request entfernt - man: tldr ersetzt das Handbuch nicht, es ist das, was man zuerst liest; die ganze Seite ist ein
manentfernt, sobald du weißt, welche Option du willst - Skripte und Doku:
--color neverund--rawmachen die Ausgabe sicher zum Einfügen in ein README, ein Ticket oder ein Log
🚀 Warum deb.griffo.io?
- Offizielles Debian:
apt install tldrliefert tldr-hs, den Haskell-Client, undtealdeerist ein weiterer Rust-Client mit demselben Befehlsnamen; keiner von beiden ist das offizielle tlrc - Selbst aus dem Quelltext bauen: aktuell, aber eine Rust-Toolchain auf jeder Maschine und eine Binärdatei, von der apt nichts weiß
- Das Upstream-Release-Archiv: dieselbe statische Binärdatei, aber von Hand in den PATH entpackt, ohne Vervollständigungen, ohne Manpage und ohne Updates
- deb.griffo.io: neueste Version mit automatischen Updates
- ✅ Der offizielle Client: tlrc, der Client, den das tldr-pages-Projekt selbst pflegt, keine der vielen Neuimplementierungen
- ✅ Der Befehl heißt tldr: das Paket heißt tldr, weil der Befehl so heißt, und es kollidiert mit
tealdeerund ersetzt es, sodass es nie einen Streit um/usr/bin/tldrgibt - ✅ Automatische Updates: Pakete werden innerhalb von Stunden nach dem Upstream-Release aktualisiert, und der Seiten-Cache aktualisiert sich obendrein selbst
- ✅ Vollständiges Paket: die Binärdatei, die Manpage und die Vervollständigungen für bash, zsh und fish
- ✅ Keine Abhängigkeiten: eine statisch gelinkte musl-Binärdatei, nichts anderes wird mitgezogen
- ✅ Zwei Architekturen: amd64 und arm64, dieselbe statische Binärdatei auf jeder Suite
- ✅ Multi-Distribution: läuft auf Debian 13 (trixie) oder neuer: Trixie, Forky und Sid
- ✅ Einfache Wartung: Updates mit den üblichen apt-Befehlen
📦 Paket-Build-Repository
Die Debian-Pakete werden in diesem GitHub-Repository automatisch gebaut und gepflegt:
- 📖 tldr-debian - Builds der neuesten Releases
🔗 Verwandte Pakete
Ebenfalls verfügbar über deb.griffo.io:
- fzf Fuzzy Finder - Macht aus
tldr --listeinen interaktiven Seitenwähler - ripgrep - Das Suchwerkzeug, dessen eigene tldr-Seite du als Erstes liest
- eza - Modernes ls, noch ein Befehl mit deutlich weniger Optionen zum Merken
- zoxide - Ein schlaueres cd für die Shell, in der du die Seiten liest