File: tickr.1

package info (click to toggle)
tickr 0.7.0-3
  • links: PTS
  • area: main
  • in suites: bullseye
  • size: 2,024 kB
  • sloc: ansic: 11,309; sh: 1,301; xml: 64; makefile: 54
file content (320 lines) | stat: -rw-r--r-- 7,360 bytes parent folder | download
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
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
.TH TICKR 1 "May 31, 2020"
.SH NAME
.B Tickr
- GTK-based highly graphically-customizable Feed Ticker.
.SH SYNOPSIS
.B tickr
[\-help, \-h, \-? / \-version, \-v / \-license, \-l]
.br
[\-dumpfontlist / \-dumpconfig / \-dumperrorcodes]
.br
[\-instance\-id=n / \-no\-ui]
.br
[\-connect\-timeout=n / \-sendrecv\-timeout=n]
.br
[options (\-name[=value])...]
.br
[resource (URL or file name)]
.SH DESCRIPTION
.B Tickr
is a GTK-based RSS/Atom Reader that displays feeds as a smooth
scrolling line on your Desktop, as known from TV stations. Open feed
links in your favourite Browser. Graphics are highly customizable.
.SH OPTIONS
.TP
.B help
Get help page
.TP
.B version
Print out version number
.TP
.B license
Print out license
.TP
.B dumpfontlist
Send list of available fonts to stdout
.TP
.B dumpconfig
Send content of config file to stdout
.TP
.B dumperrorcodes
Send error codes and strings to stdout
.TP
.B instance\-id=n
n = 1 to 99 - Use this when launching several instances simultaneously,
each instance using its own config and dump files (to be effective,
instance\-id must be the 1st argument)
.TP
.B no\-ui
Disable opening of UI elements which can modify settings and/or URL
list/selection (to be effective, no\-ui must be the 1st or 2nd argument)
.TP
.B \-connect\-timeout=n
n = 1 to 60 (seconds) - Override default connect timeout value
(= 5 seconds), useful if proxy or slow internet link
.TP
.B \-sendrecv\-timeout=n
Same as above for send/recv timeout (default value = 1 second)
.TP
.B delay=n
Delay in milliseconds (-> speed = K / delay)
.TP
.B shiftsize=n
Shift size in pixels (-> speed = K x shift size)
.TP
.B fgcolor=#rrggbbaa
Foreground 32-bit hexa color
#.TP
#.B highlightfgcolor=#rrggbbaa
#Marked items foreground 32-bit hexa color
.TP
.B bgcolor=#rrggbbaa
Background 32-bit hexa color
.TP
.B setgradientbg=[y/n]
Set gradient background
.TP
.B bgcolor2=#rrggbbaa
Background 32-bit hexa color2
.TP
.B fontname='fontname'
Font name
.TP
.B fontsize=n
Font size (can't be > 200)
.TP
.B disablescreenlimits=[y/n]
Allow win_x, win_y and win_w to be greater than screen dimensions
.TP
.B win_x=n
Window position - x
.TP
.B win_y=n
Window position - y
.TP
.B win_w=n
Window width
.TP
.B win_h=n
Window height (compute font size if > 0)
.TP
.B windec=[y/n]
Window decoration
.TP
.B alwaysontop=[y/n]
Window always-on-top
.TP
.B fullscreen=[y/n]
Fullscreen mode (experimental)
.TP
.B wintransparency=n
Actually window opacity from 1 to 10 (0 = none -> 10 = full)
.TP
.B iconintaskbar=[y/n]
Icon in taskbar
.TP
.B winsticky=[y/n]
Visible on all user desktops
.TP
.B shadow=[y/n]
Apply shadow to text
.TP
.B shadowoffset_x=n
Shadow x offset in pixels
.TP
.B shadowoffset_y=n
Shadow y offset in pixels
.TP
.B shadowfx=n
Shadow effect (0 = none -> 10 = full)
.TP
.B linedelimiter='str'
String to be appended at end of line
.TP
.B specialchars=[y/n]
Enable or disable special characters. This is only useful when resource
is a file, not an URL
.TP
.B newpgchar=c
\'New page' special character
.TP
.B tabchar=c
\'Tab' (8 spaces) special character
.TP
.B rssrefresh=n
Refresh rate in minutes = delay before reloading resource (URL or text
file.) 0 = never force reload. Otherwise, apply only if no TTL inside
feed or if resource is text file.
(Actually, in multiple selections mode, all feeds are always reloaded
sequentially, because there is no caching involved)
.TP
.B revsc=[y/n]
Reverse scrolling (= L to R)
.TP
.B feedtitle=[y/n]
Show or hide feed title
.TP
.B feedtitledelimiter='str'
String to be appended after feed title
.TP
.B itemtitle=[y/n]
Show or hide item title
.TP
.B itemtitledelimiter='str'
String to be appended after item title
.TP
.B itemdescription=[y/n]
Show or hide item description
.TP
.B itemdescriptiondelimiter='str'
String to be appended after item description
.TP
.B nitemsperfeed=n
Read N items max per feed (0 = no limit)
#.TP
#.B markitemaction=[h/c/n]
#Mark item action: hide / color / none
.TP
.B rmtags=[y/n]
Strip html tags
.TP
.B uppercasetext=[y/n]
Set all text to upper case
.TP
.B homefeed='str'
Set URL as 'homefeed' = homepage (from command line, not automatically
saved, so a little bit useless...)
.TP
.B openlinkcmd='str'
\'Open in Browser' command line: Application that will open active link
(may require path.) Most likely will invoke your favourite browser
.TP
.B openlinkargs='str'
\'Open in Browser' optional arguments
.TP
.B clock=[l/r/n]
Clock location: left / right / none
.TP
.B clocksec=[y/n]
Show seconds
.TP
.B clock12h=[y/n]
12h time format
.TP
.B clockdate=[y/n]
Show date
.TP
.B clockfontname='fontname'
Clock font name
.TP
.B clockfontsize=n
Clock font size (can't be > Tickr height)
.TP
.B clockfgcolor=#rrggbbaa
Clock foreground 32-bit hexa color
.TP
.B clockbgcolor=#rrggbbaa
Clock background 32-bit hexa color
.TP
.B setclockgradientbg=[y/n]
Set clock gradient background
.TP
.B clockbgcolor2=#rrggbbaa
Clock background 32-bit hexa color2
.TP
.B disablepopups=[y/n]
Disable error/warning popup windows
.TP
.B pauseonmouseover=[y/n]
Pause Tickr on mouseover
.TP
.B disableleftclick=[y/n]
Disable left-click
.TP
.B mousewheelaction=[s/f/n]
Mouse wheel acts on: (Tickr\-)speed / feed(\-in\-list) / none
.br
(use \<ctrl\> + mouse wheel for alternative action)
.TP
.B sfeedpickerautoclose=[y/n]
Selected feed picker window closes when pointer leaves area
.TP
.B enablefeedordering=[y/n]
Enable feed re-ordering (by user)
.TP
.B useauth=[y/n]
Use HTTP basic authentication
.TP
.B user='str'
User
.TP
.B psw='str'
Password (never saved)
.TP
.B useproxy=[y/n]
Connect through proxy
.TP
.B proxyhost='str'
Proxy host
.TP
.B proxyport='str'
Proxy port
.TP
.B useproxyauth=[y/n]
Use proxy authentication
.TP
.B proxyuser='str'
Proxy user
.TP
.B proxypsw='str'
Proxy password (never saved)
.SH NOTES
Mouse usage:
.PP
- To open the main menu, right-click inside Tickr area.
.PP
- You can import feed subscriptions from another feed reader with
.br
\'File > Import Feed List (OPML)'.
.PP
- To open a link in your browser, left-click on text.
.PP
- Use mouse wheel to either adjust Tickr scrolling speed or open the
\'Selected Feed Picker' window to quickly move between selected feeds
(use \<ctrl\> + mouse wheel for alternative action.)
.PP
Local resources:
.PP
- file:///path/file_name is considered an URL and will be XML-parsed, ie
a RSS or Atom format is expected.
.PP
- /path/file_name will be processed as a non-XML text file, ie the file
will be read 'as is'.
.PP
You can set your favourite browser in the Full Settings window. Otherwise,
the system default one will be looked for.
.PP
Tickr parses command line arguments and looks for option(s) then for one
resource, the rest of the line is ignored. It also reads configuration file
\'tickr-conf' located in /home/<user_name>/.tickr/ if it exists (or
\'tickr-conf<n>' if an instance id has been set to n.) See FILES.
.PP
Command line options override configuration file ones which override default
ones.
.SH FILES
~/.tickr/tickr-conf
.br
~/.tickr/tickr-conf<n>
.br
~/.tickr/tickr-url-list
.br
~/.tickr/tickr-url-list<n>
.SH REPORTING BUGS
Please, report tickr bugs to either Emmanuel Thomas-Maurin <manutm007@gmail.com>
or Debian.
.SH AUTHOR
.B Tickr
was written by Emmanuel Thomas-Maurin <manutm007@gmail.com>.
.PP
This manual page was written by Emmanuel Thomas-Maurin <manutm007@gmail.com>,
for the Debian project (and may be used by others).