aboutsummaryrefslogtreecommitdiffstats
path: root/README
blob: 2ed2e42dc50d00c488b1ebe5ceb17f7e51d91bd0 (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
NAME
	scrotty 1.1-dev - Framebuffer screenshot program

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

DESCRIPTION
	scrotty is a minimalist screenshoter for your framebuffers.
	It takes a screenshot of your TTY session. 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 interpreted 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 (except, fbcat
	already existed without my knowledge.) 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), fbcat(1), setterm(1)

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

	See INSTALL for installation instructions.
	See DEPENDENCIES for software dependenices.
	See COPYING for copyright information.
	See LICENSE for the full license used by the software.
	See NEWS for significant differences between releases.

LICENSE
	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.