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
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 --versionThe 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
===

EOFcat > /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))
EOFcd /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.htmlRun presenterm <file>.md in a terminal to present a markdown slide file.
What it does
- Show images and animated GIFs in slidesTested
How to use it
- Add an image to a slide in your markdown file with
. - Run
presenterm --image-protocol ascii-blocks --export-html --theme light <file>.mdto render the slides with the image included.
- Add an image to a slide in your markdown file with
- Customize themes with colors and layoutsTested
How to use it
- Pick a theme with the
--themeflag, for examplepresenterm --image-protocol ascii-blocks --export-html --theme dark <file>.md. - Use
--theme lightinstead for a light color scheme.
- Pick a theme with the
- Highlight code in many languagesTested
How to use it
- Put code in a fenced block with a language name, such as ```rust, in your markdown file.
- Run
presenterm --image-protocol ascii-blocks --export-html --theme dark <file>.mdto get the code shown with syntax colors.
- Export presentations to PDF and HTMLTested
How to use it
- Run
presenterm --image-protocol ascii-blocks --export-html --theme light <file>.md. - Open the HTML file with the same name as your markdown file, created next to it.
- Run
How far pickfit got
Linux x86_64
- Installs
- Starts
- 4 of 4 features work
- 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'