---
name: "aecat"
section: "1"
platform: "linux"
package: "aewan"
version: "1.0.01-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/aecat"
---

# aecat(1)

display an aewan document

## NAME

aecat - display an aewan document

## SYNOPSIS

**aecat** \[-b\] \[-c\] \[-{n\|N}\] \[{-p \| -l \<layer\_num\>}\] \[-f \<format\>\] \[-o \<output\_file\>\] inputfile

## DESCRIPTION

This is an utility program that will convert an aewan document to ANSI escape sequences so that it can be rendered on a standard terminal. Alternatively, it can also generate HTML code for displaying the document in a web page. Any particular layer of the document may be converted, or you may request a composite of all layers.

## OPTIONS

- **-f**

  specifies output format - can "text", "html" or "comment". Default is "text". The "comment" format extracts document metadata.

- **-c**

  prepend a 'clear screen' escape sequence (only valid when outputting text).

- **-o***\<file\>*

  writes output to specified file rather than stdout

- **-b**

  disables output of color (only characters will be printed).

- **-l***\<layer\_no\>*

  specifies which layer of the document is to be used (must be an index, not a layer name). By default, layer 0 will be used.

- **-L**

  displays the number of layers in the file.

- **-p**

  exports a composite, that is, overlays all visible layers, paying attention to layer transparency, etc. The size of the composite will be the size of the first layer

- **-n**

  suppress output of newlines

- **-h**

  prints a short help text

## AUTHORS

This program is part of the Aewan Ascii Art Editor package. See [aewan(1)](/aewan/1.md) for author information.

## LICENSE

Copyright (c) 2004-2005 Bruno Takahashi C. de Oliveira. All rights reserved.

This program is licensed under the GNU General Public License, version 2 or, at your option, any later version. For full license information, please refer to the COPYING file that accompanies the program.

## SEE ALSO

[**aewan**(1)](/aewan/1.md), [**aewan**(5)](/aewan/5.md), [**aemakeflic**(1)](/aemakeflic/1.md)