Skip to content

Latest commit

 

History

History
109 lines (82 loc) · 5.83 KB

README.md

File metadata and controls

109 lines (82 loc) · 5.83 KB
Raw

Build ISO

image

HoloISO

SteamOS 3 (Holo) archiso configuration.

Yes, Gabe. SteamOS functions well on a toaster.

This project attempts to bring the Steam Deck's SteamOS Holo into a generic, installable format, and provide a close-to-official SteamOS experience. Main point of this project focuses in re-implementing proprietary (as in runs-only-on-deck) components that Steam client, OS itself, gamescope and user-created applications for Deck rely on.

Click here to join HoloISO Telegram update channel;

Click here to visit HoloISO discussion on Steam Deck Community forums

Common Questions

  • Is this official?

No, but it may as well be 99% of the way there. The code and packages, are straight from Valve, with zero possible edits, and the ISO is being built on the official Steam Deck recovery image, running inside a QEMU instance.

  • The ISO didn't boot for me, any solution?

Currently, the ISO only boots if flashed using BalenaEtcher, RosaImageWriter, Fedora Media Writer, DD with 4MB block size, or Rufus with DD mode.

Working stuff:

  • Bootup
  • SteamOS OOBE (Steam Deck UI First Boot Experience)
  • Deck UI (separate session)
  • Deck UI (-gamepadui)
  • TDP/FPS limiting (*0)
  • Global FSR
  • Shader Pre-Caching
  • Switch to Desktop from plasma/to plasma without user interference.
  • Valve's exclusive Vapor appearance for KDE Plasma
  • Steam Deck pacman mirrors
  • Cool-looking neofetch?
  • System updates

(*0) Disabled for ALL systems due to VERY LOW hardcoded TDP/Clock values, especially for dGPUs.

Known issues:

  • NVIDIA GPUs are supported after following this procedure:

Only 10xx+ GPUs are FULLY supported(*1). Although 9xx support exists in drivers, gamescope doesn't launch on it. Choose your GPU type while installing HoloISO. If you encounter any issues, reboot to recovery mode, type recoveryinit, connect to network using nmtui and install required packages.

(*1) The NVIDIA support is still pretty wonky. GamepadUI will lag, meanwhile games will run fine, session startup is very random too, usually boots in 5/10 of attempts

Older GPUs won't be supported until drivers are opensourced OR Until they support atomic KMS, accelerated Xwayland, and Vulkan DMA-BUF extensions, they simply cannot function properly with HoloISO.

  • Intel GPUs/iGPUs require a Gamescope downgrade in order to boot into Steam Deck session.

Choose your GPU type while installing HoloISO. If you encounter any issues, reboot to recovery mode, type recoveryinit, connect to network using nmtui and install required packages.

Installation process:

Prerequistes:

  • 4GB flash drive
  • AMD RX Vega+/APU iGPU; 4xx/5xx, 5xxx/6xxx GPU or Intel UHD 630+ iGPU or NVIDIA GTX 9xx+ iGPU/GPUs (preferably without Optimus [PRIME])
  • UEFI-enabled device
  • Disabled secure boot

Installation types:

  • barebones

An OS-only installation, resembles vanilla Arch Linux installation.

  • gameonly*

Steam Deck UI only (AMD GPU only; no desktop), as said, this doesn't ship any DE, and only has the Steam Deck UI installed. *This part is currently under a renovation.

  • deckperience

Full SteamOS 3 experience, Includes proper session switching, KDE Plasma + media apps, and Chromium pre-installed.

Installation:

  • Flash the ISO from releases or actions for NVIDIA GPUs using BalenaEtcher, Rufus with DD mode, or by typing sudo dd if=SteamOS.iso of=/dev/sd(your flash drive) bs=4M status=progress oflag=sync
  • Boot into ISO
  • Run holoinstall
  • Enter drive node, starting from, for example, sda or nvme0n1 when asked
  • Take your favourite hot beverage, and wait 'till it installs :3

Upon booting, you'll be greeted with Steam Deck's OOBE screen, from where you'll connect to your network, and login to your Steam account, from there, you can exit to KDE Plasma seamlessly by choosing Switch to desktop in the power menu, like so.

Screenshots:

Screenshot_20220508_133916 Screenshot_20220508_133737 Screenshot_20220508_133746 Screenshot_20220508_133822 Screenshot_20220508_134038 Screenshot_20220508_134051

Credits:

(Too much people xD, to be filled later!!!)

Notes:

This configuration includes Valve's pacman.conf repositories, holoinstall script and holoinstall post-installation binaries.

This configuration builds a releng-based ISO, which is the default Arch Linux redistribution flavor.

Building the ISO:

Trigger the build by executing:

pacman -Sy archiso
git clone https://github.com/bhaiest/holoiso/
sudo mkarchiso -v holoiso

Once it ends, your ISO will be available in the out folder.