Skip to content

maxikoehler/labeam

Repository files navigation

LaBeam

Tests Lint Docs License: CC BY-NC-SA 4.0 Python 3.10+ PyPI version

Tool for converting PDF presentations to HTML for easier presenting.

LaBeam turns LaTeX Beamer PDFs into interactive HTML presentations — with a laser pointer, dark mode, table of contents, a full presenter view with notes, and real-time audience synchronisation. Core utilities are:

  • labeam convert for converting a PDF presentation to a cross-plattform presentable HTML file, or
  • labeam host for hosting a PDF presentation with presenter mode.

[!hint]

LaBeam stands for the initial missing laser beam in LaTeX Beamer presentations. Pun intended.

Quickstart

Prerequisites

In order to install and use the package, you need Python >=3.10. The package is tested up to Python 3.14. Additionally you might use uv.

Installation

Clone the repository and install from your local checkout.

Option A — with uv (recommended)

git clone https://github.com/maxikoehler/labeam.git
cd labeam
uv tool install .

Option B — with pip

git clone https://github.com/maxikoehler/labeam.git
cd labeam
pip install .

Verify the installation:

labeam --help

Usage

After that you can

labeam convert <PDF_FILE_PATH> -o <HTML_FILE_PATH>

to convert a PDF to HTML, or simply host a presentation on your local machine via:

labeam host <PDF_FILE_PATH>

Acknowledgements

Thanks to Moritz Weber for sparking the idea and providing a nice and sufficient design to start with :)

About

Tool for converting presentations from pdf to html for easier use.

Resources

License

Contributing

Stars

2 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages