|
|
||
|---|---|---|
| .gitignore | ||
| AGENTS.md | ||
| LICENSE | ||
| README.md | ||
| exporter.py | ||
| pptx_videos.py | ||
| test_exporter.py | ||
README.md
beffroi-tools
Beffroi tools, for everyday usage
PPTX video reports
Extract videos and create a Markdown timing report:
python pptx_videos.py presentation.pptx
Generate one or more report formats without keeping newly extracted videos:
python pptx_videos.py presentation.pptx --timings-only --report html,pdf
python pptx_videos.py presentation.pptx --report html,typst,pdf,md,txt,json
--report accepts comma-separated formats and can be repeated. Markdown is the
default. Reports are saved as timings.* in <presentation-stem>_videos, or the
directory supplied with -o. PDF uses the Typst CLI and retains timings.typ
for editing. HTML and Typst/PDF include colored summary cards and pills;
Markdown and TXT use aligned tables. JSON includes numeric durations in seconds,
sizes in bytes, and slide references.
Timings require ffprobe (from FFmpeg); PDF additionally requires typst on
PATH. Use --extract-only to extract without a report. Presentations with no
embedded videos produce no output. Terminal progress uses colors automatically;
set NO_COLOR to disable them.
Export presentations and PDF pages
python exporter.py presentation.pptx --output pdf,images
python exporter.py document.pdf --output images
python exporter.py presentation.pptx --output images --dpi 192 -d exports
exporter.py uses DeckCraft for PPTX exports and PdfCraft for PDF page rendering.
It finds deckcraft-cli / pdfcraft-cli on PATH, or temporarily extracts the
bundled CLI from the newest matching AppImage in ~/Applications. You can
specify a CLI executable or AppImage with --deckcraft-cli / --pdfcraft-cli,
or the DECKCRAFT_CLI / PDFCRAFT_CLI environment variables.
Output goes to <file-stem>_export/: <file-stem>.pdf and/or numbered PNGs
inside images/. Images default to 144 DPI. Existing output requires
--overwrite, which replaces generated files and removes stale numbered
slide/page PNGs. PDF-to-PDF is a successful no-op; other input extensions are
errors. Rendering completes in temporary storage before output is copied.