- How is ViTables licensed?
- Oops! I’ve got a problem. How can I get support?
- I’ve found a bug or I want to request a new feature. What should I do?
- How can I use the latest revision from the git repository?
- Are there graphical installers for Windows and Mac OS X platforms?
- But can I launch ViTables from my Desktop?
- Can I use ViTables with Anaconda3?
How is ViTables licensed?
It has a GPLv3 license.
Oops! I’ve got a problem. How can I get support?
It’s always worth to check the messages posted to the ViTables users’ group: searching the list is a great way to get your questions answered. You can search the list using its web interface or from the Gmane interface. If you don’t find an answer to your question I strongly recommended you to subscribe to the users’ group and ask for help there. Probably some subscriber (ViTables developer or user) will be able to help you.
I’ve found a bug or I want to request a new feature. What should I do?
You should report it, of course :-). Please, send your report with the bug tracker.
How can I use the latest revision from the git repository?
If you want to run the development version of ViTables, first of all you have to clone it from the git repository. For instance
will download the latest revision and put it in the
You can use it as is or you can build the ViTables package from sources and
install it. Although packaging is not difficult it can be tricky because you
may need to install the Sphinx documentation system. So packaging is not
recommended. Instead, from the top level directory do the following
$ python run_vitables.py
and ViTables should start. Beware that the HTML User’s Guide will not be available unless you build it before running ViTables.
Are there graphical installers for Windows and Mac OS X platforms?
No, there aren’t.
But can I launch ViTables from my Desktop?
Of course, you can. After installation, just create a Desktop shortcut as you usually do on your platform. Make sure that it points to the vitables executable. The only tricky thing is to give a nice icon to the shortcut.
On Windows the icon file is
icons\vitables.ico and can be located in the installation folder.
On Linux it is a bit more difficult because the icons are not included in the package (tarball or wheel). So you
have to download them from the repository. In particular you need the
unixapp folder. There you will find
.desktop file and icons (
.png files) of several sizes. With all that stuff just follow the
standard way for creating Desktop shortcuts on Linux. That’s all.
Can I use ViTables with Anaconda3?
Yes, you can. Basically two installation ways are available. The most convenient is, of course, install the
ViTables package from conda-channel (I assume you are on a Windows machine here and the
Scripts folder is in your
You can install and run with
(Anaconda3) > vitables
If this fails, you can install ViTables from sources. Download and untar the tarball (or clone the
go to the root directory and proceed as you do in a typical installation from sources
(Anaconda3) > vitables
Caveat emptor: as you know ViTables depends on
PyQt5. Unfortunately the
PyQt5 package and the analogous
package provided by
Anaconda3 are in conflict with each other (you can read more about this
here). In order to avoid problems I recommend you to follow
- if you have installed the package from the conda-forge channel, remove the
- if you are going to install from sources, before you proceed, remove the
PyQt5dependency from the
install_requiresline in the