AutoHotkey Community

TCAP is a text capturing utility. Console I/O is copied to a file.

TCAP's purpose is somewhat like the "script" program available on
Unix systems, with respect to its ability to log text from the console
while it is running, but it has many additional features. It can remain
resident in memory (i.e., as a TSR program) to capture text from several
programs or commands, or capture text from a single program. Both program
output and text input by the user are captured. Captured text input does
not include editing characters, such as backspaces; only the final text is
captured. TCAP captures text from all three standard file handles
(stdin, stdout, and stderr).
Although TCAP was designed to capture text from DOS programs, it can
also capture output from Windows console programs (and user input under
certain circumstances).
The text capture is to a file specified by the user on the command-line,
and starts as soon as TCAP exits to DOS. The capture ends when TCAP
is removed from memory with the "/U" uninstall command-line switch.
The text capture can also be turned on or off at other times as
described below.
File output to the capture file is buffered; several methods are used
to make sure that the buffer can be written to disk as often as necessary.
The size of TCAP's internal buffer can be specified on the command-line.
In the event that the buffer was not large enough to capture everything a
warning message will be displayed when TCAP is uninstalled, and TCAP
will exit to DOS with a nonzero return value ("errorlevel"). If this
happens then increase the buffer size. The default buffer size is 8 KB,
but the minimum size of 6 KB should be large enough to avoid an incomplete
capture.
Note that bell characters (ASCII 7) are converted to spaces, so no
beep will be emitted and the bell character will not appear in the
capture file.

Usage information:

TCAP [options] [filename] [/C command [parameters]]
/? display a help screen
/B=size specify Buffer size in kilobytes
(minimum=6, maximum=64, default=8)
/ON turn capturing ON
/OFF turn capturing OFF
/OVERWRITE destroy initial contents of capture file
/APPEND Append text to capture file (default)
/N No filename swap (with /C option only)
/P+ or /P- enable or disable Path searching (with /C option only)
/I make entire command-line case-Insensitive
/L+ or /L- enable or disable use of Long filenames
/Lx prevent filename shortening when long names are unavailable
/Q quiet mode
/U stop text capture and Uninstall TCAP
filename specify the name of the capture file
(defaults to TCAP.TXT)
/C run and capture text from 'command', using the
indicated parameters
.
.
.

Making Programs TCAP-aware (programming information)
--------------------------
Programmers who want to make their programs TCAP-aware can do so
using the new TCAP API. TCAP-aware programs can determine if TCAP is
currently running, whether it is currently capturing console I/O, and
also disable or enable capturing. See API.TXT for more information.