Mirrors/holoiso
1
0
Fork 0
mirror of https://github.com/bhaiest/holoiso.git synced 2024-11-15 15:52:33 +01:00
Code Issues Projects Releases Wiki Activity

Merge pull request #20 from TwinniDev/3.0

Browse Source 
Improve README.md readability.
This commit is contained in:
Adam Jafarov 2022-05-06 16:49:09 +03:00 committed by GitHub
commit 1e8ef8fc3a
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 38 additions and 34 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

72
README.md
View File

@ -1,61 +1,65 @@
![image](https://user-images.githubusercontent.com/97450182/166438178-abb068d0-ce36-4611-aefe-deb6fbc1ab51.png)
![image](https://user-images.githubusercontent.com/97450182/166438178-abb068d0-ce36-4611-aefe-deb6fbc1ab51.png)
# HoloISO # HoloISO
SteamOS 3 (Holo) archiso configuration. SteamOS 3 (Holo) archiso configuration.
***Yes, Gabe. SteamOS functions well on a toaster.*** ***Yes, Gabe. SteamOS functions well on a toaster.***
This project attempts to bring Steam Deck's Holo OS into a generic, installable format and replicate close-to-official SteamOS experience. This project attempts to bring the Steam Deck's Holo OS into a generic, installable format, and provide a close-to-official SteamOS experience.
Upon booting, you'll be greeted with Steam Deck's OOBE screen, from where you'll connect to your network and login to Steam account, from there, you can exit to KDE Plasma seamlessly by choosing `Switch to desktop` in power menu. https://www.youtube.com/watch?v=smfwna2iHho
Q1: **Common Questions**
- ***Is this official?***
- The code, and packages are straight from Valve with zero possible edits. And ISO is being built on official Steam Deck recovery image running inside QEMU instance.
Q2:
- ***The ISO didn't boot for me, any solution?***
- Currently, 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: - Is this official?
- Boots > 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.
- SteamOS OOBE (SteamDeck UI First Boot Experience) - The ISO didn't boot for me, any solution?
> Currently, 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 (separate session)
- Switch to Desktop from plasma/to plasma without user interference.
- Deck UI (-gamepadui) - Deck UI (-gamepadui)
- TDP/FPS limiting - TDP/FPS limiting
- Global FSR - Global FSR
- Shader Pre-Caching - Shader Pre-Caching
- Valve's exclusive `Vapor` appearance for KDE Plasma - Switch to Desktop from plasma/to plasma without user interference.
- cool-looking neofetch? - Valve's exclusive *Vapor* appearance for KDE Plasma
- SteamDeck pacman mirrors - Steam Deck pacman mirrors
- Cool-looking neofetch?
Known issues: **Known issues:**
- NVIDIA GPUs are stuck on black screen or `Triggering uevents`. Solution: Boot with `nomodeset=1` and install proprietary drivers https://wiki.archlinux.org/title/NVIDIA. Keep in mind, that Steam Deck session won't work for now, delete `/etc/sddm.conf.d/autologin.conf` to avoid booting into black screen with infinite crash. - NVIDIA GPUs are stuck on black screen or `Triggering uevents`.
- Intel GPUs/iGPUs require Gamescope and MESA downgrade in order to boot into Steam Deck session. Refer to https://gist.github.com/drraccoony/8a8d0a9e3dfde9fafd3e374e418d2935 for further guidance. > Solution: Boot with `nomodeset=1` and install [proprietary drivers](https://wiki.archlinux.org/title/NVIDIA). Keep in mind, that Steam Deck session won't work for now, delete `/etc/sddm.conf.d/autologin.conf` to avoid booting into black screen with infinite crash.
- Intel GPUs/iGPUs require a Gamescope and MESA downgrade in order to boot into Steam Deck session.
> Refer to [this gist](https://gist.github.com/drraccoony/8a8d0a9e3dfde9fafd3e374e418d2935) for further guidance.
Installation process: Installation process:
- -
Prerequistes: **Prerequistes:**
- 4GB flash drive - 4GB flash drive
- AMD GPU with Vulkan and VDPAU support - AMD GPU with Vulkan and VDPAU support
- UEFI-enabled device - UEFI-enabled device
- Disabled secure boot - Disabled secure boot
Installation types: **Installation types:**
- 1) barebones: Barebones OS-only installation, resembles vanilla Arch Linux installation - barebones
- `2) gameonly: Steam Deck UI only (AMD GPU only; no desktop), as said, this doesn't ship any DE, and only has Steam Deck UI installed.` This part is currently under a renovation. > Barebones OS-only installation, resembles vanilla Arch Linux installation.
- 2) deckperience: Full SteamOS 3 experience, Includes proper session switching, KDE Plasma and media apps, Chromium preinstalled `- gameonly
> Steam Deck UI only (AMD GPU only; no desktop), as said, this doesn't ship any DE, and only has Steam Deck UI installed.` This part is currently under a renovation.
- deckperience
> Full SteamOS 3 experience, Includes proper session switching, KDE Plasma and media apps, Chromium preinstalled.
Installation: **Installation:**
- Flash the ISO from the `Releases` tab 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/), [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` - 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 - Boot into ISO
- Run `holoinstall` - Run `holoinstall`
- Select your installation flavor - Enter drive node, starting from, for example, `sda` or `nvme0n1` when asked
- Enter drive node, starting from `for ex. sda or nvme0n1` when asked
- Take your favourite hot beverage, and wait till it installs :) - Take your favourite hot beverage, and wait till it installs :)
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: Screenshots:
- -
![image](https://user-images.githubusercontent.com/97450182/166166719-f5f6d692-7e15-4e77-8ad3-683b3a88d6c1.png) ![image](https://user-images.githubusercontent.com/97450182/166166719-f5f6d692-7e15-4e77-8ad3-683b3a88d6c1.png)
@ -69,14 +73,14 @@ Notes:
This configuration includes Valve's pacman.conf repositories, `holoinstall` script and `holoinstall` post-installation binaries. This configuration includes Valve's pacman.conf repositories, `holoinstall` script and `holoinstall` post-installation binaries.
This configuration builds `releng`-based ISO, which is default Arch Linux redistribution flavor. This configuration builds a *releng-based ISO*, which is the default Arch Linux redistribution flavor.
Building the ISO: Building the ISO:
- -
Trigger build by: Trigger the build by executing:
``` ```
git clone https://github.com/bhaiest/holoiso/ git clone https://github.com/bhaiest/holoiso/
sudo mkarchiso -v holoiso sudo mkarchiso -v holoiso
``` ```
Once it ends, your ISO will be available in `out` folder Once it ends, your ISO will be available in the `out` folder.