~ubuntu-branches/ubuntu/maverick/newsbeuter/maverick : revision 6

1

<?xml version="1.0" encoding="UTF-8"?>

2

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">

3

<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Newsbeuter RSS Feedreader</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.68.1" /></head><body><div class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="id2409058"></a>The Newsbeuter RSS Feedreader</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Andreas</span> <span class="surname">Krennmair</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:ak@synflood.at">ak@synflood.at</a>></code></p></div></div></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id2494811">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id2494832">Why "Newsbeuter"?</a></span></dt></dl></dd><dt><span class="section"><a href="#id2494856">Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#id2494866">Downloading Newsbeuter</a></span></dt><dt><span class="section"><a href="#id2456978">Dependencies</a></span></dt><dt><span class="section"><a href="#id2457084">Compiling and Installing</a></span></dt></dl></dd><dt><span class="section"><a href="#id2457095">First Steps</a></span></dt><dd><dl><dt><span class="section"><a href="#id2505535">Example Configuration</a></span></dt><dt><span class="section"><a href="#id2505562">Configuring Colors</a></span></dt><dt><span class="section"><a href="#id2505820">Migrating from other RSS Feed Readers</a></span></dt></dl></dd><dt><span class="section"><a href="#id2505966">Advanced Features</a></span></dt><dd><dl><dt><span class="section"><a href="#id2505972">Tagging</a></span></dt><dt><span class="section"><a href="#id2506052">Scripts and Filters (Snownews Extensions)</a></span></dt><dt><span class="section"><a href="#id2506173">Bookmarking</a></span></dt><dt><span class="section"><a href="#id2506210">Command Line</a></span></dt><dt><span class="section"><a href="#id2506445">Filter Language</a></span></dt><dt><span class="section"><a href="#id2507051">Killfiles</a></span></dt><dt><span class="section"><a href="#id2507112">Query Feeds</a></span></dt><dt><span class="section"><a href="#id2507224">Bloglines Synchronization</a></span></dt><dt><span class="section"><a href="#id2507351">OPML Online Subscription Mode</a></span></dt><dt><span class="section"><a href="#id2507396">Flagging Articles</a></span></dt><dt><span class="section"><a href="#id2507455">Macro Support</a></span></dt><dt><span class="section"><a href="#id2507495">Format Strings</a></span></dt><dt><span class="section"><a href="#id2508378">Using SQLite Triggers with newsbeuter</a></span></dt></dl></dd><dt><span class="section"><a href="#id2508532">Feedback</a></span></dt><dt><span class="section"><a href="#id2508566">License</a></span></dt></dl></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2494811"></a>Introduction</h2></div></div></div><p>Newsbeuter is an RSS feedreader. RSS is a number of widely-used XML formats to

3

<html xmlns="http://www.w3.org/1999/xhtml"><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /><title>The Newsbeuter RSS Feedreader</title><link rel="stylesheet" href="./docbook-xsl.css" type="text/css" /><meta name="generator" content="DocBook XSL Stylesheets V1.68.1" /></head><body><div class="article" lang="en" xml:lang="en"><div class="titlepage"><div><div><h1 class="title"><a id="id2409058"></a>The Newsbeuter RSS Feedreader</h1></div><div><div class="author"><h3 class="author"><span class="firstname">Andreas</span> <span class="surname">Krennmair</span></h3><div class="affiliation"><div class="address"><p><code class="email"><<a href="mailto:ak@newsbeuter.org">ak@newsbeuter.org</a>></code></p></div></div></div></div></div><hr /></div><div class="toc"><p><b>Table of Contents</b></p><dl><dt><span class="section"><a href="#id2494811">Introduction</a></span></dt><dd><dl><dt><span class="section"><a href="#id2494832">Why "Newsbeuter"?</a></span></dt></dl></dd><dt><span class="section"><a href="#id2494856">Installation</a></span></dt><dd><dl><dt><span class="section"><a href="#id2494866">Downloading Newsbeuter</a></span></dt><dt><span class="section"><a href="#id2456979">Dependencies</a></span></dt><dt><span class="section"><a href="#id2457083">Compiling and Installing</a></span></dt></dl></dd><dt><span class="section"><a href="#id2457095">First Steps</a></span></dt><dd><dl><dt><span class="section"><a href="#id2505806">Example Configuration</a></span></dt><dt><span class="section"><a href="#id2505833">Configuring Colors</a></span></dt><dt><span class="section"><a href="#id2506090">Migrating from other RSS Feed Readers</a></span></dt></dl></dd><dt><span class="section"><a href="#id2506237">Advanced Features</a></span></dt><dd><dl><dt><span class="section"><a href="#id2506243">Tagging</a></span></dt><dt><span class="section"><a href="#id2506323">Scripts and Filters (Snownews Extensions)</a></span></dt><dt><span class="section"><a href="#id2506444">Bookmarking</a></span></dt><dt><span class="section"><a href="#id2506481">Command Line</a></span></dt><dt><span class="section"><a href="#id2506716">Filter Language</a></span></dt><dt><span class="section"><a href="#id2507322">Killfiles</a></span></dt><dt><span class="section"><a href="#id2507383">Query Feeds</a></span></dt><dt><span class="section"><a href="#id2507495">Bloglines Synchronization</a></span></dt><dt><span class="section"><a href="#id2507622">OPML Online Subscription Mode</a></span></dt><dt><span class="section"><a href="#id2507667">Flagging Articles</a></span></dt><dt><span class="section"><a href="#id2507726">Macro Support</a></span></dt><dt><span class="section"><a href="#id2507766">Format Strings</a></span></dt><dt><span class="section"><a href="#id2508195">Highlighting Text</a></span></dt><dt><span class="section"><a href="#id2508249">Podcast Support</a></span></dt><dt><span class="section"><a href="#id2508664">Using SQLite Triggers with newsbeuter</a></span></dt></dl></dd><dt><span class="section"><a href="#id2508819">Feedback</a></span></dt><dt><span class="section"><a href="#id2508852">License</a></span></dt></dl></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2494811"></a>Introduction</h2></div></div></div><p>Newsbeuter is an RSS feedreader. RSS is a number of widely-used XML formats to

