SCR2TXT(1)

NAME
scr2txt - convert a video memory dump to plain text

SYNOPSIS
scr2txt [-l]

DESCRIPTION
The scr2txt utility reads a video memory dump, such as that created by the vidcontrol(1) utility, and converts it to plain text, by stripping the header and the attribute bytes. scr2txt appends a newline character to the end of each line. scr2txt reads from the standard input, and writes to the standard output.

If the -l flag is given then scr2txt will rewrite the eight bit line drawing characters in to their closest seven bit match. This may not work correctly, depending upon the font in use when the screen shot was taken.

See vidcontrol(1) for information about the input file format expected by scr2txt.

RETURN VALUES
The scr2txt utility exits 0 on success or >0 if an error occurred.

EXAMPLES
The command sequence:

    vidcontrol -p < /dev/ttyv0 > shot.scr
    scr2txt < shot.scr > shot.txt

will capture the contents of the first virtual terminal, and redirect the output to the shot.scr file. scr2txt then processes this file, and writes the output to shot.txt. Of course this could be rewritten as

    vidcontrol -p < /dev/ttyv0 | scr2txt > shot.txt

This example will take a snapshot and remap the line drawing characters.

    vidcontrol -p < /dev/ttyv0 | scr2txt -l > shot.txt

SEE ALSO
scr2png(1), vidcontrol(1), syscons(4), ascii(7)

AUTHORS
Nik Clayton <nik@FreeBSD.org>

BUGS
When remapping eight bit characters to seven bit characters, scr2txt should have more than one lookup table, depending on the font in use, and should be able to process a custom lookup table provided by the user.