SCR2TXT(1) BSD General Commands Manual SCR2TXT(1)NAMEscr2txt — convert a video memory dump to plain text (w/ optional ANSI
codes)
SYNOPSISscr2txt [-a] [-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 representation
of the text from the screenshot.
scr2txt appends a newline character to the end of each line.
scr2txt reads from the standard input, and writes to the standard output.
The following options are available:
-a Emit ANSI colour escape codes to recreate the colours of the
original screenshot.
-l Replace any eight-bit line drawing characters with their closest
seven-bit equivalents. This may result in odd output depending
on the font in use when the screenshot 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 ALSOscr2png(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.
BSD May 18, 2001 BSD
