Excellent Utilities: tldr – simplified and community-driven man pages

In Operation

Let’s have a look at tldr in operation. Type tldr followed by the command or program you want to learn more about.

When the program is run for the first time, the software updates the cache and creates an index of all the community pages.

In the image below, we show the information for cp, a command used to copy files or group of files or directories.

tldr - cp

As you can see, we’re presented with succinct and pertinent information. Rather than listing every option in alphabetical order as man pages do, the community that maintains the tldr database covers the key options and sorts them with helpful explanatory text with examples.

Sometimes you’ve been browsing the tldr community pages. You can’t remember which specific page you were reviewing but can remember a specific word or phrase. There’s a --search option which searches through the tldr database and displays matches for the search term. In the example below, we’re searching for any page that contains the word nested.

tldr - search

If you like to find out about new commands and programs, there’s a couple of options that show a random command or a random example.

tldr - random command

tldr - random example


The software stores a cache of the community pages on your systems. There’s a few commands to maintain the cache, and to list them.

$ tldr -c – clears the cache.
$ tldr -u – updates the local cache.
$ tldr -l – list all commands in the cache.

Next page: Page 3 – Summary

Pages in this article:
Page 1 – Introduction / Installation
Page 2 – In Operation
Page 3 – Summary

Complete list of articles in this series:

Excellent Utilities
AbricotineMarkdown editor with inline preview functionality
AnanicyShell daemon created to manage processes’ IO and CPU priorities
brootNext gen tree explorer and customizable launcher
cheat.shCommunity driven unified cheat sheet
crocSecurely transfer files and folders from the command-line
DeskreenLive streaming your desktop to a web browser
dufDisk usage utility with more polished presentation than the classic df
exaA turbo-charged alternative to the venerable ls command
Extension ManagerBrowse, install and manage GNOME Shell Extensions
fdWonderful alternative to the venerable find
fkillKill processes quick and easy
fontpreviewQuickly search and preview fonts
horcruxFile splitter with encryption and redundancy
LanguageToolStyle and grammar checker for 30+ languages
Liquid PromptAdaptive prompt for Bash & Zsh
lnavAdvanced log file viewer for the small-scale; great for troubleshooting
lsdLike exa, lsd is a turbo-charged alternative to ls
McFlyNavigate through your bash shell history
mdlessFormatted and highlighted view of Markdown files
OCRmyPDFAdd OCR text layer to scanned PDFs
PaperworkDesigned to simplify the management of your paperwork
PDF Mix ToolPerform common editing operations on PDF files
pecoSimple interactive filtering tool that's remarkably useful
ripgrepRecursively search directories for a regex pattern
scrcpyDisplay and control Android devices
tldrSimplified and community-driven man pages
tmuxA terminal multiplexer that offers a massive boost to your workflow
TuskAn unofficial Evernote client with bags of potential
UlauncherSublime application launcher
WatsonTrack the time spent on projects
Whoogle SearchSelf-hosted and privacy-focused metasearch engine
Share this article


  1. I love tldr. Somewhat surprised it wasn’t included earlier. I found it indispensable when I was starting out. The manual pages are find when you know what you are doing but are a pretty lame introduction.

  2. I always recommend my students consult tldr and cheat.sh before exploring other documentation. Personally I prefer tealdeer, it’s written in Rust, and probably the quickest implementation.

    1. I think you are referring to tealdeer. Like tldr, neither needs a network connection to use it (except to update the cache). I often have an unreliable net connection. the tools get round this issue, I can still keep learning

Share your Thoughts

This site uses Akismet to reduce spam. Learn how your comment data is processed.