4

transmit, publish and syndicate articles, for example news or blog articles.

5

Newsbeuter is designed to be used on text terminals on Unix or Unix-like

6

systems such as Linux, FreeBSD or Mac OS X. NetBSD is currently not supported,

10

idea goes to Clifford Wolf, who submitted it to a little competiton that was

11

started when I got aware that the original name would violate French and

12

European registered trademarks.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2494856"></a>Installation</h2></div></div></div><p>This chapter describes how to compile and install newsbeuter from source.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2494866"></a>Downloading Newsbeuter</h3></div></div></div><p>Newsbeuter is available as source package. Simply go to

13

<a href="http://synflood.at/newsbeuter.html" target="_top">http://synflood.at/newsbeuter.html</a> and download the latest source package,

13

<a href="http://www.newsbeuter.org/" target="_top">http://www.newsbeuter.org/</a> and download the latest source package,

14

which is usually in the .tar.gz file format. Alternatively, you can check out

15

the latest development source tree from the newsbeuter SVN repository by

16

running the following command on the commandline:</p><p>svn co http://bereshit.synflood.at/svn/noos/trunk</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2456978"></a>Dependencies</h3></div></div></div><p>Newsbeuter depends on a number of libraries to function correctly. This table

16

running the following command on the commandline:</p><p>svn co http://bereshit.synflood.at/svn/noos/trunk</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2456979"></a>Dependencies</h3></div></div></div><p>Newsbeuter depends on a number of libraries to function correctly. This table

17

lists these dependencies. Please be aware that the list libraries may

18

themselves depend on other libraries. These dependencies are not listed here.

19

Please also be aware that you need a recent C++ compiler. Currently, newsbeuter

20

has only been tested with GCC.</p><div class="itemizedlist"><ul type="disc"><li>

21

STFL (version 0.18 or newer): <a href="http://www.clifford.at/stfl/" target="_top">http://www.clifford.at/stfl/</a>

21

STFL (version 0.19 or newer): <a href="http://www.clifford.at/stfl/" target="_top">http://www.clifford.at/stfl/</a>

22

</li><li>

23

SQLite 3 (version 3.4 or newer): <a href="http://www.sqlite.org/" target="_top">http://www.sqlite.org/</a>

23

SQLite 3 (version 3.5 or newer): <a href="http://www.sqlite.org/" target="_top">http://www.sqlite.org/</a>

24

</li><li>

25

libcurl: <a href="http://curlm.haxx.se/download.html" target="_top">http://curlm.haxx.se/download.html</a>

26

</li><li>

30

</li></ul></div><p>If you intend to modify the filter language parser, you will also need Coco/R for C++,

31

which you can download from <a href="http://www.ssw.uni-linz.ac.at/coco/" target="_top">http://www.ssw.uni-linz.ac.at/coco/</a>. The Coco/R binary

32

must be installed as "coco-cpp" in your PATH. Debian users only need to install

33

the package "coco-cpp".</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2457084"></a>Compiling and Installing</h3></div></div></div><p>After you've downloaded and installed the dependencies mentioned above, you can

33

the package "coco-cpp".</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2457083"></a>Compiling and Installing</h3></div></div></div><p>After you've downloaded and installed the dependencies mentioned above, you can

34

start compiling and installing newsbeuter. To compile newsbeuter, simply run

35

"make" in the source tree. After a short time, this should complete

36

successfully, and you can go on with installation by running "make install". By

38

directory. You can provide an alternative installation path using the prefix

39

parameter, e.g. running "make install prefix=/opt/newsbeuter" will install the

40

binary to the directory /opt/newsbeuter/bin.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2457095"></a>First Steps</h2></div></div></div><p>After you've installed newsbeuter, you can run it for the first time by typing

41

"newsbeuter" on your command prompt. This will bring you the following message:</p><pre class="literallayout">Error: no URLs configured. Please fill the file /Users/ak/.newsbeuter/urls with RSS feed URLs or import an OPML file.</pre><pre class="literallayout">newsbeuter 0.8

41

"newsbeuter" on your command prompt. This will bring you the following message:</p><pre class="literallayout">Error: no URLs configured. Please fill the file /home/ak/.newsbeuter/urls with RSS feed URLs or import an OPML file.</pre><pre class="literallayout">newsbeuter 0.8

42

usage: ./newsbeuter [-i <file>|-e] [-u <urlfile>] [-c <cachefile>] [-h]

43

-r refresh feeds on start

44

-e export OPML feed to stdout

100

</td><td style="border-bottom: 1px solid ; " align="left">

