Installing

##Windows

To install UwTerminalX on Windows, simply download the zip file from the releases page and extract the contents to a folder where you want UwTerminalX located, no additional files are required to use UwTerminalX.

Please note: 32 bit and 64 bit desktop/server versions of Windows are supported, Windows phone/Windows RT is not supported.

##Mac

To install UwTerminalX on Mac, simply download the dmg image from the releases page and extract the contents to a folder where you want UwTerminalX located (placing it in applications might cause additional files to appear in the list of Applications that are configuration files so this is not advised).

Before using UwTerminalX you might have to modify your system settings to allow running applications that do not originate from the app store, to do this open system settings, click 'Security & Privacy', click the lock to unlock the page if it is locked (enter password if required) and change the option under 'Allow apps downloaded from' to 'Anywhere'.

##Linux

To install on Linux, simply download the tar file from the releases page and extract the contents to a folder where you want UwTerminalX located using your GUI or alternatively extract is using tar in a terminal as so:

tar xf UwTerminalX_<version>.tar <extract_location>

Replacing with the version downloaded and <extract_location> with the location to extract it to (~/ will extract to your home directory)

(Some 64 bit versions of Linux will require 32 bit libraries installed to function). Please follow the instructions below as per your distribution:

####Debian 32 bit

####Fedora Desktop 32 bit/Mint Linux 32 bit/OpenSuSE 32 bit (KDE/Gnome3/LXDE/minimal installs only, XFCE does not work)/Ubuntu-14 LTS 32 bit/Ubuntu-15 32 bit

All these distributions work fine as-is without additional libraries.

####Arch Linux 32 bit

For a reason not known, DNS resolution does not work on Arch Linux 32 bit with the official release, therefore none of the online functionality will work.

To get UwTerminalX working on Arch Linux 32 bit, it will need to be compiled from source on the target system.

####Arch Linux 64 bit

Open up a terminal and follow these instructions:

sudo su

or if you do not have sudo:

su

(Enter your password if prompted and press enter)

nano /etc/pacman.conf

Search for the '[multilib]' line, remove the # character from the beginning of the line and from the beginning of the line below it, press ctrl + x and when prompted to save changes, press y and enter.

pacman -Syu

pacman -S lib32-glibc

(Press y and enter when asked to confirm)

Once the install has completed, you should be able to launch and use UwTerminalX.

####CentOS

CentOS is not supported and UwTerminalX will not work on it.

####Debian 64 bit

Debian 64 bit requires the 32 bit compatibility libraries installed to function. To install the required libraries, open a terminal and follow these instructions:

sudo dpkg --add-architecture i386
sudo apt-get install libdns100:i386 libisc95:i386

Enter your user password when asked. Once the install has completed, you should be able to launch and use UwTerminalX.

####Fedora Desktop 64 bit

Open up a terminal and follow these instructions:

sudo dnf install ldns.i686

or

su
dnf install ldns.i686

Type your user or system password (if prompted), and press y and enter when prompted to confirm installation.

Once the install has completed, you should be able to launch and use UwTerminalX.

####Mint Linux 64 bit

Mint Linux is supported out of the box, no futher action needs to be taken to execute and use it.

####OpenSuSE 64 bit

OpenSuSE installed with either a LXDE, GNOME or KDE GUI interface is supported as-is. OpenSuSE installed with an XFCE interface is not supported and the static UwTerminalX build on the releases page will not run, a binary will have to be built from the source code to run UwTerminalX on an OpenSuSE system with XFCE.

####Sabayon Linux 64 bit

Sabayon Linux will run UwTerminalX as-is without additional libraries.

####Ubuntu Linux 64 bit

Open up a terminal and type the following command and press enter:

sudo apt-get install libdns100:i386 libisc95:i386

Enter your user password when asked. Once the install has completed, you should be able to launch and use UwTerminalX.

##BSD

####FreeBSD

UwTerminalX has been tested on FreeBSD and does work. Official builds are not created for FreeBSD and it will require a long process to get Qt5 installed and compile UwTerminalX which is not documented on this wiki, if you wish to use UwTerminalX on FreeBSD then please be aware that if you do so then there is no guarantee that it will work as expected and will be down to the end user to compile the code.