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

Platforms

• GNU/Linux is the only tested OS, but any OS supporting Python/NCursesw should work with minimal effort.*
• x86, amd64 are tested, but canto builds on all of Debian's target architectures so ppc/arm/mips/sparc should work too.

* OpenBSD may be an exception as their curses library is chopped up for security, but other BSDs should be fine.