1LIFEREA(1)                  General Commands Manual                 LIFEREA(1)
2
3
4

NAME

6       Liferea - GTK desktop news aggregator
7
8

SYNOPSIS

10       liferea [OPTIONS]
11
12

DESCRIPTION

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

OPTIONS

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-update
66              Print debugging messages of the feed update processing.
67
68       --debug-vfolder
69              Print debugging messages of the search folder matching.
70
71

DBUS INTERFACE

73       To allow integration with other programs Liferea provides a DBUS inter‐
74       face  for  automatic creation of new subscriptions. The script liferea-
75       add-feed is a convenient way to use this interface. Just pass  a  valid
76       feed  URL as parameter and the feed will be added to the feed list. You
77       can also pass non-feed URLs to use feed auto discovery.  See the  EXAM‐
78       PLES section.
79
80

ENVIRONMENT

82       http_proxy (for HTTP connections)
83       https_proxy (for HTTPS connections)
84              If  defined  and a proxy is not specified in the Liferea prefer‐
85              ences (which uses the proxy settings provided by  dconf),  their
86              value  will  be used as proxy URIs. Both are used by many common
87              CLI tools, so make sure to export them in a dedicated subshell.
88
89       LIFEREA_FEED_CMD_TIMEOUT
90              If defined, overrides the default timeout  for  feed  generating
91              commands  with  the number of seconds given in this variable. It
92              must be an integer value greater than zero; invalid values  will
93              be ignored.
94
95       LIFEREA_UA_ANONYMOUS
96              If  defined,  randomizes and anonymizes the default HTTP/S User-
97              Agent string.
98
99       LIFEREA_UA
100              If defined, its value replaces  the  default  HTTP/S  User-Agent
101              string.
102
103       LIFEREA_UA has always precedence over LIFEREA_UA_ANONYMOUS, so the lat‐
104       ter can be safely defined in global shell initialization files.
105
106

EXAMPLES

108       $ http_proxy="http://proxy.example.com:3128" liferea
109       $ http_proxy="http://username:password@proxy.example.com:3128" liferea
110              Will alter each outgoing request  to  use  proxy.example.com  on
111              port  3128  as proxy. If DNS resolution does not work, an IP ad‐
112              dress can be used instead.
113
114       $ LIFEREA_UA_ANONYMOUS=1 liferea --debug-net
115              Will alter each outgoing HTTP/S request to  randomize  Liferea's
116              version  and  hide  the  operative  system in use.  In addition,
117              prints the HTTP/S User-Agent and all outgoing network  requests.
118
119
120       $ LIFEREA_UA="Mozilla/5.0 (X11; Linux x86_64; rv:10.0) Gecko/20100101 Firefox/10.0" liferea
121              Will  alter  each  outgoing HTTP/S request to pose as Firefox on
122              Linux.
123
124       $ liferea-add-feed "feed:https://www.example.com/feed.rss"
125       $ liferea --add-feed "https://www.example.com/feed.rss"
126              Subscribe to "example.com/feed.rss". Remember to supply a  valid
127              and  correctly  escaped  feed URL as parameter. Please note that
128              Liferea needs to be running for liferea-add-feed to work.
129
130

FILES

132       $XDG_CONFIG_DIR/liferea/feedlist.opml
133              Contains the current list of subscriptions.
134
135       $XDG_CONFIG_DIR/liferea/liferea.css
136              Stylesheet that can be used to override default HTML style.
137
138       $XDG_DATA_DIR/liferea/liferea.db
139              SQLite3 database with all subscriptions and headlines.
140
141       $XDG_DATA_DIR/liferea/plugins/
142              User-installed plugins are stored here. You can either  manually
143              put plugins here or use the plugin installer in Liferea.
144
145

AUTHOR

147       This manual page was written by Lars Windolf <lars.windolf@gmx.de>.
148
149       Updated  on  Nov  24,  2021  by  Lorenzo  L.  Ancora  <admin@lorenzoan‐
150       cora.info>.
151
152
153
154                                 Nov 24, 2021                       LIFEREA(1)
Impressum