Linux Certif

Toute la documentation sur la certification Linux LPI

canto

NAME

Canto - An ncurses RSS reader

DESCRIPTION

Canto is an RSS reader built to be flexible and highly customizable on top of python.

GETTING STARTED

Canto is the client, separate from the fetcher Canto-fetch. In order to update you must invoke canto-fetch on a regular basis. Usually the way to do that is to add a line into your crontab like this:

* * * * * canto-fetch

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.

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

INTERNAL USAGE

Within the program you can use the following (default) keys. These can be changed in your configuration file by using the "key" configuration option.

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 feed filters (prev_feed_filter) (next_feed_filter)

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)

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)

q

Quit Canto (quit)

READER USAGE

Inside the reader, there are a number of different keys. These can be changed with the "reader_key" configuration option.

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

The ~/.canto/conf file is where all of the configuration is. You can start by using the example config below.

EXAMPLE CONFIG

 
 from canto.extra import *
 import os
 
 if os.getenv("TERM") == "linux":
     browser="elinks     text_browser = True
 else:
     browser="firefox     text_browser = False
 
 def my_resize_hook(cfg):
     cfg.columns = cfg.width / 70
 
 resize_hook = my_resize_hook
 select_hook = set_xterm_title
 end_hook = clear_xterm_title
 
 filterlist=[None, show_unread()]
 
 keys['x'] = ["just_read","next_item"]
 keys['1'] = search(".*[Ll]inux.*", regex=True)
 keys['2'] = search("Obama")
 
 addfeed("Slashdot", "http://rss.slashdot.org/slashdot/Slashdot")
 addfeed("OSNews", "http://osnews.com/files/recent.xml")
 addfeed("Damn Interesting", "http://www.damninteresting.com/?feed=rss2")
 addfeed("Reddit", "http://reddit.com/.rss")
 
 

 

FILES

~/.canto/conf

Main configuration file. For advanced usage, see the online configuration documentation: http://codezen.org/canto/config

~/.canto/log

Everyday log file.

~/.canto/fetchlog

Canto-fetch log file.

~/.canto/feeds/

This is the directory where the stories are recorded.

BUGS

None known, but it's not outside of the realm of possibility =P.

HOMEPAGE

http://codezen.org/canto

AUTHOR

Jack Miller <jack@codezen.org>