101

always-display-description true

102

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

103

always-download

104

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

105

<rssurl> [<rssurl>]

106

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

107

n/a

108

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

109

The parameters of this configuration command are one or more RSS URLs. These URLs will always get downloaded, regardless of their Last-Modified timestamp.

110

</td><td style="border-bottom: 1px solid ; " align="left">

111

always-download "http://www.n-tv.de/23.rss"

112

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

103

113

article-sort-order

104

114

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

105

115

<sortfield>[-<direction>]

186

196

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

187

197

lynx

188

198

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

189

Set the browser command to use when opening an article in the browser.

199

Set the browser command to use when opening an article in the browser. If <browser-command> contains %u, it will be used as complete commandline and %u will be replaced with the URL that shall be opened.

190

200

</td><td style="border-bottom: 1px solid ; " align="left">

191

browser w3m

201

browser "w3m %u"

192

202

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

193

203

cache-file

194

204

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

250

260

</td><td style="border-bottom: 1px solid ; " align="left">

251

261

define-filter "all feeds with <span class="emphasis"><em>fun</em></span> tag" "tags # \"fun\""

252

262

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

263

display-article-progress

264

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

265

[yes/no]

266

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

267

yes

268

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

269

If set to yes, then a read progress (in percent) is displayed in the article view. Otherwise, no read progress is displayed.

270

</td><td style="border-bottom: 1px solid ; " align="left">

271

display-article-progress no

272

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

273

download-retries

274

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

275

276

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

277

1

278

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

279

How many times newsbeuter shall try to successfully download a feed before giving up. This is an option to improve the success of downloads on slow and shaky connections such as via a TOR proxy.

280

</td><td style="border-bottom: 1px solid ; " align="left">

281

download-retries 4

282

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

283

download-timeout

284

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

285

286

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

287

30

288

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

289

The number of seconds newsbeuter shall wait when downloading a feed before giving up. This is an option to improve the success of downloads on slow and shaky connections such as via a TOR proxy.

290

</td><td style="border-bottom: 1px solid ; " align="left">

291

download-timeout 60

292

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

253

293

error-log

254

294

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

255

295

<path>

270

310

</td><td style="border-bottom: 1px solid ; " align="left">

271

311

feedlist-format " %n %4i - %11u -%> %t"

272

312

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

313

goto-next-feed

314

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

315

[yes/no]

316

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

317

yes

318

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

319

If set to yes, then the next-unread and prev-unread keys will search in other feeds for unread articles if all articles in the current feed are read. If set to no, then the next-unread and prev-unread keys will stop in the current feed.

320

</td><td style="border-bottom: 1px solid ; " align="left">

321

goto-next-feed no

322

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

323

highlight

324

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

325

<target> <regex> <fgcolor> [<bgcolor> [<attribute> …]]

326

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

327

n/a

328

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

329

With this command, you can highlight text parts in the feed list, the article list and the article view. For a detailed documentation, see the chapter on highlighting.

330

</td><td style="border-bottom: 1px solid ; " align="left">

331

highlight all "newsbeuter" red

332

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

273

333

html-renderer

274

334

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

275

335

<path>

430

490

</td><td style="border-bottom: 1px solid ; " align="left">

431

491

reload-time 120

432

492

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

493

reset-unread-on-update

494

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

495

<url> …

496

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

497

n/a

498

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

499

With this configuration command, you can provide a list of RSS feed URLs for whose articles the unread flag will be reset if an article has been updated, i.e. its content has been changed. This is especially useful for RSS feeds where single articles are updated after publication, and you want to be notified of the updates.

500

</td><td style="border-bottom: 1px solid ; " align="left">

501

reset-unread-on-update "http://blog.fefe.de/rss.xml?html"

502

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

433

503

save-path

434

504

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

435

505

<path>

440

510

</td><td style="border-bottom: 1px solid ; " align="left">

441

511

save-path "~/Saved Articles"

442

512

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

513

show-keymap-hint

514

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

515

[yes/no]

516

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

517

yes

518

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

519

If no, then the keymap hints on the bottom of screen will not be displayed.

520

</td><td style="border-bottom: 1px solid ; " align="left">

521

show-keymap-hint no

522

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

443

523

show-read-feeds

444

524

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

445

525

[yes/no]

450

530

</td><td style="border-bottom: 1px solid ; " align="left">

451

531

show-read-feeds no

452

532

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

533

show-read-articles

534

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

535

[yes/no]

536

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

537

yes

538

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

539

If yes, then all articles of a feed are listed in the article list. If no, then only unread articles are listed.

540

</td><td style="border-bottom: 1px solid ; " align="left">

541

show-read-articles no

542

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

453

543

suppress-first-reload

454

544

</td><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

455

545

[yes/no]

509

599

If set to a non-zero-length string, this value will be used as HTTP User-Agent header for all HTTP requests.

510

600

</td><td style="" align="left">

511

601

user-agent "Lynx/2.8.5rel.1 libwww-FM/2.14"

512

</td></tr></tbody></table></div><div class="table"><a id="id2504820"></a><p class="title"><b>Table 2. Available Operations</b></p><table summary="Available Operations" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

602

</td></tr></tbody></table></div><div class="table"><a id="id2505091"></a><p class="title"><b>Table 2. Available Operations</b></p><table summary="Available Operations" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

513

603

