aboutsummaryrefslogtreecommitdiffstats
path: root/doc/man/scrotty.1
blob: 4776ec52b73137798985302d2f6d3804fc86ad5d (plain) (blame)
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
.TH SCROTTY 1 SCROTTY
.SH NAME
scrotty \- Framebuffer screenshot program
.SH SYNOPSIS
.B scrotty
.RI [ OPTION ]...\ [\fB\-\-\fP]
.RI [ FILENAME_PATTERN
|
.B >
.IR FILE ]
.SH DESCRIPTION
.B scrotty
is a minimalist screenshoter for your framebuffers.
It takes a screenshot of your TTY session.
.B X
is not supported.
.PP
.B scrotty
is designed after
.BR scrot (1),
but includes a some improvements. Namely it does not support
delaying the screenshot, selecting image quality or creating
thumbnails. Such operations is left to be done by the user
with the option
.B \-\-exec
and a utility such as
.BR convert (1).
.SH OPTIONS
.TP
.BR \-h ,\  \-\-help
Print usage information.
.TP
.BR \-v ,\  \-\-version
Print program name and version.
.TP
.BR \-c ,\  \-\-copyright
Print copyright information.
.TP
.BR \-d ,\  \-\-device \ \fINO\fP
Select framebuffer device.
.TP
.BR \-e ,\  \-\-exec \ \fICMD\fP
Command to run for each saved image.
.PP
Each option can only be used once.
.SH "SPECIAL STRINGS"
Both the
.B \-\-exec
and
.I FILENAME_PATTERN
parameters can take format specifiers that are expanded by
.B scrotty
when encountered. There are two types of format specifier.
Characters preceded by a \(aq%\(aq are interpreted by
.BR strftime (3).
These options may be used to refer to the current date and
time. The second kind are internal to
.B scrotty
and are prefixed by \(aq$\(aq or \(aq\\\(aq. The following
specifiers are recognised:
.PP
$i      framebuffer index
.br
$f      image filename/pathname (ignored in FILENAME_PATTERN)
.br
$n      image filename          (ignored in FILENAME_PATTERN)
.br
$p      image width multiplied by image height
.br
$w      image width
.br
$h      image height
.br
$$      expands to a literal \(aq$\(aq
.br
\\n      expands to a new line
.br
\\\\      expands to a literal \(aq\\\(aq
.br
\\       expands to a literal \(aq \(aq (backslash, space)
.PP
A space that is not prefixed by a backslash in
.B \-\-exec
is interpreted as an argument delimiter. This is the case
even at the beginning and end of the string and if a space
was the previous character in the string.
.SH "FUTURE DIRECTIONS"
Support for TTY:s in other kernels should be added.
.SH RATIONALE
Taking screenshots was a pain before this (except,
.BR fbcat (1)
already existed without the authors knowledge.).
Screenshots are useful if you want to remember something or
send an image of how something looks.
.SH "SEE ALSO"
.BR scrot (1),
.BR strftime (3),
.BR convert (1),
.BR fbcat (1),
.BR setterm (1)
.PP
Full documentation available locally via: info \(aq(scrotty)\(aq
.SH LICENSE
Copyright \(co 2014, 2015  Mattias Andrée
.br
License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>.
.br
This is free software: you are free to change and redistribute it.
.br
There is NO WARRANTY, to the extent permitted by law.
.SH 
.PP
Copying and distribution of this manual, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.  This file is offered as-is,
without any warranty.
.SH BUGS
Please report bugs to <https://github.com/maandree/scrotty/issues>
or to <maandree@member.fsf.org>.