Deckstride/README.md

5.4 KiB

PDF Presenter icon

PDF Presenter

Your slides on the big screen. Your notes and controls with you.

Version Tests Coverage

Download a release · Install and update · User guide · Report an issue

PDF Presenter is a desktop presenter for PDFs and picture folders. Show slides fullscreen on your Slides screens while keeping previews, notes, timers and navigation on your Presenter screens. Rehearse on one monitor, or mirror either view across several displays.

Open source and development

PDF Presenter is open-source software under the MIT license. Its development includes LLM-generated or LLM-assisted work, with human review. It is used in professional settings; supported workflows and current limitations are documented in this repository.

Download, extract, present

Start with the release downloads. Choose a portable package for your computer; no Rust toolchain or separate PDF renderer is needed.

Your computer Download Run after extracting
Windows x86_64 pdf-presenter-portable-x86_64-pc-windows-gnu-v….zip pdf-presenter.exe
Linux x86_64 pdf-presenter-portable-x86_64-unknown-linux-gnu-v….tgz ./pdf-presenter

Releases are currently previews. Windows binaries are unsigned; macOS downloads are not yet available. Test your display setup before using it for a live event. Installation, updates and optional Linux app-menu integration →

Set up your presentation

  1. Open your slides. Choose Menu → Open PDF or Open picture folder, or drop your file/folder onto the presenter. Pictures follow natural filename order.
  2. Choose your screens. In Displays, assign Presenter or Slides to each monitor. Try the arrangement, then keep it or let it revert automatically.
  3. Make room for what matters. In Layout, resize or hide previews and notes, place the timers, and optionally enable slide progress. Save for this project or all projects.
  4. Present. Use arrows or Space to advance. Type a slide number and press Enter to jump. All slides opens a thumbnail browser; B blanks or restores the output.

Opening a document shows the presentation by default. Changing displays or fullscreen preserves whether you have shown or blanked the output. Hide the bars for more space; move the pointer near an edge or right-click to recover them.

Prepared slides are cached for reuse. The presenter shows loading progress, RAM use and an ETA when available; decks larger than the RAM budget use a rolling buffer. Notes can come from the PDF or picture-folder sidecars. Themes and English/French controls are available in Menu. Optional shared slide zoom is available under Menu → Enable page zoom; scroll to zoom, drag to pan, double-click to reset on the current preview or Slides screen.

Import your notes

Open your presentation, then choose Menu → Import notes…, or drop a .txt or .md file onto the presenter window. Review the import and choose Import and save notes. This creates or updates presentation.notes.toml beside presentation.pdf (or Slides.notes.toml beside a picture folder named Slides). Your original notes file and slides stay untouched. Double-click the notes pane to edit a slide later.

TXT: separate slides with a line containing two or more hyphens:

Welcome everyone.
-------
Explain the results.
-------
Thank the audience.

Markdown: start each slide with a top-level # title. Titles are separators; only their body becomes the slide's notes:

# Introduction
Welcome everyone.
# Results
Explain the results.
# Conclusion
Thank the audience.

Sections map to slides in order, starting at slide 1; titles do not select slide numbers. Fewer sections preserve the remaining slides' notes; too many sections reject the import without writing. Empty sections clear a slide's notes. TXT files need no final separator (a final separator creates an empty section). Use UTF-8. Markdown ## subheadings and headings inside fenced code stay in the note; nonblank text before the first # title is rejected. Notes display as plain text. Format details and limits →

Read the user guide →


Development and source builds · Changelog · MIT license · More beffroi tools