Operation:Default key:Description

514

604

</th><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

515

605

749

839

DOWN (down cursor)

750

840

</li><li>

751

841

ESC (Esc key)

752

</li></ul></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505535"></a>Example Configuration</h3></div></div></div><pre class="literallayout"># a comment

842

</li></ul></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505806"></a>Example Configuration</h3></div></div></div><pre class="literallayout"># a comment

753

843

max-items 100 # such comments are possible, too

754

844

browser links

755

845

show-read-feeds no</pre><pre class="literallayout">unbind-key R

756

bind-key ^R reload-all</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505562"></a>Configuring Colors</h3></div></div></div><p>It is possible to configure custom color settings in newsbeuter. The basic configuration

846

bind-key ^R reload-all</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505833"></a>Configuring Colors</h3></div></div></div><p>It is possible to configure custom color settings in newsbeuter. The basic configuration

757

847

syntax is:</p><pre class="literallayout">color <element> <foreground color> <background color> [<attribute> ...]</pre><p>This means that if you configure colors for a certain element, you need to provide

758

848

a foreground color and a background color as a minimum. The following colors are

759

849

supported:</p><div class="itemizedlist"><ul type="disc"><li>

805

895

listnormal white black

806

896

listfocus yellow blue bold

807

897

info yellow blue bold

808

article white black</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505820"></a>Migrating from other RSS Feed Readers</h3></div></div></div><p>It is very likely that you have used other RSS feed readers before. In this

898

article white black</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506090"></a>Migrating from other RSS Feed Readers</h3></div></div></div><p>It is very likely that you have used other RSS feed readers before. In this

809

899

case, it is practical to migrate the previous configuration to newsbeuter. The

810

900

vast amount of RSS feed readers allows the export of subscriptions via OPML

811

901

files. OPML is an XML file format that was designed to save outlines, and has

840

930

when you select the tag "Programming" in newsbeuter, you will see all

841

931

subscriptions that were in the "Programming" folder or one of its subfolders

842

932

before. This means that you will lose virtually nothing of your previously

843

configured structure.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2505966"></a>Advanced Features</h2></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2505972"></a>Tagging</h3></div></div></div><p>Newsbeuter comes with the possibility to categorize or "tag", as well call it,

933

configured structure.</p></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2506237"></a>Advanced Features</h2></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506243"></a>Tagging</h3></div></div></div><p>Newsbeuter comes with the possibility to categorize or "tag", as well call it,

844

934

RSS feeds. Every RSS feed can be assigned 0 or more tags. Within newsbeuter, you

845

935

can then select to only show RSS feeds that match a certain tag. That makes it

846

936

easy to categorize your feeds in a flexible and powerful way.</p><p>Usually, the <sub>/.newsbeuter/urls file contains one RSS feed URL per line. To

855

945

http://blog.fefe.de/rss.xml?html RSS feed. Pressing "^T" clears the current tag,

856

946

and again shows all RSS feeds, regardless of their assigned tags.</p><p>A special type of tag are tags that start with the tilde character ("<sub>"). When such

857

947

a tag is found, the feed title is set to the tag name (excluding the </sub> character).

858

With this feature, you can give feeds any title you want in your feed list:</p><pre class="literallayout">http://rss.orf.at/news.xml "~ORF News"</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506052"></a>Scripts and Filters (Snownews Extensions)</h3></div></div></div><p>From version 0.4 on, newsbeuter contains support for Snownews extensions. The

948

With this feature, you can give feeds any title you want in your feed list:</p><pre class="literallayout">http://rss.orf.at/news.xml "~ORF News"</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506323"></a>Scripts and Filters (Snownews Extensions)</h3></div></div></div><p>From version 0.4 on, newsbeuter contains support for Snownews extensions. The

859

949

RSS feed readers Snownews and Liferea share a common way of extending the

860

950

readers with custom scripts. Two mechanisms, namely "execurl" and "filter" type

861

951

scripts, are available and supported by newsbeuter.</p><p>An "execurl" script can be any program that gets executed and whose output is

871

961

the script. Again, if the script requires any parameters, simply quote:</p><pre class="literallayout">"filter:~/bin/filter-script param1 param2:http://url/foobar"</pre><p>In both cases, the tagging feature as described above is still available:</p><pre class="literallayout">exec:~/bin/execurl-script tag1 tag2 "quoted tag"

872

962

filter:~/bin/filter-script:http://some.test/url tag3 tag4 tag5</pre><p>A collection of such extension scripts can be found on this website:

873

963

<a href="http://kiza.kcore.de/software/snownews/snowscripts/extensions" target="_top">http://kiza.kcore.de/software/snownews/snowscripts/extensions</a></p><p>If you want to write your own extensions, refer to this website for further

874

instructions: <a href="http://kiza.kcore.de/software/snownews/snowscripts/writing" target="_top">http://kiza.kcore.de/software/snownews/snowscripts/writing</a></p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506173"></a>Bookmarking</h3></div></div></div><p>Since version 0.7, newsbeuter contains a plugin-based bookmarking system. When a user bookmarks a link (possible

964

instructions: <a href="http://kiza.kcore.de/software/snownews/snowscripts/writing" target="_top">http://kiza.kcore.de/software/snownews/snowscripts/writing</a></p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506444"></a>Bookmarking</h3></div></div></div><p>Since version 0.7, newsbeuter contains a plugin-based bookmarking system. When a user bookmarks a link (possible

