Mac Apps

Confused by the command line? Get more user-friendly Terminal explanations, with tldr

The Terminal is one of macOS’ most powerful and versatile utilities, but with over 1,400 commands to choose from, even if you use the Terminal on a day-to-day basis, it’s unlikely that you’ll be able to memorise all the Terminal commands.

Regardless of whether you’ve encountered a command for the first time, or just need a refresher about a Terminal command you haven’t used in a while, one option is to turn to macOS’ built-in manual for help. Simply type ‘man’ (short for manual) into the Terminal, followed by the command you’re unsure about, and the Terminal will display all the information it has about this command.

The catch is that macOS’ manual isn’t particularly user-friendly (especially if you’re confused about a command to begin with!) and tends to display every single piece of information that it has about a particular command, which can be overwhelming. For example, here’s the manual entry for the ‘cd’ (“change directory”) Terminal command:

If you’ve ever read a command’s manual entry and are still unsure about what this command actually does, then you’re not alone, as macOS’ less-than-clear explanations have resulted in the creation of tldr (Too Long; Didn’t Read); an entire project dedicated to providing a more human-readable version of macOS’ manual.

Let’s compare macOS’ ‘cd’ definition, with the tldr version:

This is much easier to understand, and although it isn’t as thorough as the manual explanation, once you’ve grasped the fundamentals you can always turn to the macOS manual for more detailed information.

In this article, I’ll show you how to access a more concise, human-readable definition of every Terminal command, by installing tldr on your Mac.

Installing and using tldr

The easiest way to install tldr is to use the Homebrew package manager, so if you don’t already have Homebrew installed, then you’ll need to install it:

  • Open a new ‘Finder’ window.
  • Navigate to ‘Applications > Utilities > Terminal.’
  • Enter the following command into the Terminal window:

xcode-select –install

  • Press the ‘Enter’ key on your keyboard.
  • Type the following command into the Terminal, and then press the ‘Enter’ key:

ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

  • Read the onscreen information, and if you’re happy to process, then press ‘Enter’ again.
  • When prompted, enter your password. Homebrew will now be installed.

As soon as Homebrew is installed, you can download, build and install tldr, simply by running the following command in the Terminal:

brew install tldr

Once tldr is installed, you can view a more concise, user-friendly explanation for any Terminal command, by typing “tldr” into the Terminal window, followed by the command you’re unsure about. For example, if you wanted more information about the “sudo” command, then you’d need to enter the following: tldr sudo

Don’t want to install tldr?

If you like the sound of tldr but don’t particularly want to install another piece of software, then it’s possible to access tldr as a web application. Simply head over to tldr’s dedicated website and search for the command that you want to learn more about, and the web application will display tldr’s definition for that command – with no installation required.

About the author

Chris

I've been a passionate evangelist for Apple and the Macintosh throughout my working life, my first love was a Quadra 605 working with a small creative agency in the south of Norfolk UK in the mid 1990's, I later progressed to other roles in other Macintosh dominated industries, first as a Senior graphic designer at a small printing company and then a production manager at Guardian Media Group. As the publishing and printing sector wained I moved into Internet Marketing and in 2006 co-founded blurtit.com which grew to become one the top 200 visited sites in the US (according to Quantcast), at its peak receiving over 15 million visits per month. For the last ten years I have worked as an Affiliate and Consultant to many different business and start ups, my key skill set being online marketing, on page monetisation, landing page optimisation and traffic generation, if you would like to hire me or discuss your current project please reach out to me here.

You can also follow me on: and

Add Comment

Click here to post a comment

Leave a Reply

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