Several years after I started planning it, Man Reader version 2 is now available. This is a major update with a completely new, modern, user interface and it’s available from the Mac App Store.

Buy Man Reader from the Mac App Store

Man Reader is a utility app for reading macOS’s man pages. Man Reader allows quick, convenient and easy access to the man pages on your system, useful for programmers, system administrators and tweakers.

Man Reader 2

Man pages are available for most of the Unix commands used mostly in Terminal or when shell scripting. These man pages are normally displayed in Terminal using the man command.
e.g. man ipconfig gives you the man page for the ipconfig command.

However there are problems with this: the man page is displayed in your Terminal window page by page and you have to press Space to get to the next page. Once you’ve got to the end, you have to know to press ‘q’ to get out of the man page display, at which point it disappears completely. Hope you have a good memory!

There are various tricks to get around this: opening it in a separate window, piping it to Preview as a PDF, listing it as a single page etc, but none of these are really convenient, which is why I wrote Man Reader.

Man Reader searches the most usual directories and assembles a list of the man pages it finds. These commands are listed in the sidebar and you can select any one to display the man page for that command.

If you have other locations you would like Man Reader to search, you can add them using Settings.

Major Features:

  • List the man pages on your system.
  • Show only pages in a selected section.
  • Search for a man page by name.
  • Bookmark your favorite pages.
  • Jump to sub-sections in a page.
  • Live links to ‘See Also’ entries.
  • Search for text within a page.
  • Display man pages in text or HTML (different pages look best in different formats).
  • See and use your History of recently viewed pages.
  • Add your own custom notes to any man page.
  • Choose a font and font sizes for the display.
  • View the app’s custom man page for help.
  • Extensive support for keyboard operations.
  • Open multiple tabs or windows.
  • Add custom search locations.

Man Reader 2 dark mode


Change Log:

Man Reader version 2.0 changes (26 Oct 2022):

  • Complete re-write for modern versions of macOS.
  • Only runs on macOS Sonoma 14.0 or later.
  • Support for tabs and multiple windows.

Man Reader version 1.50 changes (18 Oct 2022):

  • Support for macOS 13 Ventura.
  • Use light or dark system modes instead of custom color schemes.

Man Reader version 1.13 changes (26 May 2021):

  • Add missing links for non-standard man pages.

Man Reader version 1.12 changes (17 May 2021):

  • Fixes issues with crashing on first run and with dark mode over-riding the user preferences.

Man Reader version 1.11 changes (16 May 2021):

  • I am working on a major update to Man Reader, but this is taking longer than expected due to other commitments, so this is an interim release to fix some of the UI problems with the current version.

Man Reader version 1.10 changes (11 May 2018):

  • Fix for possible crash if toolbar apps are not available.

Man Reader version 1.9 changes (27 Nov 2017):

  • Fix for High Sierra problem where page navigation had stopped working.

Man Reader version 1.8 changes (23 Oct 2016):

  • More complete search for man pages, including in third-party IDEs.
  • Fix for glitch when displaying previously selected page on launch.

Man Reader version 1.7 changes (10 Oct 2016):

  • Updated for macOS Sierra.
  • List of pages now uses alternating colors even if not using the defaults.
  • Minimum supported system version raised to 10.11.
  • Minor display glitches fixed.

Man Reader version 1.6 changes (13 Jul 2016):

  • Much improved searching for available man pages, including permissions fix for some pages.
  • Fixed error with new search term being over-written.
  • Sand-boxed version now works just as well as the non-sand-boxed so please switch back to this version.

Man Reader version 1.5 changes:

  • Much improved searching for available man pages.
  • Sand-boxed version now works just as well as the non-sand-boxed.

Man Reader version 1.4 changes:

  • Fix for plain text view not wrapping correctly for odd-sized fonts.
  • Fix for HTML text view over-riding font colors that may be invisible.
  • Search for missing entry (e.g. g++) no longer requires Enter or Return.
  • Better automatic selection of matching entries while searching.
  • Fix for animation warning message appearing in Console.
  • Status display shows when man page list is being updated.
  • Searching inside a page now allows a minimum of 2 characters (was 3), so flags e.g. ‘-b’ do not need to be escaped.
  • Fixed path for Network Utility in tool bar (moved in OS X 10.9).
  • More information available about the effects of sand-boxing for this app.

Man Reader version 1.3 changes:

  • Better formatting of plain text to allow for HTML entities.
  • Fix for font in some HTML pages getting bigger & bigger.
  • Failed search for page will search for a matching man page anyway.
  • Editable apps in toolbar (see Preferences & View menu).
  • Fixed bug when setting custom colors for marker tabs.
  • Changed shortcuts for Find (see Edit menu).

Man Reader version 1.2 changes:

  • Customizable colors for text, background, links, found text.
  • Searching for text within pages marks all matches.
  • Pages will adjust line width to suit window size, even in plain text mode.
  • If a search only results in a single page, press Return to display it.
  • More man pages should be located on your system.
  • Fix for bug where app did not always remember full screen setting.
  • Fix for bug where some pages were being added to the history list twice.

Man Reader version 1.1 changes:

  • Search for text within a man page.
  • Bookmark frequently visited pages.
  • Search man page list using “Starts with” or “Contains”.
  • Preferences for the marker tabs: choose a pre-made color set or design your own.
  • Full screen mode now supported.
  • Custom toolbar configurations now saved & restored correctly.

If you have any problems with Man Reader, any suggestions for future versions or encounter any bugs, please email me or get in touch through the Contact page.