Skip to content

zweiler2/HoloISO_Tweaked

 
 

Repository files navigation

image

HoloISO_Tweaked

First of all i want to credit Adam Jafarov for creating the HoloISO project! So please go check him out.

This project is mutable and has support for Nvidia cards.
If you want immutability then check this out.

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;

Common Questions

  • Is this official?

No, but it may as well be 99% of the way there. Most of 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 GPU

It may not be perfect but it works.

  • I have a laptop

WIP. Unless you have an all AMD one, you will most likely run into issues.

  • Steam says i have to format my Hard Drive to use it for games, but there are already games on it.

Just add the drive to steam via the desktop mode. This is a side effect of steam not knowing the device yet. See below.

  • How do i add my Hard Drive with all my games to Steam?

Go to the desktop mode and in the Steam settings under storage you can add it there. Once thats done, it will also show up in gamemode. You only need to do this once.

Hardware Support:

CPU:

  • Mostly all CPUs work fine. But people report inoperable experience on 7xxx series. (Should be working in later builds with linux-zen package included)

WLAN/PCIe additional cards:

  • Any pre-2021 WLAN Card works fine on Valve's 5.13 Neptune kernel, but linux-zen provides support for ALL current cards

Sound:

  • Everything mostly works fine(tm)

GPU:

  • AMD GPUs with RADV support (Guaranteed to work fully stable. 7xxx requires testing)
  • NVIDIA GPUs (900 series and above work.)
  • Intel GPUs (Random experience)

Progress:

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, support for thumbstick and haptic motor calibration, native amplifier (CS35L41) support
  • 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
  • A Vulkan capable GPU
  • UEFI-enabled device
  • Disabled secure boot

Installation:

  • Flash the ISO from releases 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 in the terminal, or by simply throwing the ISO onto a 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.

Updating:

  • For regular updates you would just hit the update button in gamemode or type sudo steamos-update check && sudo steamos-update now in the terminal
  • For ISO updates you would just download the new ISO and install to the same disk HoloISO is already on. The installer will detect an existing installation and asks you if you want to keep/reuse your home partition (This is where all your games, steam, various configs and personal files are stored). No data loss occurs then. Only the packages you installed via "pacman" from the terminal or the discover store get lost (but not their configuration or user data).

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:

sudo pacman -S archiso
git clone https://github.com/zweiler2/HoloISO_Tweaked.git
sudo chmod +x ./HoloISO_Tweaked/mkarchiso-holoiso
sudo ./HoloISO_Tweaked/mkarchiso-holoiso -rv ./HoloISO_Tweaked
sudo chown -hR $USER:$USER ./out 

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

Credits:

Adam Jafarov
Ewan for providing his build/fileserver
fewtarius
LeddaZ
danyi
mnixry
wynn1212
TwinniDev
Pato05
maade93791
huangsijun17
cherinyy
NightHammer1000
kubo6472
ItsVixano
pants4hire
Lolihunter1337
cpyarger
Etienne Juvigny and all contributors who made the Nvidia driver AIO Installer
Stephen and all contributors who made the Nvidia vaapi driver
Severin and all contributors who made the Xbox One and Xbox Series X|S accessories linux kernel driver Ingo Ruhnke and all contributors who made the Xbox/Xbox360 Gamepad Driver Joaquín Ignacio Aramendía, Alesh Slovak and all contributors who made the ChimeraOS gamescope-session Diego Garcia and all contributors who made the Steam Patch Project

Screenshots:

Screenshot_20220508_133916 Screenshot_20220508_133737 Screenshot_20220508_133746 Screenshot_20220508_133822 Screenshot_20220508_134038 Screenshot_20220508_134051

About

SteamOS 3 (Holo) archiso configuration

Resources

License

Stars

Watchers

Forks

Languages

  • Shell 100.0%