PitchHut
Log in / Sign up
mangl
11 views
Explore man pages like never before with Mangl's intuitive interface.
Pitch

Mangl is an innovative graphical man page viewer designed for Linux and BSD systems. Leveraging the power of OpenGL and the mandoc library, it provides a smooth, interactive experience with features like clickable hyperlinks, seamless scrolling, and customizable text colors. Discover a new way to browse and search your manuals efficiently.

Description

Mangl is an innovative graphical man page viewer designed for Linux and BSD systems, leveraging the power of the mandoc library to provide a visually enhanced experience. Utilizing OpenGL with GLFW, Mangl allows users to explore man pages with intuitive scrolling and clickable hyperlinks.

Key Features

  • Search Functionality: Effortlessly search through man pages and within individual pages.
  • Hyperlink Navigation: Navigate easily between related man pages through hyperlinks.
  • Browsing History: Keep track of your navigation history.
  • Rich Text Support: Experience colored text and true type font support for better readability.
  • Draggable Scrollbar: Enjoy smooth scrolling through documents for an optimized reading experience.
  • Interactive Controls: Use keyboard and mouse interactions for seamless page navigation.

User Commands

Mangl enhances usability with a variety of keyboard and mouse commands, including:

  • Scroll by one step: j, k, up-arrow, down-arrow
  • Scroll one page: space, shift-space, page-up, page-down
  • Navigate to the beginning or end: gg, G, Home, End
  • Move back to the previous man page: b, escape, right-mouse-click
  • Access the next man page: click on a hyperlink or press f for retrieval.

Configuration

Customize your Mangl experience with settings specified in the ~/.manglrc file. Here’s an example configuration:

font: Anonymous Pro
font_size: 10
gui_scale: 1
line_spacing: 1
line_length: 78
color_background: #151515
color_foreground: #fdfde8
... (additional parameters)

Command Line Usage

Mangl supports various command-line arguments for convenient usage:

mangl                   # Open viewer in search mode
mangl [man page name]   # Open specific man page
mangl [section name] [man page name] # Access man page from a specified section

Enhance your command-line experience with Mangl, where navigating man pages becomes an efficient and enjoyable task!