Canto-curses(1) General Commands Manual Canto-curses(1)

Canto-curses - An ncurses frontend for canto-daemon

canto-curses (options)

Print version info and exit.
Print usage help
Enable verbose logging (debug)
Change base directory for canto-daemon (default: $XDG_CONFIG_HOME/canto)
Disable all plugins
Enable these plugins (overrides --noplugins)
Disable these plugins
Attempt to connect to address instead of local Unix socket, defaults to loopback (127.0.0.1)
Use port when listening with -a
Append pid to log filename (debug)

: (colon)
Will bring up the canto-curses command line
:help
Will bring up the internal help (more complete list of keybinds and commands)

:set browser [browser]
Set your favorite browser
:set browser.text [True|False]
Set this to True if you're using a text based browser like elinks so canto-curses knows to give up the screen to it.
:add [URL] (username=user password=secret) (name="Some name")
Subscribe to a feed, with optional arguments
:del
Unsubscribe from the selected feed


Previous item / Next item

Previous tag / Next tag

Previous page / Next page

Goto the selected item in your browser
<space>

Open / close the internal item reader

Collapse (minimize) / uncollapse the selected tag

Collapse (minimize) / uncollapse all visible tags

Canto-curses supports a lot more features like categorizing feeds/tags, filtering and sorting, searching, and more that can be discovered with :help

It also supports a variety of plugins that can add a lot of extra functionality, which are included with this install or available on the homepage.

Plugins are packaged in <prefix>/canto/plugins (i.e. /usr/lib/canto/plugins) and can be enabled by copying them into your configuration directory (i.e. $XDG_CONFIG_HOME/canto/plugins). Many of them have configuration in them, so you may want to open the files to make changes. Here are a few example plugins included with the canto-curses source.

Issue commands automatically on startup (useful to change configuration on startup)
Adds extra content to some feeds, also useful to see what's included in a feed.
Set the title of xterm compatible terminals on startup, and optionally include selected item title
Adds :yank-link (defaults to 'y') and :yank-title commands (needs xclip installed)
A proof of concept user "favorites" tag, that can change the appearance of certain items selected by the user.
A plugin that lets you define specific handlers for links based on the URL or the output of `file` on the downloaded content. Useful for listening to podcast enclosures or displaying PDF/image/other content in a dedicated program.
A plugin that helps strip bad content (newlines, HTML, etc.) out of item titles

$XDG_CONFIG_HOME/canto/curses-log

Canto-curses log file.

$XDG_CONFIG_HOME/canto/plugins/

Canto-curses enabled plugins directory

/usr/lib/canto/plugins
Default packaged plugin directory.

http://codezen.org/canto-ng

Jack Miller <jack@codezen.org>

canto-daemon(1) canto-remote(1)

Canto-curses