Skip to content
/ zaman Public

A simple cli tool that prints (or saves) man pages in a PDF file for an easier reading.

License

Notifications You must be signed in to change notification settings

Antiz96/zaman

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Zaman

A simple cli tool that prints (or saves) man pages in a PDF file for an easier reading.

Table of contents

Description

A simple tool that prints (or saves) man pages in a PDF file via Zathura for an easier reading.
It also allows you to navigate through all the man pages available on your system via Rofi or Dmenu.

Installation

AUR

Install the zaman AUR package.
Make sure you also have a zathura PDF backend installed (either zathura-pdf-poppler or zathura-pdf-mupdf) as well as a dynamic menu (either rofi or dmenu).

From Source

Install dependencies:

  • Replace zathura-pdf-poppler by zathura-pdf-mupdf if you prefer to use the mupdf backend.
  • Replace rofi by dmenu if you prefer to use that (it's called suckless-tools on Debian/Ubuntu).

Debian/Ubuntu

sudo apt install man-db groff zathura zathura-pdf-poppler rofi

RedHat/Fedora

sudo dnf install man-db groff groff-perl "perl(Compress::Zlib)" zathura zathura-pdf-poppler rofi

Arch Linux

sudo pacman -S man-db groff zathura zathura-pdf-poppler rofi

Gentoo

sudo emerge man-db groff zathura zathura-pdf-poppler rofi

Download the archive of the latest stable release and extract it (alternatively, you can clone this repository via git).

To install zaman, go into the extracted/cloned directory and run the following command:

sudo make install

To uninstall zaman, go into the extracted/cloned directory and run the following command:

sudo make uninstall

Usage

Run the zaman command in your terminal to display a list of all the available man pages on your system (via Rofi or Dmenu), allowing you to search for the one to print as a PDF.

zaman

Alternatively, you can directly specify the man page to open in the command (example below with the "ls" man page):

zaman_cmd

The man page will open as a PDF file in Zathura. Just press q to quit, as you would normally do when reading a man page: