Presenterm: Markdown Slideshows in the Terminal(github.com)
github.com
Presenterm: Markdown Slideshows in the Terminal
https://github.com/mfontanini/presenterm
24 comments
Xterm does this via DEC protocol commands. Well, it does this by specifying double-height, double width, or both. Why does Kitty have to do things its own way yet again?
Maybe cause TTY things are crazy! That mechanism of the computer world is so full of arcane/legacy/defacto "standards"
But how to overhaul? WaylandTYU?
But how to overhaul? WaylandTYU?
Even the old VT220 had large fonts. They were just not used by most applications
Thanks, I was also wondering! I wonder what it would take (politically) to get Konsole to support this (kind of afraid to just file the bug and find out!)
VTE based terminals can't support this AFAIK. Kitty draws itself with OpenGL and so supports these things. Iterm2 is also a similar story afaik (and Wezterm and ....)
What is the benfit of doing this in the terminal over tools such as Slidev or Marp which also allow you to make slides based on Markdown?
- Slidev: https://sli.dev/
- Marp: https://marp.app/
- Slidev: https://sli.dev/
- Marp: https://marp.app/
Lots of people want to demo things on the terminal, having your slides in the terminal as well makes things seamless.
Also some people just like using terminals for all things.
I used Presenterm for a work presentation recently. Being able to seamlessly transition from slides to example code in Vim is really, really nice. No need to jungle multiple windows, just terminal tabs or even ctrl+z/fg. Plus it looks really cool.
The other day I had to conjure a presentation in short order.
I had a few code examples to massage out of a codebase, so I fired up vim to make them simpler/clearer before I'd put them in Keynote.
Then I started taking a few notes in a scratch buffer. After a few moments I began to dread having to move that content over and format in the UI and all.
... And then it dawned on me that I could just use vim itself as the presentation tool!
- one tab per slide, one file per tab
- gt/gT (:tabnext :tabprev) to move through
- ,z (junegunn/goyo :Goyo) for a "hudless" display
- splits and :terminal on live demo time
- ,b (junegunn/fzf.vim :Buffers) to jump to any "slide" on question time (just name files appropriately)
- prepare the whole thing and save session with :mksession
I had a few code examples to massage out of a codebase, so I fired up vim to make them simpler/clearer before I'd put them in Keynote.
Then I started taking a few notes in a scratch buffer. After a few moments I began to dread having to move that content over and format in the UI and all.
... And then it dawned on me that I could just use vim itself as the presentation tool!
- one tab per slide, one file per tab
- gt/gT (:tabnext :tabprev) to move through
- ,z (junegunn/goyo :Goyo) for a "hudless" display
- splits and :terminal on live demo time
- ,b (junegunn/fzf.vim :Buffers) to jump to any "slide" on question time (just name files appropriately)
- prepare the whole thing and save session with :mksession
I wonder what the audience thought - apart from the cool factor.
I made a terminal based presentation tool some years back and like sibling comments said, it was neat for switching back and forth to code samples and output.
Mine wasn't markdown tho: I used ttyrec to record a terminal session to a file per slide and the tool just played it back. I set it up so pressing most keys would advance the playback hackertyper style, advancing 200ms per keypress IIRC. When you reach the end of a slide, press return for the next one. The back and forward arrows were used to jump between slides quickly, and title text was done with figlet.
I only used it for a couple of in house presentations and meetups where the hacker styling was appropriate; there wasn't much to it so the code wasn't released, it'd be easy to recreate.
edited to add: I forgot, I did put it in a gist. https://gist.github.com/bazzargh/a267b97a52f7a1f70c46 ymmv. I recall the playback struggled with things like vim, I always meant to try integrating as cinema since it seems to work better
Mine wasn't markdown tho: I used ttyrec to record a terminal session to a file per slide and the tool just played it back. I set it up so pressing most keys would advance the playback hackertyper style, advancing 200ms per keypress IIRC. When you reach the end of a slide, press return for the next one. The back and forward arrows were used to jump between slides quickly, and title text was done with figlet.
I only used it for a couple of in house presentations and meetups where the hacker styling was appropriate; there wasn't much to it so the code wasn't released, it'd be easy to recreate.
edited to add: I forgot, I did put it in a gist. https://gist.github.com/bazzargh/a267b97a52f7a1f70c46 ymmv. I recall the playback struggled with things like vim, I always meant to try integrating as cinema since it seems to work better
Are either of these related to s5? What's wild is that I've been using zim-wiki -> html -> s5 slides for years, and still do, and I've completely forgotten "how s5 works?" It's just so easy to do things that way over markdown.
I've used both of these a lot, Marp being really easy to get started with and Slidev being a little more complex but well worth the (minor) effort. To me, presenterm doesn't appear to offer any compelling features compared with these.
I’ve used Marp a lot and it’s great. Column layouts and code highlighting are two features Presenterm offers that I don’t think are available in Marp.
marp is rad! kill powerpoint forever by writing markdown slides.
Phenomenal - I've been using patat for this:
https://github.com/jaspervdj/patat
This has in line snippet execution, critical for how I present - so lets switch to this.
https://github.com/jaspervdj/patat
This has in line snippet execution, critical for how I present - so lets switch to this.
Patat looks great, is there a means to export to pdf? Thats one thing I think I need, to be able to share a doc of the slides I present.
I'm giving a talk in June, and it might be fun to do it entirely in the terminal.
Historically, I've done the slides with Markdown and rendered them to Beamer with Pandoc, and that works well enough, though slightly awkward with transitions. I might get more nerd-cred if I live in the terminal.
I'll need to check this one out.
Historically, I've done the slides with Markdown and rendered them to Beamer with Pandoc, and that works well enough, though slightly awkward with transitions. I might get more nerd-cred if I live in the terminal.
I'll need to check this one out.
Alternative https://maaslalani.com/slides/
Speaker notes seem to need an extra step; start an additional terminal on the laptop screen (not the presented screen), then start the speaker notes instance via a terminal command. PowerPoint understands the difference between your own laptop screen and the external output.
Still, good that they thought of including speaker notes, plus this is more flexible in combination with ssh.
Still, good that they thought of including speaker notes, plus this is more flexible in combination with ssh.
[deleted]
Trying to make a presentation right now. In order to render mermaid charts I need to install 'mmdc', or mermaid-cli perhaps -- but this is npm territory and I dont really want to get into the whole node ecosystem, it would be opening a can of worms for sure.
Is this the only support for rendering mermaid in presenterm?
Is this the only support for rendering mermaid in presenterm?
Yes, unfortunately mermaid requires not only node but also a browser instance (!!). I don't like it at all but I don't think there's any alternatives. If you or anyone knows a way of avoiding installing a javascript package to do this please create an issue in the repo!
I wonder what the first incarnation of single-page markdown files for slides has been. The earliest I know of is `tslide` by Dominic Tarr, first published in 2012: https://github.com/tslide/tslide
Vroom goes back to 2008. It generates slides within vim, and it has a wiki syntax, not markdown. https://github.com/ingydotnet/vroom-pm
This looks just so so good. Perfect for my usecase (making presentations for our lab meetings)
Gonna try and convert a few of my old ones to presenterm. I'll let you know how it goes.
Gonna try and convert a few of my old ones to presenterm. I'll let you know how it goes.
With this, I'm going to get the executives living in the shell as much as I do
Ahh very cool. Guess I can say goodbye to Power Point/Keynote/etc.
I wonder how are the large fonts rendered. Are they sixel images or what?
See the sibling comment. This is a new protocol that the kitty maintainer created and is supported as of kitty 0.40.0, which was just released yesterday. This makes presentations look much more presentation-like now!
I've been creating slides with markdown and revealjs for my day job as an instructor for several years. I've also used obsidian and quarto for markdown->slide creation for a handful of meetups / conferences. This month I tried writing a kubecon talk using presenterm and had to throw in the towl after a couple hours of struggling.
It's super cool and I want to love it, but I find it too fiddly to get the layout the way I want it. For me it might be easier to just page through a plain text file of ascii art style diagrams or something.
I've always been just absolutely dog shit at design stuff. I can't center a div to save my life and I don't understand columns. I need it to be absolutely idiot proof because I'm an absolute idiot when it comes to these things.
I guess this is my attempt at encouragement for folks to keep working on these tools because I love the aesthetic but I just can't grok the interface. I will continue to watch this project with interest!
It's super cool and I want to love it, but I find it too fiddly to get the layout the way I want it. For me it might be easier to just page through a plain text file of ascii art style diagrams or something.
I've always been just absolutely dog shit at design stuff. I can't center a div to save my life and I don't understand columns. I need it to be absolutely idiot proof because I'm an absolute idiot when it comes to these things.
I guess this is my attempt at encouragement for folks to keep working on these tools because I love the aesthetic but I just can't grok the interface. I will continue to watch this project with interest!
I would love to hear specifics on how you couldn't get the layout looking how you wanted it to. e.g. do you have a link to the presentation you did? Feel free to shot me an email at gmail, it's easily findeable online.
Any chance of adding mermaid syntax for ANSI or ASCII charts?
Mermaid is already supported natively, meaning the mermaid diagram output is rendered as actual images; no need for ascii diagrams https://mfontanini.github.io/presenterm/features/code/mermai...
This is great if you are fine managing npm packages, seems the only smooth way to install mermaid-cli. I'd say this is a mermaid limitation not a presenterm limitation.
Yeah, I'd love to not rely on an npm package but it's unfortunately the only way to do this out of the box.
also look at https://github.com/visit1985/mdp
I love this, what a wonderful idea
this looks amazing, goodbye google docs
very cool
+1 for terminal slides
brb re-creating pitch deck with presenterm to take presenterm from OSS to closed/limited/business source licensed software (ie, hashicorp strategy) then IPO.
Then rug pull the stonk. Leave retail holding the bag, go on permanent leave, get a golden parachute, then some cookie cutter MBA scumbag takes over and ruins it further. Subsequently gets sold to big tech for pennies, and IP gets shelved.
In the meanwhile, FOSS community forks presenterm and a divergence occurs.
The rinse and repeat :). The circle of scamming.
Then rug pull the stonk. Leave retail holding the bag, go on permanent leave, get a golden parachute, then some cookie cutter MBA scumbag takes over and ruins it further. Subsequently gets sold to big tech for pennies, and IP gets shelved.
In the meanwhile, FOSS community forks presenterm and a divergence occurs.
The rinse and repeat :). The circle of scamming.
Turning the terminal into a worse web browser is such a silly decision. I really wish we had better environments for this stuff. Something like MatLab. I suppose achieving such a thing on the ubiquity of the UNIX text streams model would be immensely difficult.
https://sw.kovidgoyal.net/kitty/text-sizing-protocol/