Linux Installation

Linux Installation

Having problems? See Linux Troubleshooting.

---

Quick Install

Run as your normal user - not root:

curl -fsSL https://raw.githubusercontent.com/HorizonUnix/UXTU4Linux/main/install.sh | bash

The installer asks for your sudo password once to install system packages and write to /opt and /usr/local/bin. After that, everything runs as your regular user. The app launches automatically when the installer finishes.

On future sessions:

uxtu4linux

---

What the Installer Does

Step	Detail
Detect package manager	apt, dnf, yum, pacman, zypper
Install system deps	dmidecode, python3, python3-venv, curl, unzip
Download release	Latest zip from GitHub releases
Extract to /opt/uxtu4linux/src/	All app files
Patch entry point	Rewrites shebang + injects venv guard into UXTU4Linux.py
Create venv at /opt/uxtu4linux/venv/	Isolated Python environment
Install Python deps	pyzmq
Install /usr/local/bin/uxtu4linux	System-wide launcher
Launch app	Opens immediately via the launcher

File layout after install:

/opt/uxtu4linux/
├── src/
│   ├── UXTU4Linux.py
│   └── Assets/
│       ├── config.ini        <- created on first run
│       ├── Linux/
│       │   └── ryzenadj
│       ├── Modules/
│       └── Presets/
└── venv/
/usr/local/bin/uxtu4linux

---

Manual Installation

1. Install system dependencies

# Debian / Ubuntu
sudo apt install python3 python3-venv python3-pip dmidecode
 
# Fedora / RHEL
sudo dnf install python3 python3-pip dmidecode
 
# Arch
sudo pacman -S python python-pip dmidecode

2. Download and extract

curl -fsSL -o UXTU4Linux.zip \
  https://github.com/HorizonUnix/UXTU4Linux/releases/latest/download/UXTU4Linux.zip
unzip UXTU4Linux.zip && cd UXTU4Linux

3. Install deps

pip3 install pyzmq

4. Make binaries executable

chmod +x UXTU4Linux.py Assets/Linux/ryzenadj

5. Run

python3 UXTU4Linux.py

---

Updating

UXTU4Linux checks for updates on every launch (if softwareupdate = 1). When an update is available you will see the changelog and can confirm with y. The app downloads the new release, replaces /opt/uxtu4linux/src/, restores your config.ini, and relaunches automatically.

You can also trigger an update manually from About → Force update.

---

Uninstalling

# Stop and remove daemon
sudo systemctl stop uxtu4linux.service
sudo systemctl disable uxtu4linux.service
sudo rm /etc/systemd/system/uxtu4linux.service
sudo systemctl daemon-reload
 
# Remove files
sudo rm -rf /opt/uxtu4linux
sudo rm /usr/local/bin/uxtu4linux