mirror of
https://github.com/bhaiest/holoiso.git
synced 2024-11-10 05:12:33 +01:00
100 lines
4.8 KiB
Markdown
100 lines
4.8 KiB
Markdown
[](https://github.com/theVakhovskeIsTaken/holoiso/actions/workflows/build.yml)
|
|
|
|
|
|
# HoloISO
|
|
SteamOS 3 (Holo) archiso configuration.
|
|
|
|
***Yes, Gabe. SteamOS functions well on a toaster.***
|
|
|
|
This project attempts to bring the Steam Deck's Holo OS into a generic, installable format, and provide a close-to-official SteamOS experience.
|
|
|
|
Click [here](https://t.me/HoloISO) to join **HoloISO** Telegram update channel
|
|
|
|
**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](https://www.balena.io/etcher/), [RosaImageWriter](http://wiki.rosalab.ru/en/index.php/ROSA_ImageWriter), [Fedora Media Writer](https://getfedora.org/en/workstation/download/), DD with 4MB block size, or [Rufus](https://rufus.ie) with DD mode.
|
|
|
|
|
|
**Working stuff:**
|
|
- Bootup
|
|
- SteamOS OOBE (Steam Deck UI First Boot Experience)
|
|
- Deck UI (separate session)
|
|
- Deck UI (-gamepadui)
|
|
- TDP/FPS limiting
|
|
- 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
|
|
|
|
**Known issues:**
|
|
- NVIDIA GPUs are supported after following this procedure:
|
|
|
|
> Only 9xx+ GPUs are supported. Driver 515 beta required + Compiled gamescope from master branch
|
|
|
|
> 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 and MESA 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
|
|
- 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](https://github.com/bhaiest/holoiso/releases/latest) using [BalenaEtcher](https://www.balena.io/etcher/), [Rufus](https://rufus.ie) 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](https://www.youtube.com/watch?v=smfwna2iHho).
|
|
|
|
Screenshots:
|
|
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
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.
|
|
|