875

965

in the article list, in the article view, and in the URL view), he is asked for the URL to bookmark (already

876

966

preset with the URL of the current selection), the bookmark title (in most cases preset with the

877

967

title of the current selection) and the bookmark description. After the question for the description, an

880

970

external file, or storing it to a del.icio.us account). When everything went OK, the plugin simply exits.

881

971

In case something goes wrong while saving the bookmark, it writes out an error message as a single line.

882

972

This error message is then presented to the user from within newsbeuter.</p><p>Newsbeuter comes with an example plugin, which implements a simple tab-separated bookmark file. This

883

example can be found in the "doc" subdirectory.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506210"></a>Command Line</h3></div></div></div><p>Like other text-oriented software, newsbeuter contains an internal commandline to

973

example can be found in the "doc" subdirectory.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506481"></a>Command Line</h3></div></div></div><p>Like other text-oriented software, newsbeuter contains an internal commandline to

884

974

modify configuration variables ad hoc and to run own commands. It provides a flexible

885

975

access to the functionality of newsbeuter which is especially useful for

886

976

advanced users.</p><p>To start the commandline, type ":". You will see a ":" prompt at the bottom of

887

977

the screen, similar to tools like vi(m) or mutt. You can now enter commands.

888

978

Pressing the return key executes the command (possibly giving feedback to the

889

979

user) and closes the commandline. You can cancel entering commands by pressing

890

the ESC key. Currently, the following commands are available:</p><div class="table"><a id="id2506241"></a><p class="title"><b>Table 3. Available Commandline Commands</b></p><table summary="Available Commandline Commands" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

980

the ESC key. Currently, the following commands are available:</p><div class="table"><a id="id2506512"></a><p class="title"><b>Table 3. Available Commandline Commands</b></p><table summary="Available Commandline Commands" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

891

981

Command

892

982

</th><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

893

983

Syntax

943

1033

Jump to the entry with the index <number> (usually seen at the left side of the list). This currently works for the feed list and the article list.

944

1034

</td><td style="" align="left">

945

1035

30

946

</td></tr></tbody></table></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506445"></a>Filter Language</h3></div></div></div><p>Newsbeuter provides a powerful filter language that enables the user to

1036

</td></tr></tbody></table></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2506716"></a>Filter Language</h3></div></div></div><p>Newsbeuter provides a powerful filter language that enables the user to

947

1037

filter the content of many dialogs, such as the feed list or the article

948

1038

list. The basic concept is that every feed and every article has a

949

1039

number of attributes which can then be compared with user-supplied

958

1048

Be aware that only certain attributes work in both dialogs. The table below lists all available

959

1049

attributes and their context, i.e. an attribute that belongs to a feed can only be matched

960

1050

in the feed list, while an attribute that belongs to an article can only be matched in the

961

article list.</p><div class="table"><a id="id2506527"></a><p class="title"><b>Table 4. Available Comparison Operators</b></p><table summary="Available Comparison Operators" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1051

article list.</p><div class="table"><a id="id2506798"></a><p class="title"><b>Table 4. Available Comparison Operators</b></p><table summary="Available Comparison Operators" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

962

1052

Operator

963

1053

</th><th style="border-bottom: 1px solid ; " align="left">

964

1054

Meaning

1002

1092

!#

1003

1093

</td><td style="" align="left">

1004

1094

contains not; the negation of the # operator

1005

</td></tr></tbody></table></div><div class="table"><a id="id2506697"></a><p class="title"><b>Table 5. Available Attributes</b></p><table summary="Available Attributes" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1095

</td></tr></tbody></table></div><div class="table"><a id="id2506968"></a><p class="title"><b>Table 5. Available Attributes</b></p><table summary="Available Attributes" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1006

1096

Attribute

1007

1097

</th><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1008

1098

Context

1118

1208

all tags that are associated with the feed

1119

1209

</td></tr></tbody></table></div><p>Note that it's also possible to filter for feed attributes when you query for

1120

1210

article attributes. This is because every article is internally linked to the

1121

feed from which it was downloaded.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507051"></a>Killfiles</h3></div></div></div><p>Sometimes, a user is confronted with certain content he doesn't want to read,

1211

feed from which it was downloaded.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507322"></a>Killfiles</h3></div></div></div><p>Sometimes, a user is confronted with certain content he doesn't want to read,

1122

1212

e.g. on topics the user is not interested in or articles from certain people he

1123

1213

doesn't want to read. In Usenet, such functionality within software is

1124

1214

traditionally called a "killfile", i.e. based on the content of this "killfile",

1131

1221

previous section). If newsbeuter hits an article in the specified RSS feed that

1132

1222

matches the specified filter expression, then this article is ignored and never

1133

1223

presented to the user. The configuration itself can contain as many

1134

ignore-article commands as desired.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507112"></a>Query Feeds</h3></div></div></div><p>Query feeds are a mechanism of newsbeuter to define custom "meta feeds" by using

1224

ignore-article commands as desired.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507383"></a>Query Feeds</h3></div></div></div><p>Query feeds are a mechanism of newsbeuter to define custom "meta feeds" by using

1135

1225

newsbeuter's built-in filter language. A query feed is a feed that is aggregated

1136

1226

from all currently downloaded articles of all feeds. To narrow down the set of

1137

