pickfit

BrowseProductivity & docs tools

presenterm

A terminal tool that runs slideshow presentations written in markdown, with themes, images, code highlighting and PDF/HTML export.

Tested on Linux

Use it

Linux x86_64

  1. Download the v0.16.1 x86_64 musl release tarball and copy the presenterm binary to ~/.local/bin

    mkdir -p /tmp/pt ~/.local/bin && curl -fsSL -o /tmp/pt/p.tgz https://github.com/mfontanini/presenterm/releases/download/v0.16.1/presenterm-0.16.1-x86_64-unknown-linux-musl.tar.gz && tar -xzf /tmp/pt/p.tgz -C /tmp/pt && find /tmp/pt -name presenterm -type f -exec cp {} ~/.local/bin/presenterm \; && chmod +x ~/.local/bin/presenterm

Check that it works

presenterm --version

The output should contain “presenterm 0.16.1”.

First thing to try

cd /tmp/pt && python3 -c "import zlib,struct;c=lambda t,d:struct.pack('>I',len(d))+t+d+struct.pack('>I',zlib.crc32(t+d));open('img.png','wb').write(b'\x89PNG\r\n\x1a\n'+c(b'IHDR',struct.pack('>IIBBBBB',4,4,8,2,0,0,0))+c(b'IDAT',zlib.compress(b''.join(b'\x00'+b'\xff\x00\x00'*4 for _ in range(4))))+c(b'IEND',b''))" && cat > demo.md <<'EOF'
---
title: Demo Talk
author: Tester
---

Code slide
===

```rust
fn main() {
    println!("hello");
}
```

<!-- end_slide -->

Image slide
===

![](img.png)
EOF
cat > /tmp/pt/tty.py <<'EOF'
import os, pty, sys, select, fcntl, termios, struct, time
pid, fd = pty.fork()
if pid == 0:
    os.execvp(sys.argv[1], sys.argv[1:])
fcntl.ioctl(fd, termios.TIOCSWINSZ, struct.pack('HHHH', 40, 120, 1200, 800))
buf = b''
deadline = time.time() + 60
replies = [(b'\x1b[c', b'\x1b[?62;22c'), (b'\x1b[0c', b'\x1b[?62;22c'), (b'\x1b[16t', b'\x1b[6;20;10t'), (b'\x1b[14t', b'\x1b[4;800;1200t'), (b'\x1b[18t', b'\x1b[8;40;120t'), (b'\x1b[6n', b'\x1b[1;1R')]
while time.time() < deadline:
    r, _, _ = select.select([fd], [], [], 0.5)
    if not r:
        continue
    try:
        d = os.read(fd, 65536)
    except OSError:
        break
    if not d:
        break
    buf += d
    for q, a in replies:
        if q in d:
            os.write(fd, a)
_, st = os.waitpid(pid, 0)
sys.stderr.write('QUERIES:' + repr(buf[:400]) + '\n')
sys.exit(os.waitstatus_to_exitcode(st))
EOF
cd /tmp/pt && mv tty.py ptydrv.py && rm -f demo.html && python3 ptydrv.py presenterm --image-protocol ascii-blocks --export-html --theme light demo.md && grep -o -E 'Demo Talk|hello|fn main|<img|data:image/png;base64|background-color:[^;"]*' demo.html

Run presenterm <file>.md in a terminal to present a markdown slide file.

What it does

  • Show images and animated GIFs in slides
    How to use it
    1. Add an image to a slide in your markdown file with ![](<image file>).
    2. Run presenterm --image-protocol ascii-blocks --export-html --theme light <file>.md to render the slides with the image included.
    Tested
  • Customize themes with colors and layouts
    How to use it
    1. Pick a theme with the --theme flag, for example presenterm --image-protocol ascii-blocks --export-html --theme dark <file>.md.
    2. Use --theme light instead for a light color scheme.
    Tested
  • Highlight code in many languages
    How to use it
    1. Put code in a fenced block with a language name, such as ```rust, in your markdown file.
    2. Run presenterm --image-protocol ascii-blocks --export-html --theme dark <file>.md to get the code shown with syntax colors.
    Tested
  • Export presentations to PDF and HTML
    How to use it
    1. Run presenterm --image-protocol ascii-blocks --export-html --theme light <file>.md.
    2. Open the HTML file with the same name as your markdown file, created next to it.
    Tested

How far pickfit got

Linux x86_64

  1. Installs
  2. Starts
  3. 4 of 4 features work
  4. Works offline

macOS and Windows: the project says it runs there; pickfit hasn’t tried it.

Good for

  • give a presentation from the terminal using markdown slides
  • export a presentation to PDF or HTML

How pickfit tested it

Each run starts from a clean machine and follows the steps above. How pickfit verifies

Linux x86_64

Its main function works

  • Replayed from scratch
  • Works offline
  • Checked on 15 Nov 2026
  • Version presenterm 0.16.1

Differences the test machine hit

  • README: Install via cargo binstall / cargo install / pacman / nix
    In the test: The install guide's recommended pre-built binary from GitHub releases (presenterm-0.16.1-x86_64-unknown-linux-musl.tar.gz) works without Rust; cargo, pacman and nix are not available in this box
  • README: presenterm --export-html <file> (no terminal requirements mentioned)
    In the test: Exporting needs a real terminal: without a tty it fails with 'Not a tty (os error 25)', and under a bare `script` pty it hangs waiting for replies to terminal capability queries (kitty graphics, DA1, cursor position). A small Python pty driver that answers those queries made it work. --image-protoc…
  • README: Export presentations to PDF
    In the test: PDF export needs weasyprint and its system library libpango-1.0-0. `uv tool install weasyprint` worked, but weasyprint cannot load libpango here (it needs apt/root), so presenterm said 'weasyprint not found'

How to read a tool card

Stitching
pickfit installed this tool itself. Everything under the stitches comes from that run. A tool pickfit has not run never gets stitches.
Verified on your OS
The install steps ran on the system you chose. “Ran on Linux only” means it has not been run on yours yet.
macOS, Linux and WindowsWhere it ran
Green OS marks: pickfit ran the install steps there. Grey ones: the README says it runs there, and pickfit has not tried.
How far the run got
Installs and starts, its main function works, its service answers, it produces model output. A window means a desktop app opened; a plug, an MCP client used it. The mark sits beside the run’s result, under “Why it fits and how we know” and in “How pickfit tested it”.
Visual check
pickfit looked at screenshots of the app. Green: it looks right. Amber with a number: things that look wrong; open it to see them. Grey and dashed: not checked yet.
Known vulnerabilities
Known high or critical vulnerabilities (OSV.dev) in what it installs. Green: none known. Red with a number: how many; open it for the list, and read it before you install. Grey and dashed: not checked, which does not mean safe.
About the run
The day it ran, and the version that ran.
Source of a reason
Every reason a pick fits rests on one profile field. Open the reason to see the field and the value it relies on.
Hidden gem
High quality, little known.
Quality and popularity
Two scores out of 100. Quality: how well it installed and worked when pickfit tried it, and how good its install docs and upkeep are. Popularity: from stars, downloads and Hacker News.
Features checked
Of the main features the README advertises, how many the run actually exercised (green), and how many failed (red). Grey ones were not checked, and the card says why.
Not verified
A well-known tool Fitz mentions from general knowledge. No run record, no steps, no score.