.\" Generated by scdoc  1.11.2
.\" Complete documentation for this program is not available as a GNU info page
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.nh
.ad l
.\" Begin generated content:
.TH "NEWSRAFT" "1" "2023-07-04"
.P
.SH NAME
.P
newsraft - feed reader for terminal
.P
.SH SYNOPSIS
.P
\fBnewsraft\fR [\fB-f\fR \fIFILE1\fR] [\fB-c\fR \fIFILE2\fR] [\fB-d\fR \fIFILE3\fR] [\fB-l\fR \fIFILE4\fR] [\fB-p\fR] [\fB-v\fR] [\fB-h\fR]
.P
.SH DESCRIPTION
.P
Newsraft is a small text based program for reading syndication feeds - it
enables you to obtain content from many blogs and platforms and view all this
via one single interface in an efficient and streamlined manner.\&
.P
.SH OPTIONS
.P
\fB-f\fR \fIFILE\fR
.RS 4
Force use of \fIFILE\fR as \fBfeeds\fR file.\&
.P
.RE
\fB-c\fR \fIFILE\fR
.RS 4
Force use of \fIFILE\fR as \fBconfig\fR file.\&
.P
.RE
\fB-d\fR \fIFILE\fR
.RS 4
Force use of \fIFILE\fR as \fBdatabase\fR file.\&
.P
.RE
\fB-l\fR \fIFILE\fR
.RS 4
Write log information to \fIFILE\fR.\&
.P
.RE
\fB-p\fR
.RS 4
Purge feeds not specified in the \fBfeeds\fR file.\&
.P
.RE
\fB-v\fR
.RS 4
Print version information.\&
.P
.RE
\fB-h\fR
.RS 4
Print usage information.\&
.P
.RE
.SH STARTER GUIDE
.P
To start using Newsraft you have to create a \fBfeeds\fR file with the list of links
that point to feeds you want to receive news from.\& Format of this file and valid
paths for the location of this file are discussed in the \fBFEEDS FILE\fR section.\&
.P
When your \fBfeeds\fR file is ready, you can launch Newsraft.\& Navigation in the
interface is carried out by the same keys as in the \fBvi\fR(1) text editor.\& There
are only 4 menus you'\&re gonna deal with: \fIsections menu\fR, \fIfeeds menu\fR,
\fIitems menu\fR and \fIpager menu\fR.\&
.P
\fISections menu\fR consists of section entries which are needed to organize feeds
in groups to be able to process them in bulk.\& They are kind of directories for
feeds.\& If you didn'\&t specify any section declarations in your \fBfeeds\fR file then
you will get to the \fIfeeds menu\fR straightaway.\&
.P
\fIFeeds menu\fR consists of feed entries.\& Every feed entry contains news downloaded
from one specific source which you have set in \fBfeeds\fR file.\& To update a single
feed you have to select it and press \fBr\fR.\& If you want to update all feeds,
\fBCtrl-R\fR (or \fB^R\fR for short) will do this fine.\& From \fIfeeds menu\fR you can get to
the \fIitems menu\fR by entering some feed.\&
.P
\fIItems menu\fR consists of feed item entries (i.\& e.\& single pieces of news) which
you get when you update feeds in the previous menu.\& Every feed item entry has
two switchable properties - read state and importance state.\& Keys to force read
state change: \fBd\fR to mark read, \fBD\fR to mark unread, \fB^D\fR to mark everything
read.\& Keys to force importance state change: \fBi\fR to mark important, \fBI\fR to mark
unimportant.\& To view item'\&s content you have to go to \fIpager menu\fR by entering
selected item.\&
.P
\fIPager menu\fR will display some details about selected item and render its
content if it was provided by feed.\& Usually feed item entries have a links
section with one link pointing to a related web page and several links that were
mentioned in the item'\&s content.\& You can copy these links into your clipboard
with \fBy\fR key and open them in your web browser with \fBo\fR key.\& To target a key
action to link with a specific index you have to prefix your key with this
index.\& For example, \fB5y\fR will copy fifth link and \fB17o\fR will open seventeenth
link in the web browser.\& You can also setup custom command bindings to execute
any commands with these links.\& Consider this \fBconfig\fR file:
.P
.RS 4
\fIbind m exec mpv "%l"\fR
.br
\fIbind f exec feh "%l"\fR
.P
.RE
With this you will be able to open any link in \fBmpv\fR(1) and \fBfeh\fR(1) directly
from your terminal!\& Isn'\&t it awesome?\& It is freaking amazing!\&
.P
For both \fIsections menu\fR and \fIfeeds menu\fR there is a special view mode - explore
mode.\& You can toggle this mode by pressing the \fBe\fR key in either \fIsections menu\fR
or \fIfeeds menu\fR.\& What it does is truly miraculous - it lists all the feed item
entries in the current scope (i.\& e.\& explore mode in \fIsections menu\fR will show
you all the feed item entries in the database, while in \fIfeeds menu\fR it will
show you all the feed item entries of feeds in the current \fIfeeds menu\fR).\& This
mode may come in handy when you want to quickly scroll through all the news
without switching between sections and feeds back and forth.\&
.P
.SH CONFIGURATION
.P
.SS FEEDS FILE
.P
This file contains feed entries that Newsraft will display and process.\& There
are 3 types of lines in \fBfeeds\fR file.\&
.P
Feed lines start with a URL.\& After at least one whitespace character, the name
of the feed may be specified - it must be enclosed in double quotes.\& For
example:
.P
.RS 4
\fIhttps://example.\&org/feed.\&xml "Lorem Ipsum Blog"\fR
.P
.RE
Section lines start with @ character.\& After any number of whitespace characters,
the name of the section must be specified.\& For example:
.P
.RS 4
\fI@ Software Releases\fR
.P
.RE
Comment lines start with # character.\& These lines are completely ignored.\& For
example:
.P
.RS 4
\fI# You will gain from using it, for sure.\&\fR
.P
.RE
Both feed and section lines allow you to set an auto update counter at the end,
which will force section or feed related to this line to be automatically
updated at a certain frequency.\& The period of automatic updates is specified in
minutes and must be enclosed in curly braces.\& If you set an auto update counter
for a feed that belongs to a section with an auto update counter set, then the
auto update counter of the feed will take precedence.\& Auto update counter of \fB0\fR
disables automatic updates.\& Let'\&s walk through a small example and see how it
all works.\& Consider this \fBfeeds\fR file:
.P
.RS 4
\fIhttp://example.\&org/feed1.\&xml\fR
.br
\fIhttp://example.\&org/feed2.\&xml {30}\fR
.P
\fI@ Replies {20}\fR
.br
\fIhttp://example.\&org/feed3.\&xml {10}\fR
.br
\fIhttp://example.\&org/feed4.\&xml "Forum notifications"\fR
.P
\fI@ News {60}\fR
.br
\fIhttp://example.\&org/feed5.\&xml\fR
.br
\fIhttp://example.\&org/feed6.\&xml "Local weather" {0}\fR
.P
.RE
In this example, \fIfeed1\fR will never update automatically, \fIfeed2\fR will update
every \fB30\fR minutes, \fIfeed3\fR will update every \fB10\fR minutes, \fIfeed4\fR will update
every \fB20\fR minutes, \fIfeed5\fR will update every \fB60\fR minutes and \fIfeed6\fR will
never update automatically.\&
.P
If you just want to automatically update all feeds then you should set an auto
update counter for \fBGlobal\fR section, but before doing so, think about what load
can be exerted on a servers by frequent downloads from a large number of users.\&
Going for a small auto update counter on \fBGlobal\fR section will most likely
result in a waste of a lot of resources.\& You have been warned.\&
.P
Search precedence:
.RS 4
.ie n \{\
\h'-04'1.\h'+03'\c
.\}
.el \{\
.IP 1. 4
.\}
\fI$XDG_CONFIG_HOME\fR/newsraft/feeds
.RE
.RS 4
.ie n \{\
\h'-04'2.\h'+03'\c
.\}
.el \{\
.IP 2. 4
.\}
\fI$HOME\fR/.\&config/newsraft/feeds
.RE
.RS 4
.ie n \{\
\h'-04'3.\h'+03'\c
.\}
.el \{\
.IP 3. 4
.\}
\fI$HOME\fR/.\&newsraft/feeds