1227

articles, the user has to specify a filter. Only articles that match this filter

1153

1243

http://domain2.tld/?feed.rss are aggregated into the query feed named "tag1

1154

1244

Articles", but the feed http://domain3.tld/feeds.rss is not.</p><p>Basically, the possibility of what can be realized with query feeds is only

1155

1245

limited by what can be queried from articles and feeds with the filter language

1156

and by your creativity.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507224"></a>Bloglines Synchronization</h3></div></div></div><p><a href="http://www.bloglines.com" target="_top">Bloglines</a> is a web-based RSS feed reader. Newsbeuter

1246

and by your creativity.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507495"></a>Bloglines Synchronization</h3></div></div></div><p><a href="http://www.bloglines.com" target="_top">Bloglines</a> is a web-based RSS feed reader. Newsbeuter

1157

1247

provides a synchronization feature that makes it possible to download unread

1158

1248

articles from Bloglines (which can then be optionally be marked as read). This

1159

1249

is useful in cases where you want to use the web frontend e.g. at work, and use

1171

1261

you sit in a location without connectivity, e.g. a train), you can start

1172

1262

newsbeuter in offline mode:</p><pre class="literallayout">newsbeuter -o</pre><p>With this commandline switch, you can read the articles that you have already

1173

1263

downloaded without any network connectivity. This functionality makes

1174

newsbeuter a true offline client for Bloglines.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507351"></a>OPML Online Subscription Mode</h3></div></div></div><p>The OPML online subscription mode works similar to the Bloglines

1264

newsbeuter a true offline client for Bloglines.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507622"></a>OPML Online Subscription Mode</h3></div></div></div><p>The OPML online subscription mode works similar to the Bloglines

1175

1265

synchronization mode, except that no information about read articles is

1176

1266

synchronized back. When enabled, all feeds that are listed in the feed list

1177

1267

will be taken from an OPML that is downloaded from a freely configurable URL.</p><p>To enable this mode, the following configuration needs to be done:</p><pre class="literallayout">urls-source "opml"

1178

1268

opml-url "<opml url>"</pre><p>"opml" must be specified as source for the feed URLs, and the URL of the OPML

1179

1269

file needs to be specified, too. As with Bloglines synchronization mode, the offline

1180

mode via "newsbeuter -o" also works with OPML online subscription mode.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507396"></a>Flagging Articles</h3></div></div></div><p>To support custom categorization of articles by the user, it is possible to

1270

mode via "newsbeuter -o" also works with OPML online subscription mode.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507667"></a>Flagging Articles</h3></div></div></div><p>To support custom categorization of articles by the user, it is possible to

1181

1271

flag an article. A valid flag is any character from <span class="emphasis"><em>A</em></span> to <span class="emphasis"><em>Z</em></span> and from <span class="emphasis"><em>a</em></span> to

1182

1272

<span class="emphasis"><em>z</em></span>. Every article can be flagged with up to 52 different flags, i.e. every

1183

1273

letter from the Roman alphabet in upper and lower case. Flagging is easy: just

1187

1277

article are always ordered, and when new flags are added, ordering is

1188

1278

immediately restored. This behaviour can also be relied upon when querying

1189

1279

articles via the filter language.</p><p>If an article contains one or more flags, it is marked with an "!" in the

1190

article list. In the article view, all flags (if available) are listed.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507455"></a>Macro Support</h3></div></div></div><p>In newsbeuter, it's possible to define macros to execute more than one command

1280

article list. In the article view, all flags (if available) are listed.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507726"></a>Macro Support</h3></div></div></div><p>In newsbeuter, it's possible to define macros to execute more than one command

1191

1281

at once. A macro is configured using the "macro" configuration command. The

1192

1282

first parameter to "macro" is the key, all parameters afterwards are operations

1193

1283

(as listed in the "Available Operations" table above), optionally with

1194

1284

parameters on their own, separated by the ";" character. Here's a simple

1195

1285

example:</p><pre class="literallayout">macro k open ; reload ; quit</pre><p>When the user presses the macro prefix ("," by default) and then the "k" key,

1196

the three operations "open", "reload" and "quit" will be executed subsequently.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507495"></a>Format Strings</h3></div></div></div><p>Newsbeuter contains a powerful format string system to make it possible for the

1286

the three operations "open", "reload" and "quit" will be executed subsequently.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2507766"></a>Format Strings</h3></div></div></div><p>Newsbeuter contains a powerful format string system to make it possible for the

1197

1287

user to configure the format of various aspects of the application, such as

1198

1288

the format of entries in the feed list or in the article list.</p><p>Format strings are similar to those that are found in the "printf" function in

1199

1289

the C programming language. A format sequence begins with the <span class="emphasis"><em>%</em></span> character,

1210

1300

inserted, otherwise "[format 2]" will be evaluted and inserted. The "&" and

1211

1301

"[format 2]" are optional, i.e. if the identifier's text is empty, then an

1212

1302

empty string will be inserted.</p><p>The following tables show what sequence identifiers are available for which

1213

format:</p><div class="table"><a id="id2507557"></a><p class="title"><b>Table 6. Available Identifiers for feedlist-format</b></p><table summary="Available Identifiers for feedlist-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1303

format:</p><div class="table"><a id="id2507828"></a><p class="title"><b>Table 6. Available Identifiers for feedlist-format</b></p><table summary="Available Identifiers for feedlist-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1214

