LinuxCommandLibrary

toilet

Print large, rendered text to the terminal

TLDR

Generate ASCII art for a given text

$ toilet [input_text]
copy

Generate ASCII art using a custom font file
$ toilet [input_text] [[-f|--font]] [font_filename]
copy

Generate ASCII art using a filter
$ toilet [input_text] [[-F|--filter]] [filter_name]
copy

Show available toilet filters
$ toilet [[-F|--filter]] list
copy

SYNOPSIS

toilet [options] [message]

PARAMETERS

-f
    Specify a font file.

-F
    Specify a filter.

-d
    Specify a font directory.

-s
    Small output.

-S
    Big output.

-t
    Terminal width output.

-w
    Specify output width.

-W
    Maximum width output.

-h
    Help output.

-v
    Version information.

-k
    Kerning.

-o
    Output Mode.

-e
    Change the default character encoding.

DESCRIPTION

The toilet command is a utility that produces large characters made of smaller characters in the terminal.
It can be used to generate ASCII art banners or headings with customizable fonts, colors, and effects. toilet supports various output modes like horizontal and vertical printing.
It's often utilized for adding visual flair to shell scripts, welcome messages, or general command-line interfaces. The user can modify the font, layout, and color scheme using command-line options, allowing for personalized and eye-catching text displays.
While primarily a cosmetic tool, it offers a creative way to enhance the presentation of text within the terminal environment.

FONTS

The visual appearance of the output depends heavily on the font used. Several fonts are available for toilet, often distributed separately.
Users can download and install custom fonts to further personalize the command's output.

SEE ALSO

banner(1), figlet(1)

Copied to clipboard