1R2E(1) General Commands Manual R2E(1)
2
6 r2e - receive RSS feeds by email
7
9 r2e [options] <command> [<args>]
10
12 r2e is a simple program which you can run in your crontab(5). It
13 watches RSS feeds and sends you nicely formatted email message for each
14 new item.
15 For a quick start with r2e try these steps:
17 r2e new your@yourdomain.com
19 r2e add feedname http://feed.url/somewhere.rss
20 r2e run
21 The last command should eventually be put into your crontab if you want
24 things be sent you automatically.
25
27 -h, --help
28 Print the rss2email help and exit.
29 -v, --version
31 Print the rss2email version and exit.
32 --full-version
34 Print the versions of Python, the compiler used to compile Python,
35 and packages used by rss2email.
36 -c, --config <path>
38 The program configuration is read from $XDG_CON‐
39 FIG_HOME/rss2mail.cfg by default (see also FILES and ENVIRONMENT
40 VARIABLES below). Use this option to set a different configuration
41 file.
42 -d, --data <path>
44 Dynamic program data is read from $XDG_DATA_HOME/rss2mail.json by
45 default (see also FILES and ENVIRONMENT VARIABLES below). Use this
46 option to set a different data file.
47 -V, --verbose
49 Increment the logging verbosity.
50
52 new [<email>]
53 Create a new feed database. If the <email> argument is given, it
54 sets the default email address that mails are sent to.
55 email [<email>]
57 Update the default target email address to <email>.
58 add <name> <url> [<email>]
60 Subscribe to a feed. The <name> argument gives the feed a name for
61 future manipulation. <url> is the URL of the feed. The optional
62 <email> argument is the email address to send new items to, over‐
63 riding the default address for this particular feed. Repeat for
64 each feed you want to subscribe to.
65 run [--no-send] [<index> [<index> ...]]
67 Scan the feeds and send emails for new items. This can be run in a
68 cron job.
69 The --no-send option stops r2e from sending any email. This can be
71 useful the first time you run it, as otherwise it would send an
72 email for every available feed entry.
73 If an <index> is specified, r2e will only download that feed.
75 <index> can be either the feed name (as set by add) or the feed
76 index (as shown by list).
77 list List all the feeds in the database.
79 pause [<index> [<index> ...]]
81 Pause feeds (disable fetching). The <index> option selects the
82 feed(s) to pause (see run for possible values). If no <index>
83 is given, all feeds are paused.
84 unpause [<index> [<index> ...]]
86 Unpause feeds (enable fetching).
87 delete <index> [<index> [<index> ...]]
89 Remove a feed (or feeds) from the database. The <index> option
90 selects the feed(s) to delete (see run for possible values).
91 reset [<index> [<index> ...]]
93 Forget dynamic feed data (e.g. to re-send old entries). The
94 <index> option selects the feed(s) to reset (see run for possi‐
95 ble values). If no <index> is given, all feeds are reset.
96 opmlimport [<path>]
98 Import new feeds from OPML. <path> is the file from which the
99 OPML data will be read. If <path> is not given r2e reads the
100 data from stdin.
101 opmlexport [<path>]
103 Export all feeds to OPML. <path> is the file to which the OPML
104 data will be written. If <path> is not given r2e writes the
105 data to stdout.
106
108 The program's behavior can be controlled via the $XDG_CON‐
109 FIG_HOME/rss2email.cfg (see also FILES and ENVIRONMENT VARIABLES
110 below). The file format is similar to a Microsoft Windows INI file.
111 It is parsed by Python's ConfigParser class, so see the Python documen‐
112 tation at http://docs.python.org/3/library/configparser.html for format
113 details.
114 The config file stores general configuration (applied to all feeds) in
116 the [DEFAULT] section. The new command will create a configuration
117 file for you, which you can edit as you see fit. The add command will
118 add feed-specific sections. To override any a setting for all feeds,
119 change the value in the [DEFAULT] section. To override a setting for a
120 particular feed, add that setting to the feed-specific section. Here
121 is an example overriding use-publisher-email and name-format for the
122 feedname feed.
123 [DEFAULT]
125 from = user@rss2email.invalid
126 force-from = False
127 use-publisher-email = False
128 name-format = {feed-title}: {author}
129 ...
130 verbose = warning
131 [feed.feedname]
133 url = http://feed.url/somewhere.rss
134 use-publisher-email = True
135 name-format = {author} ({feed.title})
136 You can configure the following items:
138 Addressing
140 from The email address messages are from by default
141 use-8bit
143 Transfer-Encoding. For local mailing it is safe and convenient
144 to use 8bit.
145 force-from
147 True: Only use the 'from' address. False: Use the email address
148 specified by the feed, when possible.
149 use-publisher-email
151 True: Use the publisher's email if you can't find the author's.
152 False: Just use the 'from' email instead.
153 name-format
155 If empty, only use the feed email address rather than friendly
156 name plus email address. Available attributes may include
157 'feed', 'feed-name', 'feed-url', 'feed-title', 'author', and
158 to Set this to default To email addresses.
160 Fetching
162 proxy Set an HTTP proxy (e.g. 'http://your.proxy.here:8080/')
163 feed-timeout
165 Set the timeout (in seconds) for feed server response
166 Processing
168 active True: Fetch, process, and email feeds. False: Don't fetch,
169 process, or email feeds
170 digest True: Send a single, multi-entry email per feed per rss2email
172 run. False: Send a single email per entry.
173 date-header
175 True: Generate Date header based on item's date, when possible.
176 False: Generate Date header based on time sent.
177 date-header-order
179 A comma-delimited list of some combination of ('issued', 'cre‐
180 ated', 'modified', 'expired') expressing ordered list of prefer‐
181 ence in dates to use for the Date header of the email.
182 bonus-header
184 Set this to add bonus headers to all emails Example: bonus-
185 header = 'Approved: joe@bob.org'
186 trust-guid
188 True: Receive one email per post. False: Receive an email every
189 time a post changes.
190 trust-link
192 True: Receive one email per unique link url. False: Defer to
193 trust-guid preference. Toggling this for existing feeds may
194 result in duplicates, because the old entries will not be
195 recorded under their new link-based ids.
196 encodings
198 To most correctly encode emails with international characters,
199 we iterate through the list below and use the first character
200 set that works.
201 post-process
203 User processing hooks. Note the space after the module name.
204 Example: post-process = 'rss2email.post_process.downcase down‐
205 case_message'
206 digest-post-process
208 User processing hooks for digest messages. If 'digest' is
209 enabled, the usual 'post-process' hook gets to message the per-
210 entry messages, but this hook is called with the full digest
211 message before it is mailed. Example: digest-post-process =
212 'rss2email.post_process.downcase downcase_message'
213 HTML conversion
215 html-mail
216 True: Send text/html messages when possible. False: Convert
217 HTML to plain text.
218 use-css
220 Use CSS
221 css Optional CSS styling
223 html2text options
225 unicode-snob
226 Use Unicode characters instead of their ascii psuedo-replace‐
227 ments
228 links-after-each-paragraph
230 Put the links after each paragraph instead of at the end.
231 body-width
233 Wrap long lines at position. 0 for no wrapping.
234 Mailing
236 email-protocol
237 Select protocol from: sendmail, smtp, imap, maildir
238 sendmail
240 Path to sendmail (or compatible)
241 user-agent
243 String to use as User-Agent in outgoing emails. If present,
244 __VERSION__ and __URL__ are replaced with rss2email version num‐
245 ber and webpage
246 SMTP configuration
248 smtp-auth
249 Set to True to use SMTP AUTH
250 smtp-username
252 username for SMTP AUTH
253 smtp-password
255 password for SMTP AUTH
256 smtp-server
258 SMTP server
259 smtp-ssl
261 Connect to the SMTP server using SSL
262 smtp-ssl-protocol
264 TLS/SSL version to use on STARTTLS when not using 'smtp-ssl'.
265 IMAP configuration
267 imap-auth
268 set to True to use IMAP auth.
269 imap-username
271 username for IMAP authentication
272 imap-password
274 password for IMAP authentication
275 imap-server
277 IMAP server
278 imap-port
280 IMAP port
281 imap-ssl
283 connect to the IMAP server using SSL
284 imap-mailbox
286 where we should store new messages
287 Maildir configuration
289 maildir-path
290 Path of maildir to write messages into
291 maildir-mailbox
293 Mailbox within maildir-path to write messages into
294 Miscellaneous
296 verbose
297 Verbosity (one of 'error', 'warning', 'info', or 'debug').
298
300 $XDG_CONFIG_HOME/rss2email.cfg
301 If this file exists, it is read to configure the program.
302 $XDG_DATA_HOME/rss2email.json
304 The database of feeds. Use r2e to add, remove, or modify feeds, do
305 not edit it directly.
306
308 The environment variables used by r2e are all defined in the XDG Base
309 Directory Specification, which aims to standardize locations for user-
310 specific configuration and data files.
311 XDG_CONFIG_HOME
313 The preferred directory for configuration files. Defaults to
314 $HOME/.config.
315 XDG_DATA_HOME
317 The preferred directory for data files. Defaults to
318 $HOME/.local/share.
319 XDG_CONFIG_DIRS
321 A colon ':' separated, preference ordered list of base directories
322 for configuration files in addition to $XDG_CONFIG_HOME. Defaults
323 to /etc/xdg. If multiple configuration files are found in this
324 path, they will all be read by the ConfigParser class (see also
325 CONFIGURATION above).
326 XDG_DATA_DIRS
328 A colon ':' separated, preference ordered list of base directories
329 for data files. Defaults to /usr/local/share/:/usr/share/. Only
330 the first matching file is used.
331
333 rss2email was started by Aaron Swartz, and is currently maintained by a
334 group of people. For a more complete list of contributors, see the
335 AUTHORS file in the rss2email distribution.
336
338 Report bugs by creating an issue at
339 ⟨https://github.com/rss2email/rss2email⟩.
340 R2E(1)