Skip to main content

A terminal-based presentation tool with colors and effects.

Project description


Documentation Status image image image Run on

A terminal-based presentation tool with colors and effects.

You can also play a codio (pre-recorded code block) on a slide.

present is built on asciimatics, and it works with Python>=3.7.

Check out the gallery to see what everyone is making with present! You can add your slides by simply opening an issue.


You can simply use pip to install present:

$ pip install present


$ present

Some controls:

  • Quit: q
  • Previous slide: b, Left arrow, Page Up
  • Next slide: n, Space bar, Right arrow, Page Down

At the end, you can press r to restart the presentation.


Slides follow Markdown syntax. You can check out the sample slides for reference.

Note: Some things aren't supported yet:

  • Effects and colors on the same slide.
  • Effects and code on the same slide.


Each slide can be separated with a ---.

Slide 1


Slide 2


Level 1 headings become figlets, level 2 headings get underlined with -, and level 3 headings become bold.

# Heading 1

## Heading 2

### Heading 3


This is normal text

This is **bold text**

This is `inline code`

This is a [link](

As Kanye West said:

> We're living the future so
> the present is our past.


Ordered lists become unordered lists automatically.

- Item 1
    - Item 1a
    - Item 1b
    - Item 1c
- Item 2
    - Item 2a


Image paths are relative to the directory where your slides are kept, and where you invoke present.


Note: You can use high resolution images and tweak the terminal font size to get the best results.

Code blocks

import os



Codios are pre-recorded playable code blocks which can be useful for live demos. You can find out how to write one in the codio section of the documentation.



Each slide can be styled with foreground / background colors and effects. By default, slides are black on white with no effects. You can add style to a slide by adding a comment at the beginning of the slide (after the slide separator):

Slide 1

<!-- fg=black bg=yellow -->

Slide 2

<!-- effect=explosions -->

Slide 3

Colors: black, red, green, yellow, blue, magenta, cyan, white.

Effects: fireworks, explosions, stars, matrix, plasma. More coming soon!


The Contributor's Guide has detailed information about contributing issues, documentation, code, and tests.


present uses Semantic Versioning. For the available versions, see the tags on the GitHub repository.


This project is licensed under the Apache License, see the LICENSE file 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

present-0.6.0.tar.gz (13.1 kB view hashes)

Uploaded Source

Built Distribution

present-0.6.0-py3-none-any.whl (16.3 kB view hashes)

Uploaded Python 3

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