-
Notifications
You must be signed in to change notification settings - Fork 19
Installing
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.
To install UwTerminalX on Mac (Note that OS X version 10.10 or later is required to use the precompiled versions, you may be able to compile the code on an older system with an older version of Qt if this is desired), 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'.
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.gz -C <extract_location>
Replacing with the version downloaded and <extract_location> with the location to extract it to (~/ will extract to your home directory)
You will need to grant non-root users access to USB devices with a udev rule, please see this page on the wiki for details: https://github.com/LairdCP/UwTerminalX/wiki/Granting-non-root-USB-device-access-(Linux)
(Some 64 bit versions of Linux will require 32 bit libraries installed to function). Please follow the instructions below as per your distribution:
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.
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.
Online functionality will cause the application to crash with the builds available from the releases page.
To get UwTerminalX working on Arch Linux 64 bit, it will need to be compiled from source on the target system.
CentOS is not supported and UwTerminalX will not work on it.
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.
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 is supported out of the box, no futher action needs to be taken to execute and use it.
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 will run UwTerminalX as-is without additional libraries.
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.
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.