Installation¶
Stable release¶
To install yt_idv, run this command in your terminal:
$ pip install yt_idv
This is the preferred method to install yt_idv, as it will always install the most recent stable release.
If you don’t have pip installed, this Python installation guide can guide you through the process.
From sources¶
The sources for yt_idv can be downloaded from the Github repo.
You can either clone the public repository:
$ git clone git://github.com/yt-project/yt_idv
Or download the tarball:
$ curl -OJL https://github.com/yt-project/yt_idv/tarball/master
Once you have a copy of the source, you can install it with:
$ python setup.py install
Extra steps for linux¶
A number of linux distros (Ubuntu 21+, Fedora 34+) have switched the default graphics backend from Xorg to Wayland.
To Use yt_idv on these linux distributions, you may need enforce Xorg usage, which you can do in several ways:
Log into an Xorg session. For Ubuntu, you can still select to launch an Xorg session on the login screen (see here).
OR
Set the
PYOPENGL_PLATFORM
environment variable to"gdx"
. In a bash shell:
$ export PYOPENGL_PLATFORM="gdx"
To avoid having to set this variable each time, you can add the above line to your .bashrc
or .bash_aliases
file.
See Issue 81 for more information.