# Installing Vistava

Vistava is currently supported on Windows and Linux. To download either version, go to the "Download" section on the [Vistava website](index.html#download ':ignore') and click one of the download links, or navigate to the "Releases" page on the right side of the GitHub repository and select the latest release at the top of the list.

## Windows

To install Vistava on Windows, you'll need **Windows 10 or newer (64-bit)**. You can choose between an installer (recommended for most users) and a portable ZIP archive.

### Installer

You can download the installer by clicking the "Installer (recommended)" link in the "Download" section on the [Vistava website](index.html#download ':ignore'), or by downloading the `.exe` asset (e.g., `vistava-win-setup-1.0.0.exe`) from the latest release on the GitHub releases page. After downloading, open the installer. 

> [!NOTE]
> **Note:** Windows might warn you that it prevented an unrecognized app from starting. That warning does not mean that Vistava contains any malware or spyware ([and it doesn't](https://www.virustotal.com/gui/url/7866cc5acfd595e79442c7c49ccc631862b5ccdf1ca5bea7c92e4a12f1313bea)). This can happen when an app is relatively new and/or wasn't signed with a developer certificate that costs at least $100 a year. You can safely continue with the installation by clicking "More info" and then "Run anyway".

An installation wizard should open shortly after. Click "Next" a few times, be sure to read the entire GPL-3 license (as one usually does), and then wait for setup to complete. Once installation is complete, you can run the application directly from the installer or use the shortcuts created in your Start menu or on your desktop.

You can also right-click a folder in File Explorer to open Vistava directly in that directory. On Windows 11, you might need to show all entries in the context menu to see this option. Note that this option isn't available with the portable version of Vistava described below.

### ZIP archive

You can download the portable ZIP archive by clicking the "Portable ZIP" link in the "Download" section on the [Vistava website](index.html#download ':ignore'), or by downloading the `.zip` asset (e.g., `vistava-win-1.0.0.zip`) from the latest release on the GitHub releases page.

After downloading the archive, extract it to a folder where you have sufficient permissions, such as your desktop or a USB stick. If you already have the FFmpeg dependency installed, start the application by opening the `Vistava.exe` (or `Vistava`) executable with the "V" icon in the extracted directory. Windows might warn you that it prevented an unrecognized app from starting. To continue, click "More info" and then "Run anyway".

> [!NOTE]
> **Note:** Vistava does store temporary files and its configuration in the current user's application data folder, not in the program directory. Keep this in mind when using Vistava on different computers!

## Linux

To install Vistava on Linux, you'll need a distribution that supports Flatpak (as most modern distributions do, including Debian, Mint, Ubuntu, Fedora and Raspberry Pi OS) or is Arch-based (such as Arch itself, SteamOS 3+, CachyOS, or Manjaro).

### Flatpak

You can install the Flatpak version directly through the Flatpak CLI tool or any application installer supporting Flatpak (like [Discover](https://apps.kde.org/discover/)). Assuming you have Flatpak installed and the official Flathub repository was added, you can install Vistava with a single command for the current user:

```bash
flatpak install --user net.vistava.vistava
```

After installation, you can launch the application using the shortcuts created in your application launcher (in the "Graphics" and "Multimedia" categories), by opening a directory with Vistava, or by using the following command:

```bash
flatpak run net.vistava.vistava
```

#### Flatpak permissions

By default, the Flatpak version **only has access to your picture and video folders** in your home directory. This is a restriction of Flatpak/Flathub and _not_ a bug in Vistava. 

However, you can make other paths of your file system accessible easily: To allow (read-only) access to the example path `/media/Data`, you can use the following command line command:

```bash
flatpak override net.vistava.vistava --filesystem=/media/Data:ro
```

Alternatively, you can use applications like [Flatseal](https://flathub.org/en/apps/com.github.tchx84.Flatseal) to manage the paths that Vistava may access via a GUI.

### Pacman

Arch-based distributions (such as Arch itself, SteamOS 3+, CachyOS, or Manjaro) can install Vistava using the provided `pacman` package from the [Vistava website](index.html#download ':ignore'). ~~or through the AUR using the package name "vistava".~~ (Note: Installation via AUR will be added once they accept new registrations again)

After installing Vistava using your preferred method below, you can launch it using the shortcuts created in your application launcher (in the "Graphics" and "Multimedia" categories), by opening a directory with Vistava in your file explorer, or by running the `vistava` command in a terminal.

#### Download pacman package

You can download the `pacman` package by clicking the "Pacman package" link in the "Download" section on the Vistava website, or by downloading the `.pacman` asset (e.g., `vistava-linux-1.0.0.pacman`) from the latest release on the GitHub releases page.

After downloading, run the following command in the directory containing the downloaded `pacman` file. Replace `vistava-linux-1.0.0.pacman` with the actual name of the downloaded file:

```bash
sudo pacman -U vistava-linux-1.0.0.pacman
```

Confirm the installation of the package and wait for the process to complete.

### Tarball

Alternatively to the Flatpak route, you can also download the Tarball with the precompiled binaries (for x86_64) or build Vistava from source (for x86_64 or aarch64). In both cases, Vistava requires various dependencies to be installed prior to running the `vistava` executable in the tarball - you will find these in the section about [building Vistava from source](/5-development.md?building-from-source).

## Other OSes and platforms

Vistava is currently not supported on operating systems or platforms other than those described above.

Adding macOS support would require only minor adjustments. However, building and maintaining applications for macOS requires owning an Apple computer running a relatively modern version of macOS (which I don't have).