.RE
.P
.SS CONFIG FILE
.P
This file is used to override default settings and bindings of Newsraft.\&
Presence of \fBconfig\fR file is totally optional and Newsraft will work without it
just fine.\& There are 3 types of lines in \fBconfig\fR file.\&
.P
Setting lines start with the \fBset\fR word.\& You can find available settings in the
\fBSETTINGS\fR and \fBCOLOR SETTINGS\fR sections.\& Format of these lines is as follows,
where \fIvalue\fR can be enclosed in single or double quotes:
.P
.RS 4
\fBset\fR setting \fIvalue\fR
.P
.RE
Binding lines start with the \fBbind\fR word.\& They define actions that are performed
when certain keys are pressed.\& Complete list of assigned actions can be found in
the \fBACTIONS\fR section.\& Format of these lines is as follows:
.P
.RS 4
\fBbind\fR key \fIaction\fR
.P
.RE
There is also a way to assign command bindings.\& When a key with assigned command
binding is pressed, the specifiers in the \fIcommand\fR are replaced with values of
the corresponding entry and the command is executed.\& You can find which
specifiers are available in the description of the \fImenu-item-entry-format\fR
setting.\& Format of these lines is as follows:
.P
.RS 4
\fBbind\fR key \fBexec\fR \fIcommand\fR
.P
.RE
In case you want to disable some binding which was set in Newsraft by default,
you can use a line according to this format:
.P
.RS 4
\fBunbind\fR key
.P
.RE
Comment lines start with # character.\& These lines are completely ignored.\& For
example:
.P
.RS 4
\fI# Look closely, the beautiful may be small.\&\fR
.P
.RE
Search precedence:
.RS 4
.ie n \{\
\h'-04'1.\h'+03'\c
.\}
.el \{\
.IP 1. 4
.\}
\fI$XDG_CONFIG_HOME\fR/newsraft/config
.RE
.RS 4
.ie n \{\
\h'-04'2.\h'+03'\c
.\}
.el \{\
.IP 2. 4
.\}
\fI$HOME\fR/.\&config/newsraft/config
.RE
.RS 4
.ie n \{\
\h'-04'3.\h'+03'\c
.\}
.el \{\
.IP 3. 4
.\}
\fI$HOME\fR/.\&newsraft/config

