kartoffelchipss/beamside repository overview

⁠Beamside

⁠What it does

Beamer can put speaker notes next to or below each slide in the PDF it compiles. Beamside takes that PDF and splits it up: your audience sees only the slides on the projector, while you see your notes, the current slide and the next one on your own screen.

• Detects automatically whether your notes are on the right, at the bottom, or missing. PDFs without notes work too.
• Opens the slides in a separate window that you move to the projector and show in fullscreen.
• Flexible presenter view with presets and layouts for notes, the current slide and the next slide.
• Presentation timer you can start, pause and reset.
• Laser pointer, pen and eraser to point at or draw on your slides live.
• Keyboard navigation, light and dark theme, English and German.
• Installable as an app and works offline once loaded.

⁠Privacy

Beamside collects no data. There are no accounts, no analytics and no tracking.

Your PDF is never uploaded anywhere. It is opened and rendered entirely in your browser, and it never leaves your computer. The only things Beamside stores are your settings, and those stay in your browser's local storage.

⁠Self hosting

Beamside is a static website, so you can host it yourself. A Docker image for amd64 and arm64 is available as kartoffelchipss/beamside⁠.

With Docker:

docker run -d -p 8080:80 --name beamside --restart unless-stopped kartoffelchipss/beamside:latest

Or with Docker Compose, using the compose.yaml⁠ from this repository:

docker compose up -d

Beamside is then available at http://localhost:8080⁠. Set BEAMSIDE_PORT to use a different port with Compose.

You can also build the image yourself with docker build -t beamside ., or run pnpm build and serve the dist folder with any web server.

⁠License

Beamside is free software, licensed under the GNU General Public License v3.0⁠. You can use, study, share and modify it under the terms of that license.