Three steps: run the bootstrap script, flip two BIOS settings, install thermald. Reboot when done.
This page covers the standard setup. For manual per-component installation, GPU setup, display rotation internals and sleep modes, see GUIDE-ADVANCED.md.
On Ubuntu or Debian:
sudo tools/bootstrap-ubuntu.sh
On Arch, CachyOS or Manjaro (with sudo from your normal user account, not
from a root shell — it builds a package, which refuses to run as root):
sudo tools/bootstrap-arch.sh
The script installs build dependencies, the four DKMS kernel modules
(touchscreen fix, EC driver, DPTF enabler, I2C fix), the patched
iio-sensor-proxy for auto-rotation and tablet mode, and the kernel command
line arguments for deep sleep, the PSR screen-tearing fix and panel rotation.
Panel rotation is skipped when Niri is installed, running or named in
XDG_CURRENT_DESKTOP, because of the
iio-niri issue. Use --panel-rotation
to force it with a fixed iio-niri, or --no-panel-rotation to skip it on any
desktop. Skipping leaves existing kernel arguments unchanged. See
GUIDE-ADVANCED.md.
It is idempotent — safe to re-run at any time. If it stops with an error saying the running kernel is no longer installed, a package upgrade pulled in a new kernel: reboot and run it again.
thermald needs two hidden BIOS settings changed to control CPU power limits.
- Unlock the hidden BIOS menus:
echo 1 | sudo tee /sys/devices/platform/minibook_ec/bios_unlock - Reboot into BIOS setup (press DEL during POST).
- Go to the
Advancedtab. - Navigate to
Power & Performance -> CPU - Power Management Control -> CPU Lock Configuration - Change
CFG LocktoDisabled - Go back to the top level of the
Advancedtab. - Navigate to
Thermal Configuration -> CPU Thermal Configuration - Change
Tcc Activation Offsetto10
See thermald.md for what these do.
Patched thermal daemon. Requires steps 1 and 2.
On Arch, CachyOS and Manjaro (without sudo):
cd thermal_daemon
make install-arch
Add IgnorePkg = thermald to /etc/pacman.conf so upgrades don't replace
it with the unpatched repo build.
On Debian and Ubuntu:
sudo apt install build-essential autoconf autoconf-archive automake \
pkg-config gtk-doc-tools libglib2.0-dev libxml2-dev libupower-glib-dev \
libevdev-dev systemd-dev
sudo apt remove thermald
cd thermal_daemon
./autogen.sh --sysconfdir=/etc --localstatedir=/var
make
sudo make install
On Fedora, sudo dnf remove thermald first and install the corresponding
build dependencies.
Enable and restart:
sudo systemctl daemon-reload
sudo systemctl enable thermald
sudo systemctl restart thermald
Verify: journalctl -u thermald | grep minibook. See
thermald.md for details.
Reboot, then run:
sudo tools/check-status.sh
The warnings section at the end lists anything still missing. Two more status scripts dig deeper — see GUIDE-ADVANCED.md.
The panel runs at 50 Hz stock. To try 90 Hz:
cd vbt_patch && make && cd ..
sudo tools/update-vbt-clock.sh 90
Treat this as an experiment, not a default. Panels vary between units, and a rate can survive a cold boot yet fail on the first suspend/resume. Test a suspend cycle before relying on it, and revert if the display misbehaves:
sudo tools/update-vbt-clock.sh --revert
See vbt-patch.md for choosing a rate and telling the two failure modes apart.
GNOME and KDE Plasma pick up rotation and tablet mode automatically. On Niri, Sway, Hyprland and other wlroots compositors you need a small bridge daemon — see iio-sensor-proxy.md.
In tablet mode the physical keyboard is disabled at the EC level (see
minibook-ec.md), so text input
needs an on-screen keyboard. There is no built-in popup-on-focus mechanism on
Niri (unlike GNOME/KDE) -- wire one up manually with switch-events:
yay -S wvkbd-deskintl
Add to a Niri config file (e.g. ~/.config/niri/cfg/switch-events.kdl):
switch-events {
tablet-mode-on {
spawn "wvkbd-deskintl"
}
tablet-mode-off {
spawn "pkill" "-x" "wvkbd-deskintl"
}
}
wvkbd-deskintl has no dedicated Polish layout, but every diacritic (ą ć ę ł
ń ó ś ź ż) is reachable through the "Cmp" (Compose) key: tap Cmp, then the
base letter, then pick the accented variant from the popup that appears.