Canto | Download

Download

To the right, you'll find the download links you need, whether you're building from source or installing a package.

If you're interested in being bleeding edge, you can download the source straight from the git repo with this command:

$ git clone git://codezen.org/git/canto

Manual Install

Installing by hand is very easy since Canto uses the standard Python distutils. This is documented in the INSTALL file inside the tarball.

Untar

$ tar -xvf canto-{version}.tar.gz

Install

$ cd canto-{version}
$ sudo python setup.py install

Or, run without installing

$ cd canto-{version}
$ ./runhere.sh

This will install canto to the root of your filesystem. Alternatively, if you don't want to install Canto, or don't have permissions to install Canto, you can untar the source and run ./runhere.sh and try Canto without leaving the source directory (though you still need to have feedparser/chardet installed).

Installing Elsewhere

Installing using setup.py install --home or any other prefix should work as well. However, you must make sure that you setup your paths correctly. For example, if you install with setup.py install --prefix=/home/myuser/canto-root to properly run canto you'd have to set:

$ export PATH="$PATH:/home/myuser/canto-root/bin"
$ export PYTHONPATH="$PYTHONPATH:/home/myuser/canto-root/usr/lib/site-packages"

Optionally, if you want help to work inside of canto, you have to add to your MAN_PATH too.

$ export MANPATH="$MANPATH:/home/myuser/canto-root/share/man"

If you use canto alot, you can add these lines to your ~/.bashrc so you don't have to mess with exports every time.

Requirements

Libraries

• NCurses >= 5.5 with wide-char support (ncursesw)
• Python >= 2.5.x (tested on 2.5.4)
• feedparser
• chardet

If you're using Python 2.5.x, then you need the python processing module This is included in every major distribution as "python-processing" or "processing". This module is now built-in with 2.6+.

Platforms

• GNU/Linux is the only tested OS, but Canto should work regardless of architecture.

• Other operating systems, like Mac OSX, may work but are not actively tested on, AFAIK.

• The BSDs seem to cause problems, either with an incompatible ncurses version, or some other inconsistencies in the Python standard library on *BSD. Patches are welcome for BSD support.