Installation
============

SocNetV is multi-platform, which means that it can be installed and run in every
Operating System supported by the Qt toolkit.

The project offers binaries and installers for the three major Operating Systems:
Windows, MacOS and Linux.

If there is no binary package for your OS, please download and compile the source code,
as explained further below.

Installers & Binaries

You can download an installer or a binary package for your Operating System from the
project's Downloads page: https://socnetv.org/downloads

Follow the instructions below to install it in your system.

Install in Windows

To install SocNetV in Windows, download the latest version from the
Downloads page, and double-click on the SocNetV installer executable.
Click Next and Accept the License (GPL) to install the program.
Afterwards you can find the application in Start > Programs.

Install in MacOS

To install SocNetV in Mac, download the latest SocNetV MacOS installer from
the Downloads page, and double-click on the executable to start the installation.
The application will be installed in your Applications.

Please note that the first time you run SocNetV, you may need to double click on
the SocNetV application icon holding down the META key.

Install in Linux

To run the latest version of SocNetV in Linux, download the latest Linux AppImage from
the project's Downloads page.

Make the file executable and double-click on it to run SocNetV. Note, however, that your system needs to have libfuse2 installed. On latest Ubuntu releases, you need to instal it with:

sudo apt install libfuse2t64

Please note that a version of SocNetV is available in the repositories of most Linux distributions.
However that is not always the most recent and updated version.

In Debian, SocNetV is packaged in the official archive - no extra repository needed:

sudo apt install socnetv

To install the latest and greatest SocNetV version, users of openSUSE, Fedora and
Ubuntu are advised to add our own repositories to their systems instead.

In Ubuntu, install SocNetV from our PPA with these commands (this PPA is Ubuntu-only;
it will not work on Debian):

sudo add-apt-repository ppa:dimitris-kalamaras/ppa
sudo apt-get update
sudo apt-get install socnetv

In Fedora and openSUSE, choose and add the correct repository from here:
https://software.opensuse.org/download.html?project=home%3Aoxy86&package=socnetv

Once you add the repo, install SocNetV using the command (Fedora):
sudo yum install socnetv

or (openSUSE):
sudo zypper in socnetv


Compile from source code

To compile and install SocNetV from source you need CMake (3.16+) and the Qt6 toolkit
development libraries (Qt 6.2 or later).

Qt is an open source C++ toolkit, for Windows, Linux and MacOS.

Windows and MacOS users should download and install Qt6 from https://www.qt.io/developers

Linux users need to install the following packages:

openSUSE: libqt6-qtbase, libqt6-qtbase-devel, libQt6Charts6-devel, qt6-tools

Fedora: qt6-qtbase, qt6-qtbase-devel, qt6-qtcharts-devel, qt6-linguist, qt6-qt5compat

Debian/Ubuntu: cmake, ninja-build, pkgconf, qt6-base-dev, qt6-base-dev-tools, qt6-tools-dev,
qt6-tools-dev-tools, qt6-l10n-tools, qt6-charts-dev, qt6-svg-dev, qt6-5compat-dev,
libqt6opengl6-dev, libgl-dev, libvulkan-dev, libxkbcommon-dev

Once you have Qt and CMake installed, you are ready to compile SocNetV from source.


Download the archive with the source code of the latest version from
https://github.com/socnetv/app/releases/latest. You will get a compressed file like
SocNetV-3.X-src.tar.gz

Then type in the following commands in order to decompress the
SocNetV tarball and build it. Replace 3.X with the version you downloaded.

1) tar zxvf SocNetV-3.X-src.tar.gz  (or use 7zip in Windows/Mac)

2) cd SocNetV-3.X

3) cmake -S . -B build

4) cmake --build build -j4

5) sudo cmake --install build # only for linux users, to install socnetv system-wide

Legacy qmake is also supported, as an alternative to steps 3-4: just run 'qmake' then 'make'.

When you finish compiling and installing, run the application typing:

socnetv



Questions
=========

For any questions, open an issue on GitHub: https://github.com/socnetv/app/issues

