Install pdf.tocgen with Homebrew

Project links

• Homepage
• Repository
• Package manager page

Commands and aliases

• pdftocgen
• pdftocio
• pdfxmeta

Project history

pdf.tocgen was developed as a Python toolset for reconstructing or adding PDF outlines automatically from heading font attributes and positions. It is based on PyMuPDF and MuPDF.

Adoption history

The project supports Linux, macOS, and Windows and is distributed through Python packaging as well as Homebrew and the Arch User Repository. Its workflow is especially suited to software-generated PDFs whose heading fonts and positions remain available for analysis.

How it is used

Use pdfxmeta to create a TOML heading recipe, pipe that recipe into pdftocgen to produce an outline, and pipe the outline into pdftocio to write a new PDF. It is not intended to infer headings reliably from scanned PDFs.

Why package nerds care

Package users encounter three cooperating executables rather than one monolithic command. This separation reflects the Unix philosophy and makes metadata extraction, outline generation, and outline import independently scriptable.

Timeline

• The project adopted a modular three-program workflow consisting of pdfxmeta, pdftocgen, and pdftocio.

Related projects

• The official README identifies PyMuPDF and MuPDF as foundations. It also points to the Emacs toc-mode package as a graphical front end.

Sources

• https://github.com/Krasjet/pdf.tocgen
• https://krasjet.com/voice/pdf.tocgen