Installation and getting started¶
To install ViXeN, you first need to know the platform you will be running it on. ViXeN is available for Linux (64 bit), Mac (64 bit), and Windows (32 and 64 bit).
In order to use ViXeN you will need to have a working browser. See the Dependencies section for more information on the dependencies. Installing ViXeN is relatively straight-forward. Please see the instructions for installing ViXeN in the relevant sections below.
Dependencies¶
Installing ViXeN on GNU/Linux¶
On GNU/Linux systems one may install the dependencies by following three very simple steps:
- Download the ViXeN binary for Linux.
- Unpack the
vixen*.tgz
file. - Run the application inside the unpacked directory.
More detailed instructions are given below.
Using Nautilus¶
- Download the ViXen binary file (say vixen-0.9-linux64.tgz) from ViXeN binary to your preferred directory.
- Right click and select ‘Extract Here’ or ‘Open With Archive Manager’. A
ViXeN folder will appear in the directory you have selected (in this case
the folder will be
vixen-0.5
). - Open the directory and double click the
ViXeN
file (the file isViXeN.desktop
). The ViXeN application will open on the browser. - If the above did not work you can try to run the
vixen
file. This will run if Nautilus supports running executables. If it does not, run the command shown in Using the Command Line.
Using the Command Line¶
After downloading and unpacking ViXen either Using Nautilus, run the following commands on the terminal:
$ cd vixen-0.9
Where vixen-0.9
is the extracted ViXeN binary. Suppose you downloaded and
unpacked the vixen-0.9-linux64.tgz
file in a folder named Software
in
your home
directory, then this command will be:
$ cd Software/vixen-0.9
Then run the application using:
$ ./vixen
Installing ViXeN on Mac OS X¶
- On OS X, download the ZIP file.
- Unpack it.
- Run the resulting
ViXeN.dmg
file by double clicking it.
You may move this dmg file anywhere you like or move it to your
Applications
folder if you wish to.
Installing ViXeN on Windows¶
- On Windows, download the ZIP file for your platform.
- Unpack the ZIP file.
- Inside the unpacked directory is a
vixen.bat
script or avixen.lnk
shortcut that you can use to run the application.
The application will open in your default browser window.
Troubleshooting¶
If the application fails to run or you have any problems, please look at the
log file vixen.log
located inside the .vixen
folder in your home
directory.
- On Linux this is typically in the directory
/home/username/.vixen
. - On OS X this is in
/Users/username/.vixen
. - On Windows this may be
C:\Users\username\.vixen
.
Email your log file to the developers or the mailing list.
The ViXeN mailing list is available at https://groups.google.com/d/forum/vixen