Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1,133 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

GitHub Release

WinPrint

A modern take on the classic source code printing app from 1988.

Advanced source code, html, markdown, and text file printing for terminals (all platforms) and Windows/macOS GUIs.

Features

  • Beautifully Prints:
    • Source code in hundreds of programming languages with syntax highlighting and line numbering.
    • HTML files.
    • Markdown files as formatted documents (headings, lists, blockquotes, code blocks, mermaid diagrams, and inline images).
    • ANSI-encoded text and colorized console captures (.ans/.ansi), decoding ANSI escape sequences to color.
  • Saves trees printing "multiple-pages-up" on one piece of paper.
  • Complete control over page formatting options, including headers and footers, margins, fonts, page orientation, etc.
  • Headers and Footers support detailed file and print information macros with rich date/time formatting.
  • Sheet Definitions make it easy to save settings for frequent print jobs.
  • Accurate print preview in the GUI and TUI.
  • wp provides a rich command line interface (CLI) on Windows, macOs, and Linux

Terminal UI (wp)

wp TUI — sixel print preview

The wp terminal UI renders true print previews as sixel/kitty graphics, without leaving the terminal: page through a document, zoom in, pan with the mouse, switch sheet definitions, and open another file.

Windows GUI

WinPrint GUI on Windows

MacOS GUI

WinPrint GUI on macOS

How to turn Markdown into a PDF

One command, every platform. Markdown goes in; a formatted, paginated PDF comes out: headings, lists, tables, images, syntax-highlighted code, and ```mermaid fences rendered as real diagrams (fully in-process by default — no network — or via mermaid.ink with the opt-in service backend):

wp print mermaid.md --pdf mermaid.pdf --sheet "Proportional 1-Up"

Prefer a real print queue? Point --printer at any print-to-PDF queue instead:

# Windows — the built-in "Microsoft Print to PDF"
wp print mermaid.md --printer "Microsoft Print to PDF" --sheet "Proportional 1-Up"
# macOS — install a virtual PDF printer once (brew install --cask rwts-pdfwriter), add it in
# Printers & Scanners named "CUPS-PDF"; the PDF lands in /var/spool/pdfwriter/$USER/
wp print mermaid.md --printer "CUPS-PDF" --sheet "Proportional 1-Up"
# Linux — sudo apt install printer-driver-cups-pdf (queue name "PDF" on Debian/Ubuntu;
# confirm with lpstat -p; Fedora is often "Cups-PDF"). PDF lands in ~/PDF/
wp print mermaid.md --printer "PDF" --sheet "Proportional 1-Up"

wp print turning mermaid.md into a PDF, then viewing it

Shown: testfiles/mermaid.md, one fence per mermaid diagram type, printed from the shell and opened in a viewer. The GIF is recorded on Windows; the macOS and Linux commands produce the same PDF. On Linux prefer --pdf when you only need a file — stock cups-pdf may re-encode through Ghostscript; mermaid rasters still survive. Linux & WSL printing.

Installation

Windows

Install with winget — one command gives you both the GUI and the wp terminal UI:

winget install Kindel.WinPrint

Or download the signed installer Kindel.WinPrint-win-x64-Setup.exe from the latest release and run it. (On new releases SmartScreen may say it "isn't commonly downloaded"; that's a reputation check, not a signing problem; the publisher reads Kindel, LLC. See the Installation Guide.)

macOS

brew tap kindel/winprint
brew install winprint          # WinPrint GUI app — also bundles the `wp` terminal UI

Linux

brew install kindel/winprint/wp   # `wp` terminal UI (the GUI is Windows/macOS only)

CUPS setup, cups-pdf, network IPP printers, and WSL notes: Linux & WSL printing.

See the Installation Guide for detailed instructions, prerequisites, and upgrade/uninstall steps.

Getting Started

Launch the TUI:

wp

Launch the GUI on Windows or macOS:

wp gui

You can also find WinPrint in the Start Menu (Windows) or via Spotlight (macOS).

Documentation

Contributing

See CONTRIBUTING.md for development setup, build instructions, and release process.

About

Human and AI Agent friendly print utility with syntax highlighting, markdown support, multiple pages-up, headers/footers. Cross platform (Mac, Linux, Windows) GUI and TUI. Print source code, web pages, and reports generated by legacy systems.

Topics

Resources

Contributing

Security policy

Stars

97 stars

Watchers

2 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages