Installation
============
This page includes instructions for installation on various platforms as well as a
manual fallback option:
.. contents:: :local:
Arch Linux
----------
The
`latest stable release `_
and the
`git development version `_
is available in the AUR.
Fedora
------
The `stable release `_ is available in the Fedora repositories.
It can be installed using the standard GUI software installers (Gnome
Software/Discover/Dnfdragora) and also using `dnf`::
$ sudo dnf install vimiv-qt
Using pip
---------
You can retrieve the latest stable release using::
$ pip install --user vimiv
and the latest development version with::
$ pip install --user git+https://github.com/karlch/vimiv-qt/
.. include:: datafile_warning.rst
Manual Install
--------------
First of all get the code by cloning the git repository and switch into the
repository folder::
$ git clone https://github.com/karlch/vimiv-qt/
$ cd vimiv-qt
or by downloading one of the snapshots on the
`releases `_ page.
.. note::
To compile the C extension, the python header files for python module development are
required. In some distributions, e.g. Ubuntu, these are not included in the default
python installation but another package (python-dev for Ubuntu) must be installed.
.. _install_systemwide:
System-Wide Installation
^^^^^^^^^^^^^^^^^^^^^^^^
Vimiv provides an example Makefile in the ``misc`` directory for convenience.
To install copy the Makefile into the repository directory, ``cp misc/Makefile
.``, tweak it to your liking and run (as root if installing system-wide)::
$ make install
The list of available options can be displayed with::
$ make options
These options are defined at the top of the Makefile and can be changed to fit
your needs. To uninstall vimiv the standard::
$ make uninstall
should work.
.. include:: dependency_info.rst
.. _install_using_tox:
Using Tox
^^^^^^^^^
In the repostory folder run tox to set up the virtual environment::
$ tox -e mkvenv
This installs all needed Python dependencies and vimiv in a .venv subfolder.
You can now launch vimiv by running::
$ .venv/bin/vimiv
You can create a wrapper script to start vimiv somewhere in your ``$PATH``,
e.g. ``/usr/bin/vimiv`` or ``~/bin/vimiv``::
#!/bin/sh
~/path/to/vimiv/.venv/bin/vimiv
.. include:: datafile_warning.rst
Running directly in the repository
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
In the repository folder build the c-extension for manipulate mode::
$ python setup.py build_ext --inplace
You can now launch vimiv by running::
$ python -m vimiv
.. include:: dependency_info.rst
.. include:: datafile_warning.rst
.. _install_dependencies:
Dependencies
------------
* `Python `_ 3.6 or newer with development extension
* `Qt `_ 5.11.3 or newer
- QtCore / qtbase
- QtSvg (optional for svg support)
* `PyQt5 `_ 5.11.3 or newer
* `setuptools `_ (for installation)
* `pyexiv2 `_ (optional for exif support)
* `piexif `_ (optional alternative for exif support)
.. include:: pyexiv2.rst
Package Names For Distributions
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
Installing the following packages should pull in all necessary dependencies for
building and running vimiv.
Arch Linux:
* qt5-imageformats (optional)
* qt5-svg (optional)
* python-pyqt5
* python-setuptools
* python-piexif (optional)
* python-exiv2 (optional, AUR)
Fedora:
* Build time dependencies: `sudo dnf builddep vimiv-qt`.
* python3-qt5
* python3-piexif
Debian/Ubuntu:
* python3-pyqt5
* python3-pyqt5.qtsvg (optional)
* python3-setuptools
* python3-dev (for building the C extension)
* python3-piexif (TODO not available...)