DESCRIPTION

GETTING STARTED

* * * * * canto-fetch

If you're not a fan of cron, then you can add `canto-fetch -b` to your startup scripts to have canto-fetch run as a daemon on its own.

After you have your configuration file generated, just run `canto` and it will update for you, if canto-fetch hasn't been run already.

COMMAND LINE USAGE

-h/--help

Simple help

-v/--version

Print version

-u/--update

Update feeds before launching client.

-l/--list

List all configured feeds

-a/--checkall

Print number of new items.

-n/--checknew [feed]

Print number of new items in feed.

-o/--opml

Print feeds to stdout as OPML file.

-i/--import [path]

Import feeds from OPML file to your configuration.

-r/--url [URL]

Add feed at URL to your configuration.

-t/--tag [tag]

Set tag for feed added with -r

-D/--dir [path]

Set the configuration directory (default: ~/.canto/)

-C/--conf [path]

Set the configuration file (default: ~/.canto/conf)

-L/--log [path]

Set the log file (default: ~/.canto/log)

-F/--fdir [path]

Set the feed directory (default: ~/.canto/feeds)

-S /--sdir [PATH]

Set the path to execurl scripts (default ~/.canto/scripts/)

INTERNAL USAGE

UP / DOWN or k / j

Select previous or next item. (next_item) (prev_item)

PGUP / PGDOWN or o / l

Goto previous or next tag. (next_tag) (prev_tag)

RIGHT / LEFT

Set item unread or read (just_unread) (just_read)

[ / ]

Cycle through defined filters (prev_filter) (next_filter)

{ / }

Cycle through defined tag filters (prev_feed_filter) (next_feed_filter)

- / =

Cycle through defined tag sorts (prev_tag_sort) (next_tag_sort)

< / >

Cycle through defined tag sets (prev_tagset) (next_tagset)

:

Goto a specific tag (order of the config) (goto_tag)

;

Goto a specific visible tag (goto_reltag)

TAB

Switch focus between list and reader (only useful with dedicated reader space)
    (switch)

h

Display this man page. (help)

Space

Read a story (reader)

g

Use the defined browser to goto the item's URL (goto)

C / V

Collapse/Uncollapse all tags (set_collapse_all) (unset_collapse_all)

c

Collapse/Uncollapse current tag (toggle_collapse_tag)

f

Inline search (inline_search)

m

Toggle item marked/unmark (toggle_mark)

M

Unmark all items (all_unmarked)

n / p

Goto next/previous marked item (next_mark) (prev_mark)

, / .

Goto next/previous unread item (next_unread) (prev_unread)

r / u

Mark tag read/unread (tag_read) (tag_unread)

R / U

Mark all read/unread (all_read) (all_unread)

Ctrl+R

Refresh feeds (force_update)

Ctrl+L

Redraw screen (refresh)

\

Restart Canto (restart)

q

Quit Canto (quit)

READER USAGE

UP / DOWN or k / j

Scroll up/down if content off screen (scroll_up) (scroll_down)

n / p

goto next/previous item without closing reader

l

Enumerate links (toggle_show_links)

g

Choose a link to goto (goto)

CONFIGURATION

FILES

~/.canto/conf.py

Main configuration file. ~/.canto/conf (without the extension) is also checked for compatibility.

~/.canto/log

Everyday log file.

~/.canto/fetchlog

Canto-fetch log file.

~/.canto/feeds/

This is the directory where the stories are recorded.

HOMEPAGE

AUTHOR