Your slides on the big screen. Your notes and controls with you.
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 presentation screens while keeping previews, notes, timers and navigation on your presenter screen. Rehearse on one monitor, or mirror either view across several displays. ## Download, extract, present Start with the [release downloads](https://proxy.dandaedre.com/gitea/idle-org/pdf-presenter/releases). 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 →](docs/user-guide.md#install-and-update) ## 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 Presentation 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 → Preferences → Enable page zoom**; scroll to zoom, drag to pan, double-click to reset on the current preview or presentation 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: ```text 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: ```markdown # 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 →](docs/interfaces/presentation-notes.md#importing-txt-and-markdown) [**Read the user guide →**](docs/user-guide.md) --- [Development and source builds](docs/development/README.md) · [Changelog](docs/changelog.md) · [MIT license](LICENSE) · [More beffroi tools](https://proxy.dandaedre.com/gitea/Beffroi/beffroi-tools)