Before getting started make sure you have the following installed, along with what they in turn depend on:
- python, at least version 3.0
- GObject Introspection (GI) bindings for python
- gtksourceview3, including its GI bindings
- To allow vixn to deduce the type of file being loaded it tries to use the XDG MIME database with the implementation provided either by PyXDG (aka python-xdg) or ROX-Lib. If neither of these are available it tries python-magic.
At the moment the recommended way to download vixn is with git. The repository's URL is git://git.tuxfamily.org/gitroot/vixn/vixn.git so to check out a fresh copy into a directory called vixn:
$ git clone git://git.tuxfamily.org/gitroot/vixn/vixn.git vixn
Each time you want to upgrade change into the vixn directory and run:
$ git pull
To browse the git repository in a web browser use the URL http://git.tuxfamily.org/vixn/vixn.git.
ROX users can run vixn just by clicking on its icon, and others can run it in place by running vixn.py inside the vixn directory. You'll want to build the HTML documentation by running the makedocs.py script. To install vixn for the system run the install.sh script. By default it installs under /usr/local so you'll need to be root, but you can pass an alternative destination as an argument to the script. In addition to vixn/vixn.py there's also a vixgrep script which acts as a front-end to grep, displaying results in a throwback window.