1Canto(1)                             Canto                            Canto(1)
2
3
4

NAME

6       Canto - An ncurses RSS reader
7

DESCRIPTION

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

GETTING STARTED

14       Canto is the client, separate from the fetcher Canto-fetch. In order to
15       update  you must invoke canto-fetch on a regular basis. Usually the way
16       to do that is to add a line into your crontab like this:
17
18       * * * * * canto-fetch
19
20       If you're not a fan of cron, then you can add `canto-fetch -b` to  your
21       startup scripts to have canto-fetch run as a daemon on its own.
22
23       After  you have your configuration file generated, just run `canto` and
24       it will update for you, if canto-fetch hasn't been run already.
25
26

COMMAND LINE USAGE

28       -h/--help
29              Simple help
30
31
32       -v/--version
33              Print version
34
35
36       -u/--update
37              Update feeds before launching client.
38
39
40       -l/--list
41              List all configured feeds
42
43
44       -a/--checkall
45              Print number of new items.
46
47
48       -n/--checknew [feed]
49              Print number of new items in feed.
50
51
52       -o/--opml
53              Print feeds to stdout as OPML file.
54
55
56       -i/--import [path]
57              Import feeds from OPML file to your configuration.
58
59
60       -r/--url [URL]
61              Add feed at URL to your configuration.
62
63
64       -t/--tag [tag]
65              Set tag for feed added with -r
66
67
68       -D/--dir [path]
69              Set the configuration directory (default: ~/.canto/)
70
71
72       -C/--conf [path]
73              Set the configuration file (default: ~/.canto/conf)
74
75
76       -L/--log [path]
77              Set the log file (default: ~/.canto/log)
78
79
80       -F/--fdir [path]
81              Set the feed directory (default: ~/.canto/feeds)
82
83
84       -S /--sdir [PATH]
85              Set the path to execurl scripts (default ~/.canto/scripts/)
86
87

INTERNAL USAGE

89       Within the program you can use the following (default) keys.  These can
90       be  changed in your configuration file by using the "key" configuration
91       option.
92
93
94       UP / DOWN or k / j
95              Select previous or next item. (next_item) (prev_item)
96
97
98       PGUP / PGDOWN or o / l
99              Goto previous or next tag. (next_tag) (prev_tag)
100
101
102       RIGHT / LEFT
103              Set item unread or read (just_unread) (just_read)
104
105
106       [ / ]  Cycle through defined filters (prev_filter) (next_filter)
107
108
109       { / }  Cycle   through   defined   tag    filters    (prev_feed_filter)
110              (next_feed_filter)
111
112
113       - / =  Cycle through defined tag sorts (prev_tag_sort) (next_tag_sort)
114
115
116       < / >  Cycle through defined tag sets (prev_tagset) (next_tagset)
117
118
119       :      Goto a specific tag (order of the config) (goto_tag)
120
121
122       ;      Goto a specific visible tag (goto_reltag)
123
124
125       TAB    Switch focus between list and reader (only useful with dedicated
126              reader space)
127                  (switch)
128
129
130       h      Display this man page. (help)
131
132
133       Space  Read a story (reader)
134
135
136       g      Use the defined browser to goto the item's URL (goto)
137
138
139       C / V  Collapse/Uncollapse  all  tags  (set_collapse_all)   (unset_col‐
140              lapse_all)
141
142
143       c      Collapse/Uncollapse current tag (toggle_collapse_tag)
144
145
146       f      Inline search (inline_search)
147
148
149       n / p  Goto next/previous marked item (next_mark) (prev_mark)
150
151
152       , / .  Goto next/previous unread item (next_unread) (prev_unread)
153
154
155       r / u  Mark tag read/unread (tag_read) (tag_unread)
156
157
158       R / U  Mark all read/unread (all_read) (all_unread)
159
160
161       Ctrl+R Refresh feeds (force_update)
162
163
164       Ctrl+L Redraw screen (refresh)
165
166
167       q      Quit Canto (quit)
168
169

READER USAGE

171       Inside  the  reader, there are a number of different keys. These can be
172       changed with the "reader_key" configuration option.
173
174
175       UP / DOWN or k / j
176              Scroll up/down if content off screen (scroll_up) (scroll_down)
177
178
179       n / p  goto next/previous item without closing reader
180
181
182       l      Enumerate links (toggle_show_links)
183
184
185       g      Choose a link to goto (goto)
186
187

CONFIGURATION

189       The ~/.canto/conf.py file is where all of the configuration is. You can
190       start  by  reading http://codezen.org/canto/config . If you're updating
191       from  <=  0.6.x  then  you  should  read  http://codezen.org/canto/con‐
192       fig/#upgrading-from-06x .
193
194

FILES

196       ~/.canto/conf.py
197              Main  configuration  file. ~/.canto/conf (without the extension)
198              is also checked for compatibility.
199
200
201       ~/.canto/log
202              Everyday log file.
203
204
205       ~/.canto/fetchlog
206              Canto-fetch log file.
207
208
209       ~/.canto/feeds/
210              This is the directory where the stories are recorded.
211
212

BUGS

214       I'm sure there are some. If you run into a bug (a crash or  bad  behav‐
215       ior),  then  send  please  report  it.  Any of the methods described in
216       http://codezen.org/canto/contact are acceptable. Also,  please  include
217       your configuration and log files with the report.
218
219

HOMEPAGE

221       http://codezen.org/canto
222
223

AUTHOR

225       Jack Miller <jack@codezen.org>
226
227
228
229Version 0.7.4                   17 August 2009                        Canto(1)