LinuxCommandLibrary

tpp

Transfer data between parallel ports

TLDR

View a presentation

$ tpp [path/to/file]
copy

Output a presentation
$ tpp -t [type] -o [path/to/output] [path/to/file]
copy

SYNOPSIS

tpp [OPTIONS] [FILE]

Example: tpp my_presentation.md

PARAMETERS

-t
    Specifies a visual theme for the presentation.

-s
    Sets the text size or layout for the slides.

-c
    Cycles through available themes or color schemes during the presentation.

--loop
    Automatically loops the presentation once all slides have been shown.

--list-themes
    Displays a list of all available themes.

--list-sizes
    Displays a list of all available sizes.

--slide
    Starts the presentation at a specific slide number.

--width
    Overrides the detected terminal width in columns.

--height
    Overrides the detected terminal height in rows.

--config
    Specifies a custom configuration file to use.

--verbose
    Enables verbose output for debugging or detailed information.

--version
    Shows the program's version information.

--help
    Displays the help message and available options.

DESCRIPTION

tpp (Terminal Presentation Program) is a command-line utility designed to display text and Markdown files as interactive slide presentations directly within your terminal emulator. It's particularly useful for technical presentations, code walk-throughs, or simple information sharing without needing a graphical environment.

The program interprets a specified input file, typically using --- (three hyphens) as a separator to delineate individual slides. It supports basic Markdown formatting, allowing users to include headings, lists, bold/italic text, and code blocks. tpp offers various customization options, including different themes and sizes, to control the appearance of the presentation. Users can navigate through slides using arrow keys, spacebar, or other defined keybindings. It's a lightweight alternative to graphical presentation software, emphasizing simplicity and efficiency for text-based content.

CAVEATS

tpp is not a standard, built-in Linux command; it needs to be installed separately, typically from a package manager (e.g., AUR on Arch Linux, or compiled from source) or as part of a specific project. Its functionality is limited to text-based presentations and does not support embedded images, complex animations, or advanced multimedia typical of graphical presentation software. The exact features and available options may vary slightly depending on the specific version or distribution of the tpp program.

SLIDE SEPARATION

Each slide in a tpp presentation is typically separated by a line containing only three hyphens (---). Any content between these separators constitutes a single slide.

KEYBINDINGS

Users can navigate through slides using common keybindings like the spacebar, right arrow key (next slide), left arrow key (previous slide), and q to quit the presentation.

THEMING AND CUSTOMIZATION

tpp supports various built-in themes and sizes for visual customization. Advanced users can often define custom themes or modify existing ones through configuration files, allowing for tailored aesthetics.

HISTORY

The tpp (Terminal Presentation Program) referred to here was primarily developed by Martin Geisler (majewsky on GitHub). It emerged as a lightweight, open-source solution for delivering presentations directly from the command line, catering to developers, system administrators, and anyone who prefers a minimalist, text-centric workflow. Its development has focused on simplicity, broad terminal compatibility, and efficient rendering of Markdown content. While not part of the standard Linux utility set, it gained popularity within certain technical communities as a practical tool for code-centric talks and documentation review.

SEE ALSO

pandoc(1), glow, vmd

Copied to clipboard