aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: cc664517e05ba7033ac13ea64b1edf372f0c1dea (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
NAME
	scrotty - Screenshot program for Linux's TTY.

SYNOPSIS
	scrotty [OPTION]... [FILENAME_PATTERN] [-- CONVERT_OPTION...]

DESCRIPTION
	scrotty is a minimalist screenshoter for the Linux VT. It takes
	a screenshot of your framebuffers (multiple are supported.)
	X is not supported.

	scrotty is designed after scrot(1), but includes a some
	improvements. Namely it does not support delaying the screenshot,
	selecting image quality or creating thumbnails, but it has
	support for adding arbitrary arguments to convert(1), which is
	used to save the image.

OPTIONS
	--help
		Print usage information.

	--version
		Print program name and version.

	--copyright
		Print copyright information.

	--raw
		Save in PNM rather than in PNG.

	--exec CMD
		Command to run for each saved image.

SPECIAL STRINGS
	Both the --exec and FILENAME_PATTERN parameters can take format
	specifiers that are expanded by scrotty when encountered. There
	are two types of format specifier. Characters preceded by a '%'
	are interpretted by strftime(3). These options may be used to
	refer to the current date and time. The second kind are internal
	to scrotty and are prefixed by '$' or '\'. The following specifiers
	are recognised:
	
	$i	framebuffer index
	$f	image filename/pathname (ignored in FILENAME_PATTERN)
	$n	image filename          (ignored in FILENAME_PATTERN)
	$p	image width multiplied by image height
	$w	image width
	$h	image height
	$$	expands to a literal '$'
	\n	expands to a new line
	\\	expands to a literal '\'
	\ 	expands to a literal ' ' (backslash, space)

	A space that is not prefixed by a backslash in --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.

FUTURE DIRECTIONS
	Support for TTY:s in other kernels should be added.

RATIONALE
	Taking screenshots was a pain before this. Screenshots
	are useful if you want to remember something or send an
	image of how something looks.

SEE ALSO
	scrot(1), convert(1), strftime(3)

	Full documentation available locally via: info '(scrotty)'