1304

Identifier

1215

1305

</th><th style="border-bottom: 1px solid ; " align="left">

1216

1306

Meaning

1242

1332

u

1243

1333

</td><td style="" align="left">

1244

1334

"unread/total" field

1245

</td></tr></tbody></table></div><div class="table"><a id="id2507686"></a><p class="title"><b>Table 7. Available Identifiers for articlelist-format</b></p><table summary="Available Identifiers for articlelist-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1335

</td></tr></tbody></table></div><div class="table"><a id="id2507957"></a><p class="title"><b>Table 7. Available Identifiers for articlelist-format</b></p><table summary="Available Identifiers for articlelist-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1246

1336

Identifier

1247

1337

</th><th style="border-bottom: 1px solid ; " align="left">

1248

1338

Meaning

1270

1360

T

1271

1361

</td><td style="" align="left">

1272

1362

If the article list displays articles from different feeds, then this identifier contains the title of the feed to which the article belongs.

1273

</td></tr></tbody></table></div><div class="table"><a id="id2507808"></a><p class="title"><b>Table 8. Available Identifiers for notify-format</b></p><table summary="Available Identifiers for notify-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1363

</td></tr></tbody></table></div><div class="table"><a id="id2508079"></a><p class="title"><b>Table 8. Available Identifiers for notify-format</b></p><table summary="Available Identifiers for notify-format" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1274

1364

Identifier

1275

1365

</th><th style="border-bottom: 1px solid ; " align="left">

1276

1366

Meaning

1286

1376

d

1287

1377

</td><td style="border-bottom: 1px solid ; " align="left">

1288

1378

Number of new unread articles (i.e. that were added through the last reload)

1289

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1379

</td></tr><tr><td style="border-right: 1px solid ; " align="left">

1290

1380

D

1291

</td><td style="border-bottom: 1px solid ; " align="left">

1381

</td><td style="" align="left">

1292

1382

Number of new unread feeds (i.e. that were added through the last reload)

1293

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1294

Examples

1295

</td><td style="border-bottom: 1px solid ; " align="left">

1296

1297

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1298

feedlist-format "%4i %n %11u %t"

1299

</td><td style="border-bottom: 1px solid ; " align="left">

1300

1301

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1302

articlelist-format "%4i %f %D %?T?|%-17T| ?%t"

1303

</td><td style="border-bottom: 1px solid ; " align="left">

1304

1305

</td></tr><tr><td style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1306

notify-format "%d new articles (%n unread articles, %f unread feeds)"

1307

</td><td style="border-bottom: 1px solid ; " align="left">

1308

1309

</td></tr><tr><td style="border-right: 1px solid ; " align="left">

1310

Podcast Support

1311

</td><td style="" align="left">

1312

1313

</td></tr></tbody></table></div><p>A podcast is a media file distributed over the internet using syndication feeds

1383

</td></tr></tbody></table></div><p>Examples:</p><pre class="literallayout">feedlist-format "%4i %n %11u %t"

1384

articlelist-format "%4i %f %D %?T?|%-17T| ?%t"

1385

notify-format "%d new articles (%n unread articles, %f unread feeds)"</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2508195"></a>Highlighting Text</h3></div></div></div><p>Since version 1.0, newsbeuter supports the highlighting of text in the feed

1386

list, the article list and the article view, using regular expressions to

1387

describe patterns to be highlighted. The command syntax goes like this:</p><pre class="literallayout">highlight <target> <regex> <fgcolor> [<bgcolor> [<attribute> ...]]</pre><p>Valid values for <target> are "feedlist", "articlelist", "article" and "all".

1388

When specifying "all", the matching will be done in all three views. The

1389

<regex> must be regular expression, which will be matched case-insensitive

1390

against the text. <fgcolor> and <bgcolor> specify the foreground color resp.

1391

the background color of the matches. You can also specify 0 or more attributes.

1392

You can find a list of valid colors and attributes in the "Configuring Colors"

1393

section.</p><p>Examples for possible highlighting configurations are:</p><pre class="literallayout">highlight all "newsbeuter" red

1394

highlight article "^(Feed|Title|Author|Link|Date):" default default underline

1395

highlight feedlist "http?s://[^ ]+" yellow red bold</pre></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2508249"></a>Podcast Support</h3></div></div></div><p>A podcast is a media file distributed over the internet using syndication feeds

1314

1396

such as RSS, for later playback on portable players or computers. Newsbeuter

1315

1397

contains support for downloading and saving podcasts. This support differs a bit

1316

1398

from other podcast aggregators or "podcatchers" in how it is done.</p><p>Podcast content is transported in RSS feeds via special tags called

1321

1403

the file $HOME/.newsbeuter/queue.</p><p>The user can then use the download manager "podbeuter" to download these files

1322

1404

to a directory on the local filesystem. Podbeuter comes with the newsbeuter

1323

1405

package, and features a look and feel very close to the one of newsbeuter. It

1324

also shares the same configuration file.</p><div class="table"><a id="id2508001"></a><p class="title"><b>Table 9. Podbeuter Configuration Commands</b></p><table summary="Podbeuter Configuration Commands" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1406

also shares the same configuration file.</p><div class="table"><a id="id2508288"></a><p class="title"><b>Table 9. Podbeuter Configuration Commands</b></p><table summary="Podbeuter Configuration Commands" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1325

