Skip to main content

An interactive, command-line presentation tool

Project description

Master Build Status Coverage Status PyPI Statistics Latest Release Documentation Status

Twitter Follow

lookatme

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

TOC

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

lookatme_tour

Embedded terminal example

terminal example

Sourcing external files example

file loader 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.

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

  -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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

lookatme-2.2.0.tar.gz (33.1 kB view details)

Uploaded Source

Built Distribution

lookatme-2.2.0-py3-none-any.whl (39.6 kB view details)

Uploaded Python 3

File details

Details for the file lookatme-2.2.0.tar.gz.

File metadata

  • Download URL: lookatme-2.2.0.tar.gz
  • Upload date:
  • Size: 33.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/50.3.1 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.5

File hashes

Hashes for lookatme-2.2.0.tar.gz
Algorithm Hash digest
SHA256 b82913d7af2fc410664bf7e59ef1bec0be03379e2780d61983d1f421821ec1fe
MD5 3ff589bfa9afbc9eb93e4320e7d25650
BLAKE2b-256 4ae68aa759b06e1b05718de795f71e68ccb77a2214588b94f8be70b287be2768

See more details on using hashes here.

File details

Details for the file lookatme-2.2.0-py3-none-any.whl.

File metadata

  • Download URL: lookatme-2.2.0-py3-none-any.whl
  • Upload date:
  • Size: 39.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/3.2.0 pkginfo/1.6.0 requests/2.24.0 setuptools/50.3.1 requests-toolbelt/0.9.1 tqdm/4.50.2 CPython/3.8.5

File hashes

Hashes for lookatme-2.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 a40760e9e89db040eece35aa64d3640ae26d767082448e9bfdf35e95291e7c8d
MD5 1bdbde877011863f0bf0cd67de0f54fe
BLAKE2b-256 8bbdfaac8400d27385d00cc429350e896514d3834c2e6931f947e5eaaccbd898

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page