1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
|
=head1 NAME
termrec - a tty recorder
=head1 SYNOPSIS
B<termrec> [B<-f> I<format>] [B<-e> I<command>] [I<outfile>]
=head1 DESCRIPTION
B<Termrec> is a tty recorder; it can record the output of any text mode program
which you can then replay with B<termplay>, B<ttyplay>, B<ipbt>, B<ttyplayer>,
B<nh-recorder>, B<asciinema> or similar.
If I<outfile> ends in B<.gz>, B<.xz>, B<.bz2> or B<.zst>, the data will be
appropriately compressed.
If no I<outfile> is given, B<termrec> will produce a name like 2008-11-27.13-02-42.ttyrec.bz2
You can write directly to some remote URLs, such as
B<tcp://>I<host>B<:>I<port> but that's usually of little use.
=head2 Options:
=over
=item B<-f> I<format>, B<--format>
You can specify a format other than ttyrec. Those available are:
=over
=item ansi
No timing data. This is same as the output of L<script(1)>.
=item ttyrec
Compatible with B<ttyrec> by Satoru Takabayashi.
=item nh-recorder
Compatible with B<nh-recorder> by Helge Dennhardt.
=item asciicast
Compatible with B<asciinema> by Marcin Kulik; format v2.
=item asciicast-v1
Likewise, format v1.
=back
=item B<-e> I<command>, B<--exec>
Runs a I<command> instead of spawning a shell and records its output.
=item B<-r>, B<--raw>
Inhibits noting info about your terminal size and UTFness. This data is usually a good
thing, but can confuse some programs. Also note that none of the formats provides a way
to mark which exactly charset you use -- only if it's UTF-8 or one of ancient ones.
=item B<-a>, B<--append>
If the output file exists, it will be appended instead being overwritten.
=item B<-h>, B<--help>
Shows a short explanation of parameters.
=back
=head1 ENVIRONMENT
=over
=item SHELL
Unless B<-e> is given, this will be the shell spawned, falling back to B</bin/sh>
if not set. On Windows, COMSPEC is used instead.
=back
=head1 SEE ALSO
L<termplay(1)>, L<termtime(1)>, L<termcat(1)>.
|