.RE
.P
.SS DATABASE FILE
.P
This file stores everything you download from feeds in \fBsqlite3\fR(1) format.\&
Although you now know the format in which the data is stored, it is highly
recommended to avoid modifying the database manually - things will break and
it will be very sad.\&
.P
Search precedence:
.RS 4
.ie n \{\
\h'-04'1.\h'+03'\c
.\}
.el \{\
.IP 1. 4
.\}
\fI$XDG_DATA_HOME\fR/newsraft/newsraft.\&sqlite3
.RE
.RS 4
.ie n \{\
\h'-04'2.\h'+03'\c
.\}
.el \{\
.IP 2. 4
.\}
\fI$HOME\fR/.\&local/share/newsraft/newsraft.\&sqlite3
.RE
.RS 4
.ie n \{\
\h'-04'3.\h'+03'\c
.\}
.el \{\
.IP 3. 4
.\}
\fI$HOME\fR/.\&newsraft/newsraft.\&sqlite3

.RE
.P
.SH SETTINGS
.P
\fIscrolloff\fR (default: \fB0\fR)
.RS 4
Minimal number of list menu entries to keep above and below the selected
entry.\& If you set it to a very large value the selected entry will always be
in the middle of the list menu (except for start and end of the list menu).\&
.P
.RE
\fIitems-count-limit\fR (default: \fB0\fR)
.RS 4
Maximum number of items stored in one feed.\& Zero disables the limit.\&
.P
.RE
\fIupdate-threads-count\fR (default: \fB0\fR)
.RS 4
Maximum number of update processes running simultaneously.\& If set to zero,
value of the setting is set to the number of CPU cores available.\& You may want
to set this setting to a lower value in cases of a slow network connection
where parallel downloads can slow down the update process.\& If set to a value
greater than the number of CPU cores available, it will be implicitly reduced
to the number of CPU cores to avoid performance issues.\&
.P
.RE
\fIopen-in-browser-command\fR (default: \fB${BROWSER:-xdg-open} "%l"\fR)
.RS 4
Shell command for opening URL in a web browser.\& The URL to be opened is put
in place where \fB%l\fR specifier is located.\&
.P
.RE
\fIcopy-to-clipboard-command\fR (default: \fBauto\fR)
.RS 4
Shell command for copying text to clipboard.\& All copied data is sent to the
standard input of the command.\& If it is set to \fB"auto"\fR, then Newsraft will
set the setting value depending on the environment variables: \fB"wl-copy"\fR
command will be set if environment variable WAYLAND_DISPLAY is present and
\fB"xclip -selection clipboard"\fR command will be set if environment variable
DISPLAY is present, otherwise \fB"false"\fR command will be set.\&
.P
.RE
\fIproxy\fR (default: \fB""\fR)
.RS 4
Sets the proxy to use for the network requests.\& It must be either a hostname
or dotted numerical IPv4 address.\& To specify IPv6 address you have to enclose
it within square brackets.\& Port number can be set by appending :PORT to the
end of setting value.\& By default proxy protocol is considered HTTP, but you
can set a different one by prepending SCHEME:// to the setting value.\&
.P
.RE
\fIproxy-user\fR (default: \fB""\fR)
.RS 4
User for authentication with the proxy server.\&
.P
.RE
\fIproxy-password\fR (default: \fB""\fR)
.RS 4
Password for authentication with the proxy server.\&
.P
.RE
\fIglobal-section-name\fR (default: \fBGlobal\fR)
.RS 4
Name of the section that contains all feeds.\&
.P
.RE
\fIitem-formation-order\fR (default: \fBfeed,title,authors,date,max-content\fR)
.RS 4
Sets the order in which the data of item entry is formed for viewing in a
pager.\& Possible fields are: \fBfeed\fR, \fBtitle\fR, \fBlink\fR, \fBdate\fR, \fBauthors\fR,
\fBcontributors\fR, \fBeditors\fR and \fBmax-content\fR.\&
.P
.RE
\fIcontent-date-format\fR (default: \fB%a, %d %b %Y %H:%M:%S %z\fR)
.RS 4
Date format in the content view.\& Specifier values correspond to the
\fBstrftime\fR(3) format.\&
.P
.RE
\fIlist-entry-date-format\fR (default: \fB%b %d\fR)
.RS 4
Date format of the list entries.\& Specifier values correspond to the
\fBstrftime\fR(3) format.\&
.P
.RE
\fImenu-section-entry-format\fR (default: \fB%5.\&0u @ %t\fR)
.RS 4
Format of the section list entries.\& Specifiers are as follows:
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBn\fR - index number;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBu\fR - unread items count;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBt\fR - section title.\&

