Images render nicely on guake but they were spotty on hyper.

python version 3.7.3
WSL/Debian 10

This rocks!

I use big for all of my presentations. I'd love a big mode for this! I think you could do it with resizing figlet fonts.

I have python 3.8.5 installed on macOS Mojave, it looks like present is trying to use the python 3.7 interpreter even though it isn't present.

➜  python --version
Python 3.8.5
➜  pip3 install present
Collecting present
  Using cached present-0.5.0-py3-none-any.whl (15 kB)
Requirement already satisfied: pyfiglet>=0.8.post1 in /usr/local/lib/python3.8/site-packages (from present) (0.8.post1)
Requirement already satisfied: PyYAML>=5.3.1 in /usr/local/lib/python3.7/site-packages (from present) (5.3.1)
Requirement already satisfied: asciimatics>=1.11.0 in /usr/local/lib/python3.8/site-packages (from present) (1.11.0)
Requirement already satisfied: Click>=7.0 in /usr/local/lib/python3.7/site-packages (from present) (7.1.1)
Requirement already satisfied: mistune>=2.0.0a4 in /usr/local/lib/python3.8/site-packages (from present) (2.0.0a4)
Requirement already satisfied: future in /usr/local/lib/python3.7/site-packages (from asciimatics>=1.11.0->present) (0.18.2)
Requirement already satisfied: Pillow>=2.7.0 in /usr/local/lib/python3.7/site-packages (from asciimatics>=1.11.0->present) (7.0.0)
Requirement already satisfied: wcwidth in /usr/local/lib/python3.7/site-packages (from asciimatics>=1.11.0->present) (0.1.8)
Installing collected packages: present
Successfully installed present-0.5.0
➜  present sample.md
zsh: /usr/local/bin/present: bad interpreter: /usr/local/opt/python/bin/python3.7: no such file or directory
➜  ls /usr/local/opt/python/bin | grep python3
python3
python3-config
python3.8
python3.8-config

Better resolution images and tweaking the terminal font size can be used to get the best image rendering results.

Hi @vinayak-mehta ,

Thanks for this nice tool/experiment!

One of the parts that look like legitimate improvements over the state of the art is the codio part. It's quite nice once you have it, but it takes ages to put together.

I was therefore wondering what your thoughts would be on some sort of a conversion mechanism between asciinema's format (https://github.com/asciinema/asciinema/blob/develop/doc/asciicast-v2.md), which seems to be kind of the standard for terminal recording. Or better yet, do you think it would be possible to read in and render the asciicast fileformat the same way the codeio file format is rendered?

Thanks again!

Hi, I was using version 0.3. When I upgraded to the latest version 0.5.1, I would have to re-do my slides since there is a lot more empty space at the top, causing my slide contents at the bottom to no longer be visible. Is there a way I can reduce the amount of empty space at the top?

Similar to how it is being done for bold and underline.

#58 removes the current italic text support as it only works on some OSes.

See attached error

OS: 10.15.6 (19G2021)
Shell: ZSH
Python: 3.8.5

Fade in, fade out, etc.

Can reuse nbcommands code here. Colors could be an issue.

There are many fontfiles available on their website. It should be possible to specify the location of a local fontfile for use in slides.

Emphasis, inline code, links, blockquotes, tables and strikethroughs are not supported right now. If present finds them in a slide, it fails, which is not ideal. It should instead print a warning and ignore the element. For some elements like inline code, it should just convert them to normal text (till they are unsupported).

For a render that can be accessed outside the terminal.

After the first slide (which is fine), I get this:

On macOS & iTerm.

One thing I want in a tool like this is to be able to display ascii charts like from gnuplot, which is why I liked the simplicity of Shellshow. I will have to dig in to see if this is possible, if not I expect it would be easy to add.
— https://news.ycombinator.com/item?id=24325202

Asciimatics supports barcharts: https://asciimatics.readthedocs.io/en/stable/asciimatics.html#asciimatics.renderers.BarChart. Opening this issue to discuss the chart API.

Although the available choices for background color are great, it does not appear there is a way to explicitly specify a transparent background--that is, the terminal's native background.

>present sample.md
Traceback (most recent call last):
  File "c:\python38\lib\runpy.py", line 194, in _run_module_as_main      
    return _run_code(code, main_globals, None,
  File "c:\python38\lib\runpy.py", line 87, in _run_code
    exec(code, run_globals)
  File "C:\Python38\Scripts\present.exe\__main__.py", line 4, in <module>
  File "c:\python38\lib\site-packages\present\cli.py", line 6, in <module>
    from .slideshow import Slideshow
  File "c:\python38\lib\site-packages\present\slideshow.py", line 8, in <module>
    from asciimatics.screen import Screen, _CursesScreen
ImportError: cannot import name '_CursesScreen' from 'asciimatics.screen' (c:\python38\lib\site-packages\asciimatics\screen.py)

_CursesScreen is only UNIX-compatible.
asciimatics also provides the use of _WindowsScreen class can be used instead for Windows-based systems.

Python's native curses doesn't directly support Windows.
We can use this port instead https://pypi.org/project/windows-curses/ for Windows-based systems.

This allows present to run on Windows!

small, medium, large

A speaker notes view with the notes for the current slide, along with the current and next slide views. Looks similar to bpython. Can be opened in a second terminal with the present-notes command (connects to the already running present server and is able to control slides on the first terminal).

As seen in Brandon Rhodes' nbpy 2017 keynote

explosions and stars do this, but matrix works fine.

VT-100 compatible terminals support line-based attributes double-height (DECDHL) and double-width (DECDWL). It'd be useful to support those for headers, perhaps with a command-line switch (since terminal support is spotty and doesn't work at all under tmux/screen).

On xterm:

With Apple's Terminal.App:

first issue - ModuleNotFoundError: No module named 'dataclasses'

$ pip3 install present 
$ present sample.md 
Traceback (most recent call last):
  File "/home/user/.local/bin/present", line 7, in <module>
    from present.cli import cli
  File "/home/user/.local/lib/python3.6/site-packages/present/cli.py", line 7, in <module>
    from .markdown import Markdown
  File "/home/user/.local/lib/python3.6/site-packages/present/markdown.py", line 6, in <module>
    from dataclasses import dataclass
ModuleNotFoundError: No module named 'dataclasses'

resolved, obviously with: pip3 install dataclasses, however shouldn't this be listed in the README as a dependency or automatically installed with requirements.txt or some such?

second issue - ValueError: (Slide 4) BlockQuote is not supported

$ present sample.md 
Traceback (most recent call last):
  File "/home/user/.local/lib/python3.6/site-packages/present/markdown.py", line 251, in parse
    Element = eval(element_name)
  File "<string>", line 1, in <module>
NameError: name 'BlockQuote' is not defined

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/home/user/.local/bin/present", line 11, in <module>
    sys.exit(cli())
  File "/home/user/.local/lib/python3.6/site-packages/click/core.py", line 829, in __call__
    return self.main(*args, **kwargs)
  File "/home/user/.local/lib/python3.6/site-packages/click/core.py", line 782, in main
    rv = self.invoke(ctx)
  File "/home/user/.local/lib/python3.6/site-packages/click/core.py", line 1066, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/home/user/.local/lib/python3.6/site-packages/click/core.py", line 610, in invoke
    return callback(*args, **kwargs)
  File "/home/user/.local/lib/python3.6/site-packages/present/cli.py", line 18, in cli
    slides = markdown.parse(f.read())
  File "/home/user/.local/lib/python3.6/site-packages/present/markdown.py", line 254, in parse
    f"(Slide {sliden + 1}) {element_name} is not supported"
ValueError: (Slide 4) BlockQuote is not supported

I'm hoping for <-- effect=gol --> for a Game of Life simulation. For whatever reason, it comes up in my talks often. It seems I exude geekness acme whenever I talk about hacking and self-propagating code.
— https://news.ycombinator.com/item?id=24325579

Thank you for this fun and interesting project.

I'm hitting an error when using inline code:

Hello `World`

leads to

Traceback (most recent call last):
  File "/home/clemisch/.local/lib/python3.6/site-packages/present/markdown.py", line 242, in parse
    Element = eval(element_name)
  File "<string>", line 1, in <module>
NameError: name 'Codespan' is not defined

During handling of the above exception, another exception occurred:

Traceback (most recent call last):
  File "/home/clemisch/.local/bin/present", line 8, in <module>
    sys.exit(cli())
  File "/home/clemisch/.local/lib/python3.6/site-packages/click/core.py", line 764, in __call__
    return self.main(*args, **kwargs)
  File "/home/clemisch/.local/lib/python3.6/site-packages/click/core.py", line 717, in main
    rv = self.invoke(ctx)
  File "/home/clemisch/.local/lib/python3.6/site-packages/click/core.py", line 956, in invoke
    return ctx.invoke(self.callback, **ctx.params)
  File "/home/clemisch/.local/lib/python3.6/site-packages/click/core.py", line 555, in invoke
    return callback(*args, **kwargs)
  File "/home/clemisch/.local/lib/python3.6/site-packages/present/cli.py", line 18, in cli
    slides = markdown.parse(f.read())
  File "/home/clemisch/.local/lib/python3.6/site-packages/present/markdown.py", line 245, in parse
    f"(Slide {sliden + 1}) {element_name} is not supported"
ValueError: (Slide 1) Codespan is not supported

#20 implements this, opening this issue for some discussion.

Demo:

Color:

Progress bar:

Render single elements on a slide using (y1 + y2) / 2 instead of y1 because the element tends to lie more into the second half of the slide.

It would be nice to do this with pyinotify or watchdog; or maybe just pressing 'r'.