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

DBUS INTERFACE

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

ENVIRONMENT

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

EXAMPLES

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

FILES

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

AUTHOR

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)
Impressum