.RE
.P
.RE
\fImenu-feed-entry-format\fR (default: \fB%5.\&0u │ %o\fR)
.RS 4
Format of the feed list entries.\& Specifiers are as follows:
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBn\fR - index number;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBu\fR - unread items count;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBl\fR - feed link;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBt\fR - feed title;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBo\fR - feed title if set, feed link otherwise.\&

.RE
.P
.RE
\fImenu-item-entry-format\fR (default: \fB" %u │ %d │ %o"\fR)
.RS 4
Format of the item list entries.\& Specifiers are as follows:
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBn\fR - index number;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBu\fR - "N" if item is unread, " " otherwise;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBd\fR - update date formatted according to \fIlist-entry-date-format\fR;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBl\fR - item link;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBt\fR - item title;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBo\fR - item title if set, item link otherwise;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBL\fR - feed link;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBT\fR - feed title;
.RE
.RS 4
.ie n \{\
\h'-04'\(bu\h'+03'\c
.\}
.el \{\
.IP \(bu 4
.\}
\fBO\fR - feed title if set, feed link otherwise.\&

.RE
.P
.RE
\fImenu-explore-item-entry-format\fR (default: \fB" %u │ %d │ %-28.\&28O │ %o"\fR)
.RS 4
Format of the item list entries in explore mode.\& Specifiers are the same as
in \fImenu-item-entry-format\fR.\&
.P
.RE
\fIsections-menu-paramount-explore\fR (default: \fBfalse\fR)
.RS 4
Enables explore mode in sections menu by default.\&
.P
.RE
\fIfeeds-menu-paramount-explore\fR (default: \fBfalse\fR)
.RS 4
Enables explore mode in feeds menu by default.\&
.P
.RE
\fIinitial-unread-first-sorting\fR (default: \fBfalse\fR)
.RS 4
Enables unread first sorting in items menu by default.\&
.P
.RE
\fImark-item-read-on-hover\fR (default: \fBfalse\fR)
.RS 4
Mark every item that gets selected as read.\&
.P
.RE
\fIanalyze-database-on-startup\fR (default: \fBtrue\fR)
.RS 4
Run "ANALYZE" SQLite command on the database every time you start Newsraft.\&
It gathers statistics about database and uses it to optimize some queries
making runtime faster.\&
.P
.RE
\fIclean-database-on-startup\fR (default: \fBfalse\fR)
.RS 4
Run "VACUUM" SQLite command on the database every time you start Newsraft.\&
It rebuilds the database file by packing it into a minimal amount of disk space.\&
This can significantly increase startup time.\&
.P
.RE
\fIdownload-timeout\fR (default: \fB10\fR)
.RS 4
Maximum time in seconds that you allow Newsraft to download one feed.\& Zero
disables the limit.\&
.P
.RE
\fIdownload-speed-limit\fR (default: \fB0\fR)
.RS 4
Maximum download speed in kilobytes per second (kB/s).\& Zero disables the
limit.\&
.P
.RE
\fIstatus-messages-count-limit\fR (default: \fB1000\fR)
.RS 4
Maximum number of status messages stored in memory.\& If set to zero, status
messages history won'\&t be stored in memory.\&
.P
.RE
\fIsend-user-agent-header\fR (default: \fBtrue\fR)
.RS 4
Attach user-agent header to download requests.\& See \fIuser-agent\fR setting.\&
.P
.RE
\fIuser-agent\fR (default: \fBauto\fR)
.RS 4
User-agent string to attach to download requests.\& If it is set to \fB"auto"\fR,
Newsraft will generate it according to the following format:
.P
.RS 4
\fB"newsraft/"\fR + NEWSRAFT_VERSION + \fB" ("\fR + OS_NAME + \fB")"\fR
.P
.RE
OS_NAME shouldn'\&t be a matter of privacy concern, because on most systems it
contains nothing more like \fB"Linux"\fR or \fB"Darwin"\fR.\& If you want to be sure
of this, check Newsraft log to see how \fIuser-agent\fR is set at startup.\&
.P
.RE
\fIrespect-ttl-element\fR (default: \fBtrue\fR)
.RS 4
Prevents too frequent updates for some feeds.\& The limit is set by the
creators of the feeds in order to save traffic and resources for a very
rarely updated feeds.\& Disabling it is strongly discouraged.\&
.P
.RE
\fIrespect-expires-header\fR (default: \fBtrue\fR)
.RS 4
Prevents feed updates until the expiration date of the previously downloaded
information in order to save traffic and resources.\& Disabling it is strongly
discouraged.\&
.P
.RE
\fIsend-if-none-match-header\fR (default: \fBtrue\fR)
.RS 4
Sends an entity tag corresponding to the previously downloaded information.\&
If the server from which the feed is downloaded contains information with
the same tag, then in order to save traffic and resources, it will reject
the download request.\& Disabling it is strongly discouraged.\&
.P
.RE
\fIsend-if-modified-since-header\fR (default: \fBtrue\fR)
.RS 4
Sends a date corresponding to the last modification of previously downloaded
information.\& If the server from which the feed is downloaded contains
information with the same modification date, then in order to save traffic
and resources, it will reject the download request.\& Disabling it is strongly
discouraged.\&
.P
.RE
.SH COLOR SETTINGS
.P
Color settings are the same settings as above, but they take a certain set of
whitespace separated tokens for their values: one hue word and optional format
attributes.\& Available tokens for hue are \fBdefault\fR, \fBblack\fR, \fBred\fR, \fBgreen\fR,
\fByellow\fR, \fBblue\fR, \fBmagenta\fR, \fBcyan\fR and \fBwhite\fR.\& Available tokens for format
attributes are \fBbold\fR, \fBitalic\fR and \fBunderlined\fR.\&
.P
\fIcolor-status-good-fg\fR (default: \fBgreen\fR)
.RS 4
Text color of status area when reporting success.\&
.P
.RE
\fIcolor-status-good-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of status area when reporting success.\&
.P
.RE
\fIcolor-status-info-fg\fR (default: \fBcyan\fR)
.RS 4
Text color of status area when reporting information.\&
.P
.RE
\fIcolor-status-info-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of status area when reporting information.\&
.P
.RE
\fIcolor-status-fail-fg\fR (default: \fBred\fR)
.RS 4
Text color of status area when reporting failure.\&
.P
.RE
\fIcolor-status-fail-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of status area when reporting failure.\&
.P
.RE
\fIcolor-list-item-fg\fR (default: \fBdefault\fR)
.RS 4
Text color of item list entry.\&
.P
.RE
\fIcolor-list-item-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of item list entry.\&
.P
.RE
\fIcolor-list-item-unread-fg\fR (default: \fByellow\fR)
.RS 4
Text color of unread item list entry.\&
.P
.RE
\fIcolor-list-item-unread-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of unread item list entry.\&
.P
.RE
\fIcolor-list-item-important-fg\fR (default: \fBmagenta\fR)
.RS 4
Text color of important item list entry.\&
.P
.RE
\fIcolor-list-item-important-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of important item list entry.\&
.P
.RE
\fIcolor-list-feed-fg\fR (default: \fBdefault\fR)
.RS 4
Text color of feed list entry.\&
.P
.RE
\fIcolor-list-feed-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of feed list entry.\&
.P
.RE
\fIcolor-list-feed-unread-fg\fR (default: \fByellow\fR)
.RS 4
Text color of unread feed list entry.\&
.P
.RE
\fIcolor-list-feed-unread-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of unread feed list entry.\&
.P
.RE
\fIcolor-list-section-fg\fR (default: \fBdefault\fR)
.RS 4
Text color of section list entry.\&
.P
.RE
\fIcolor-list-section-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of section list entry.\&
.P
.RE
\fIcolor-list-section-unread-fg\fR (default: \fByellow\fR)
.RS 4
Text color of unread section list entry.\&
.P
.RE
\fIcolor-list-section-unread-bg\fR (default: \fBdefault\fR)
.RS 4
Background color of unread section list entry.\&
.P
.RE
.SH ACTIONS
.P
\fIselect-next\fR (default: \fBj\fR, \fBKEY_DOWN\fR)
.br
\fIselect-prev\fR (default: \fBk\fR, \fBKEY_UP\fR)
.br
\fIselect-next-page\fR (default: \fBspace\fR, \fB^F\fR, \fBKEY_NPAGE\fR)
.br
\fIselect-prev-page\fR (default: \fB^B\fR, \fBKEY_PPAGE\fR)
.br
\fIselect-first\fR (default: \fBg\fR, \fBKEY_HOME\fR)
.br
\fIselect-last\fR (default: \fBG\fR, \fBKEY_END\fR)
.br
\fIjump-to-next\fR (default: \fBJ\fR)
.br
\fIjump-to-prev\fR (default: \fBK\fR)
.br
\fIjump-to-next-unread\fR (default: \fBn\fR)
.br
\fIjump-to-prev-unread\fR (default: \fBN\fR)
.br
\fIjump-to-next-important\fR (default: \fBp\fR)
.br
\fIjump-to-prev-important\fR (default: \fBP\fR)
.br
\fIsorting-method-next\fR (default: \fBs\fR)
.br
\fIsorting-method-prev\fR (default: \fBS\fR)
.br
\fItoggle-unread-first-sorting\fR (default: \fBu\fR)
.br
\fIenter\fR (default: \fBl\fR, \fB^J\fR, \fBKEY_RIGHT\fR, \fBKEY_ENTER\fR)
.br
\fIreload\fR (default: \fBr\fR)
.br
\fIreload-all\fR (default: \fB^R\fR)
.br
\fImark-read\fR (default: not set)
.br
\fImark-read-and-jump-to-next\fR (default: \fBd\fR)
.br
\fImark-read-and-jump-to-next-unread\fR (default: not set)
.br
\fImark-unread\fR (default: not set)
.br
\fImark-unread-and-jump-to-next\fR (default: \fBD\fR)
.br
\fImark-read-all\fR (default: \fB^D\fR)
.br
\fImark-unread-all\fR (default: not set)
.br
\fImark-important\fR (default: \fBi\fR)
.br
\fImark-unimportant\fR (default: \fBI\fR)
.br
\fItoggle-explore-mode\fR (default: \fBe\fR)
.br
\fIstatus-history-menu\fR (default: \fBv\fR)
.br
\fIopen-in-browser\fR (default: \fBo\fR)
.br
\fIcopy-to-clipboard\fR (default: \fBy\fR, \fBc\fR)
.br
\fIquit\fR (default: \fBh\fR, \fBq\fR, \fBKEY_LEFT\fR, \fBKEY_BACKSPACE\fR)
.br
\fIquit-hard\fR (default: \fBQ\fR)
.P
.SH FORMATS SUPPORT
.P
Data formats of feeds which Newsraft recognizes.\& Not the whole functionality of
these formats is implemented, but only the functionality that is most likely to
carry the most essential information.\&
.P
\fIRSS 2.\&0\fR, \fI1.\&1\fR, \fI1.\&0\fR, \fI0.\&94\fR, \fI0.\&93\fR, \fI0.\&92\fR, \fI0.\&91\fR, \fI0.\&9\fR
.br
\fIAtom 1.\&0\fR
.br
\fIRSS Content Module\fR
.br
\fIMedia RSS\fR
.br
\fIDublinCore 1.\&1 Elements\fR
.br
\fIJSON Feed\fR
.P
.SH ENVIRONMENT
.P
Since all Newsraft'\&s interactions with the network occur through the
\fBlibcurl\fR(3) library, all environment variables taken into account by
\fBlibcurl\fR(3) can be set for Newsraft as well.\& You can learn more about the
environment variables that \fBlibcurl\fR(3) understands on \fBlibcurl-env\fR(3).\&
.P
.SS XDG_CONFIG_HOME
.P
Directory for applications to store their configuration.\&
.P
.SS XDG_DATA_HOME
.P
Directory for applications to store their data.\&
.P
.SS HOME
.P
Home directory of your user.\&
.P
.SS BROWSER
.P
Web browser of your user.\&
.P
.SS WAYLAND_DISPLAY
.P
Identifier of the Wayland graphics display.\&
.P
.SS DISPLAY
.P
Identifier of the X graphics display.\&
.P
.SS NO_COLOR
.P
Setting that forcibly makes the interface monochrome when set.\&
.P
.SH SEE ALSO
.P
\fBvi\fR(1), \fBmpv\fR(1), \fBfeh\fR(1), \fBsqlite3\fR(1), \fBstrftime\fR(3), \fBlibcurl\fR(3), \fBlibcurl-env\fR(3)
.P
.SH BUGS
.P
Don'\&t be ridiculous.\&.\&.\&
.P
.SH AUTHOR
.P
Grigory Kirillov <txgk@bk.\&ru>
