TypeScript icon, indicating that this package has built-in type declarations

    0.0.60 • Public • Published

    CLI for creating rapid (& great) presentations just using the terminal!

    Now you can be anywhere and deliver great looking presentations! on any OS, on any computer, just before a meeting, and using a simple text file! From there it'll generate a server based presentation with your slides, a PDF or even a movie!

    Run without installing it

    npx revelo [command] file [options]


    Generate a cool presentation with nothing more than NodeJS and a simple text file. The CLI includes a server with hot browser reloading support, public url access thanks to localtunnel and an export command which can render the presentation as a PDF, GIF or MP4 movie. All of this can be tracked within github version's control and executed within any terminal or within a Github workflow; this way you can even include self-generating presentations within your repos!


    The CLI includes 3 commands:

    • server
    • render
    • export

    Server Command

    The server command takes the given text file (its based on markdown, but can have any extension), generates a temporal directory with the generated presentation and serves it on localhost. It supports hot reloading out of the box, so if you save any changes to the given text file, automatically refreshes the browser session with the updates. It supports several optional parameters, being the most relevant:

    If you add the parameter --public, it also launches an localtunnel session tunneling for public access to the presentation, giving you a public url for you to share. If used, currently the hot-reloading feature gets disabled.

    By default the server command attempts to open your default web browser with the presentation. This argument overwrites that.

    Removes progress bar, slider controls and automatically goes to next slide by the time defined; works almost as a movie but for the browser.

    Render Command

    The render command takes the given text file and generates an MP4 movie or GIF animation of the generated presentation on the --output file defined. Works almost as the --autoplay server argument, but saves the result as a movie/animation. It supports several optional parameters, being the most relevant:

    Defines the target MP4/GIF file name and location.

    Defines the frames per second. Default 25 for MP4, 5 for GIF

    Defines the time per slide in seconds. Defaults to 'auto' which uses a time to read algo to determine the best time to wait per slide.

    Text File Format

    See the wiki pages (in progress)

    Simple example

    Given the following text file (example/hello.txt):

    # Hello
    this is the first slide
    # another
    - this is another slide
    - with some bullets
    - and steps
    - and emoji's ;-)
    ## This is the third
    it supports video backgrounds
    ## This is the fourth
    ->background[happy people,0.3]
    - you can have different <(.blue)> 
    - colours per line <(.green)> 
    ## The end now

    Generates the following presentation

    Using the following command:

    npx revelo render example/hello.txt -o hello.gif


    npm i revelo

    DownloadsWeekly Downloads






    Unpacked Size

    28 MB

    Total Files


    Last publish


    • pabloschaffner