Go to file
2023-07-13 21:17:25 +00:00
.github CI roundabouts 2023-03-20 20:56:13 +00:00
airootfs/etc Hot-load GPU drivers on boot 2023-07-13 21:17:25 +00:00
efiboot/loader Generate systemd-boot entry by checking bootstrap 2023-07-13 12:46:13 +00:00
.gitignore Enable plymouth and add NVIDIA driver packages 2023-07-13 17:28:28 +00:00
bootstrap_packages.x86_64 Initial files 2022-04-21 15:47:47 +00:00
gen_entries.sh Quiet boot breaks archiso hooks 2023-07-13 21:15:54 +00:00
kernel_list.bootstrap Switch to Arch 6.3 2023-07-13 16:50:33 +00:00
LICENSE.md holoiso: License this under uhhhhh..... 2022-05-25 22:04:41 +03:00
mkarchiso-holoiso Ditto x2 2022-11-22 10:27:41 +03:00
packages.holo_x86_64 Switch to offline experience image 2022-11-06 13:52:38 +03:00
packages.x86_64 Use a better approach for pacstrapping kernels 2023-06-28 11:44:47 +00:00
pacman.conf Adapt to reuse local pacman cache 2023-07-13 12:01:33 +00:00
profiledef.sh Changing image name breaks booting 2023-03-25 10:49:54 +00:00
README.md [README] Fix Actions link 2022-12-10 08:48:39 +08:00
README.zh_CN.md Update README.zh_CN.md 2023-01-09 13:02:05 +08:00

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 redistribution 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 and making me learn Linux in a fun and unique way.

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 same rootfs bootstrap as all HoloISO installations run

  • I have an NVIDIA G-

No. Not even questionable. If you have an NVIDIA GPU, You're on your own. Latest Valve updates for Steam client including normal and Jupiter bootstraps have broken gamepadui on NVIDIA GPUs, and if so, no support will be provided for you.

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

Working stuff on Steam Deck compared to other distributions:

  • Dock Firmware updater (additionally installable in desktop by running sudo pacman -S jupiter-dock-updater-bin)
  • Steam Deck BIOS, Controller firmware, OS firmware updater
  • New fan curve control
  • TDP/Clock control

(*0) Disabled for ALL systems except for Steam Deck (Valve Jupiter 1) due to VERY LOW hardcoded TDP/Clock values, especially for dGPUs.

Installation process:

Prerequistes:

  • 4GB flash drive
  • More than 8 GB RAM if you plan to use "Copy-To-RAM" option to install
  • AMD GPU that supports RADV Drivers instead of Radeon (Southern Islands and Sea Islands require additional kernel cmdline property); Intel iGPU all the way up to 11th gen Iris Xe (Arc GPUs are not supported at this moment)
  • UEFI-enabled device
  • Disabled secure boot

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, or by simply throwing ISO into Ventoy drive
  • Boot into ISO
  • Click on "Install SteamOS on this device"
  • Follow on-screen instructions
  • 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/
mv holoiso/mkarchiso-holoiso /usr/bin
chmod +x /usr/bin/mkarchiso-holoiso
sudo mkarchiso-holoiso -v holoiso

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