forked from cbdevnet/xecho
-
Notifications
You must be signed in to change notification settings - Fork 0
/
README.txt
85 lines (69 loc) · 2.59 KB
/
README.txt
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
xecho is an easy way to display text via an X Window.
It takes input from the commandline or via stdin and
tries to render it at the largest font size the window
permits.
Additional options allow customizing the display
for special cases, such as signage or status displays.
xecho aims to have minimal dependencies and bloat,
directly using Xlib and Xft for it's functionality.
Double buffering is done by using the X Double
Buffering Extension (XDBE) and can be disabled.
This repository contains the latest development version
of xecho. Release tarballs are available at the tag page
and are archived at
https://dev.cbcdn.com/xecho/
Should this repository ever move, the new location will be
announced there.
Options:
-- Stop argument parsing
-font <fontspec> Font to be used
-bc <colorspec> Background color
-fc <colorspec> Text color
-dc <colorspec> Debug color
-title <title> Set window title
-size <n> Set static font size
-maxsize <n> Set maximum size for scaling
-align <alignspec> Align text
-padding <n> Pad entire text
-linespacing <n> Pad between lines
Flags:
-stdin Deprecated / No-op
-no-stdin Disable text content update via stdin
-windowed Do not force window to fullscreen
-independent-lines Scale lines independently
-debugboxes Draw debug boxes
-disable-text Do not draw text
-disable-doublebuffer What it says on the tin
-h | -help | --help Display usage information
-v[v[v[v]]] Increase verbosity
Where <colorspec> is either an X Color name (blue, red,
yellow etc) or an HTML-style RGB value (#rrggbb),
<fontspec> is a freetype font name (e.g. verdana, monospace)
and <alignspec> is one of n|ne|e|se|s|sw|w|nw
Options must be given before a text argument starts.
Command line option parsing can be stopped with --,
eg.: ./xecho -bc blue -fc yellow -- -help shows usage information
Text passed via the command line is scanned once for
control character encodings (\n and \\), which
are replaced by their ASCII codepoints.
By default, xecho reads text from stdin and appends it to the window
content. Control characters on stdin are handled as follows
\n Starts new line
\f Clears display
\r Clears current line
\b Backspace
Usage examples:
while :; do printf "\f%s" "`date`" \
&& sleep 1; done | ./xecho
Displays the current date updated by every second.
The output of `date` is handled by printf to avoid
a race condition where the pipe is flushed after
the form feed, but before date has printed its
output, thus leading to flicker.
Build prerequisites:
- libxft-dev
- libx11-dev
- libxext-dev
- pkg-config
- A C compiler (tcc does the trick)
To compile, simply run make.