1LIFEREA(1) General Commands Manual LIFEREA(1)
2
3
4
6 Liferea - GTK desktop news aggregator
7
8
10 liferea [OPTIONS]
11
12
14 Liferea (Linux Feed Reader) is an aggregator for online news feeds. It
15 can be used to maintain a list of subscribed feeds, browse and search
16 through their items and displays their contents. Additionally Liferea
17 allows one to sync subscriptions and read headlines with online ac‐
18 counts of TinyTinyRSS and TheOldReader.
19
21 Liferea options:
22
23 -v, --version
24 Print version information and exit.
25
26 -h, --help
27 Display a option overview and exit.
28
29 -a, --add-feed=URI
30 Add a new subscription URI which can be a feed or website URL.
31
32 -w, --mainwindow-state=STATE
33 Start Liferea with its mainwindow in STATE: shown, hidden.
34
35 -p, --disable-plugins
36 Start with all plugins disabled.
37
38 --debug-all
39 Print debugging messages of all types.
40
41 --debug-cache
42 Print debugging messages for the cache handling.
43
44 --debug-conf
45 Print debugging messages of the configuration handling.
46
47 --debug-db
48 Print debugging messages of the configuration handling.
49
50 --debug-gui
51 Print debugging messages of all GUI functions.
52
53 --debug-html
54 Enables HTML rendering debugging. Each time Liferea renders HTML
55 output it will also dump the generated HTML into
56 $XDG_CACHE_DIR/liferea/output.html.
57
58 --debug-net
59 Print debugging messages of all network activities and display
60 the HTTP/S User-Agent string.
61
62 --debug-parsing
63 Print debugging messages of all parsing functions.
64
65 --debug-performance
66 Print debugging messages when a function takes too long to
67 process.
68
69 --debug-trace
70 Print debugging messages when entering/leaving functions.
71
72 --debug-update
73 Print debugging messages of the feed update processing.
74
75 --debug-vfolder
76 Print debugging messages of the search folder matching.
77
78 --debug-verbose
79 Print verbose debugging messages.
80
81
83 To allow integration with other programs Liferea provides a DBUS inter‐
84 face for automatic creation of new subscriptions. The script liferea-
85 add-feed is a convenient way to use this interface. Just pass a valid
86 feed URL as parameter and the feed will be added to the feed list. You
87 can also pass non-feed URLs to use feed auto discovery. See the EXAM‐
88 PLES section.
89
90
92 http_proxy (for HTTP connections)
93 https_proxy (for HTTPS connections)
94 If defined and a proxy is not specified in the Liferea prefer‐
95 ences (which uses the proxy settings provided by dconf), their
96 value will be used as proxy URIs. Both are used by many common
97 CLI tools, so make sure to export them in a dedicated subshell.
98
99 LIFEREA_UA_ANONYMOUS
100 If defined, randomizes and anonymizes the default HTTP/S User-
101 Agent string.
102
103 LIFEREA_UA
104 If defined, its value replaces the default HTTP/S User-Agent
105 string.
106
107 LIFEREA_UA has always precedence over LIFEREA_UA_ANONYMOUS, so the lat‐
108 ter can be safely defined in global shell initialization files.
109
110
112 $ http_proxy="http://proxy.example.com:3128" liferea
113 $ http_proxy="http://username:password@proxy.example.com:3128" liferea
114 Will alter each outgoing request to use proxy.example.com on
115 port 3128 as proxy. If DNS resolution does not work, an IP ad‐
116 dress can be used instead.
117
118 $ LIFEREA_UA_ANONYMOUS=1 liferea --debug-net
119 Will alter each outgoing HTTP/S request to randomize Liferea's
120 version and hide the operative system in use. In addition,
121 prints the HTTP/S User-Agent and all outgoing network requests.
122
123
124 $ LIFEREA_UA="Mozilla/5.0 (X11; Linux x86_64; rv:10.0) Gecko/20100101 Firefox/10.0" liferea
125 Will alter each outgoing HTTP/S request to pose as Firefox on
126 Linux.
127
128 $ liferea-add-feed "feed:https://www.example.com/feed.rss"
129 $ liferea --add-feed "https://www.example.com/feed.rss"
130 Subscribe to "example.com/feed.rss". Remember to supply a valid
131 and correctly escaped feed URL as parameter. Please note that
132 Liferea needs to be running for liferea-add-feed to work.
133
134
136 $XDG_CONFIG_DIR/liferea/feedlist.opml
137 Contains the current list of subscriptions.
138
139 $XDG_CONFIG_DIR/liferea/liferea.css
140 Stylesheet that can be used to override default HTML style.
141
142 $XDG_DATA_DIR/liferea/liferea.db
143 SQLite3 database with all subscriptions and headlines.
144
145 $XDG_DATA_DIR/liferea/plugins/
146 User-installed plugins are stored here. You can either manually
147 put plugins here or use the plugin installer in Liferea.
148
149
151 This manual page was written by Lars Windolf <lars.windolf@gmx.de>.
152
153 Updated on Nov 24, 2021 by Lorenzo L. Ancora <admin@lorenzoan‐
154 cora.info>.
155
156
157
158 Nov 24, 2021 LIFEREA(1)