1407

Configuration Command

1326

1408

</th><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1327

1409

Argument(s)

1361

1443

Specifies the player that shall be used for playback of downloaded files.

1362

1444

</td><td style="" align="left">

1363

1445

player "mp3blaster"

1364

</td></tr></tbody></table></div><div class="table"><a id="id2508161"></a><p class="title"><b>Table 10. Available Operations in Podbeuter</b></p><table summary="Available Operations in Podbeuter" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1446

</td></tr></tbody></table></div><div class="table"><a id="id2508448"></a><p class="title"><b>Table 10. Available Operations in Podbeuter</b></p><table summary="Available Operations in Podbeuter" cellpadding="4px" border="0" style="border-collapse: collapse;border-top: 2px solid #527bbd; border-bottom: 2px solid #527bbd; border-left: 2px solid #527bbd; border-right: 2px solid #527bbd; "><colgroup><col align="left" /><col align="left" /><col align="left" /></colgroup><thead><tr><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1365

1447

Operation

1366

1448

</th><th style="border-right: 1px solid ; border-bottom: 1px solid ; " align="left">

1367

1449

Default key

1419

1501

found podcast download URLs. Then, the user reloads the podcast RSS feeds in

1420

1502

newsbeuter, and after that, he/she uses podbeuter to view the current queue, and

1421

1503

either selectively download certain files or automatically download them all

1422

together by pressing "a" within podbeuter.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2508378"></a>Using SQLite Triggers with newsbeuter</h3></div></div></div><p>This section was kindly provided by <a href="mailto:elrond+newsbeuter(at)samba-tng.org" target="_top">Elrond</a>.</p><p>SQLite, the db used by newsbeuter, supports triggers. These are small

1504

together by pressing "a" within podbeuter.</p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h3 class="title"><a id="id2508664"></a>Using SQLite Triggers with newsbeuter</h3></div></div></div><p>This section was kindly provided by <a href="mailto:elrond+newsbeuter(at)samba-tng.org" target="_top">Elrond</a>.</p><p>SQLite, the db used by newsbeuter, supports triggers. These are small

1423

1505

snippets of SQL that get executed inside the database by the database

1424

1506

engine. They're stored inside the db and the normal user (including

1425

1507

newsbeuter itself) doesn't see them. Just the db seems to do some magic:

1426

1508

Like changing some values when you change another value.</p><p>So what is this good for when looking at newsbeuter? Well first of it's a

1427

1509

hack. The real answer should be to use application logic (do it inside

1428

1510

newsbeuter, not in the db). So: Don't use this, unless you know, what you're

1429

doing, and unless you have some sort of backup.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2508418"></a>Example</h4></div></div></div><p>So after the "don't use it" you still want to know, what one can do? So here's an example.</p><p>Suppose you have a strange feed where the articles become "new" by just

1511

doing, and unless you have some sort of backup.</p><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h4 class="title"><a id="id2508705"></a>Example</h4></div></div></div><p>So after the "don't use it" you still want to know, what one can do? So here's an example.</p><p>Suppose you have a strange feed where the articles become "new" by just

1430

1512

changing their subject, and nothing else changes. The body is just empty, and

1431

1513

the URL keeps the same. This feed really exists. It's the "updated software rss

1432

1514

feed" of some major company and the title just contains the name of the driver

1451

1533

</li></ol></div><p>That's it. newsbeuter (well, its db) now marks articles as unread when their

1452

1534

title changes. And nicely enough this works all inside newsbeuter, no need to

1453

1535

restart it so that it rereads the cache, that magically modifies itself. It

1454

just works.</p></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2508532"></a>Feedback</h2></div></div></div><p>If you want to tell us something related to newsbeuter, don't hesitate to send

1455

an email: ak-newsbeuter@synflood.at</p><p>Alternatively, you can reach the newsbeuter developers on IRC: channel

1536

just works.</p></div></div></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2508819"></a>Feedback</h2></div></div></div><p>If you want to tell us something related to newsbeuter, don't hesitate to send

1537

an email: ak@newsbeuter.org</p><p>Alternatively, you can reach the newsbeuter developers on IRC: channel

1456

1538

#newsbeuter on irc.freenode.net.</p><p>If you want to report newsbeuter bugs, please use this issue tracker:

1457

<a href="http://code.google.com/p/newsbeuter/issues/list" target="_top">http://code.google.com/p/newsbeuter/issues/list</a></p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2508566"></a>License</h2></div></div></div><p>MIT/X Consortium License</p><p>©opyright 2006-2008 Andreas Krennmair <ak@synflood.at></p><p>Permission is hereby granted, free of charge, to any person obtaining a copy of

1539

<a href="http://code.google.com/p/newsbeuter/issues/list" target="_top">http://code.google.com/p/newsbeuter/issues/list</a></p></div><div class="section" lang="en" xml:lang="en"><div class="titlepage"><div><div><h2 class="title" style="clear: both"><a id="id2508852"></a>License</h2></div></div></div><p>MIT/X Consortium License</p><p>©opyright 2006-2008 Andreas Krennmair <ak@newsbeuter.org></p><p>Permission is hereby granted, free of charge, to any person obtaining a copy of

1458

1540

this software and associated documentation files (the "Software"), to deal in

1459

1541

the Software without restriction, including without limitation the rights to

1460

1542

use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies