spread0x / lookatme

An interactive, terminal-based markdown presenter

lookatme

lookatme is an interactive, extensible, terminal-based markdown presentation tool.

TOC

• TOC
• Features
  • Tour
• Navigating the Presentation
• CLI Options
• Known Extensions
• Documentation

Features

• Markdown rendering
• Live (input file modification time watching) and manual reloading
• Live terminals embedded directly in slides
• Syntax highlighting using Pygments
• Loading external files into code blocks
• Support for contrib extensions
• Smart slide splitting

Tour

General tour

Embedded terminal example

Sourcing external files example

Navigating the Presentation

Action	Keys	Notes
Next Slide	l j right space
Prev Slide	h k left delete backspace
Quit	q Q
Terminal Focus	Click on the terminal
Exit Terminal	ctrl+a and then a slide action
Vertically scroll within slide	up/down or page up/page down

CLI Options

Usage: lookatme [OPTIONS] [INPUT_FILES]...

  lookatme - An interactive, terminal-based markdown presentation tool.

  See https://lookatme.readthedocs.io/en/v{{VERSION}} for documentation

Options:
  --debug
  -l, --log PATH
  -t, --theme [dark|light]
  -s, --style [default|emacs|friendly|colorful|autumn|murphy|manni|monokai|perldoc|pastie|borland|trac|native|fruity|bw|vim|vs|tango|rrt|xcode|igor|paraiso-light|paraiso-dark|lovelace|algol|algol_nu|arduino|rainbow_dash|abap|solarized-dark|solarized-light|sas|stata|stata-light|stata-dark|inkpot]
  --dump-styles                   Dump the resolved styles that will be used
                                  with the presentation to stdout

  --live, --live-reload           Watch the input filename for modifications
                                  and automatically reload

  -s, --safe                      Do not load any new extensions specified in
                                  the source markdown. Extensions specified
                                  via env var or -e are still loaded

  --no-ext-warn                   Load new extensions specified in the source
                                  markdown without warning

  -i, --ignore-ext-failure        Ignore load failures of extensions
  -e, --exts TEXT                 A comma-separated list of extension names to
                                  automatically load (LOOKATME_EXTS)

  --single, --one                 Render the source as a single slide
  --version                       Show the version and exit.
  --help                          Show this message and exit.

Known Extensions

Below is a list of known extensions for lookatme:

Extension Name	Install Name	Notes
qrcode	lookatme.contrib.qrcode	Renders QR codes from code blocks
image_ueberzug	lookatme.contrib.image_ueberzug	Renders images with ueberzug (Linux only)
render	lookatme.contrib.render	Renders supported code blocks (graphviz and mermaid-js) by calling an external program. requires an image-rendering extension

Documentation

See the documentation for details.