Releases · LukeShortCloud/winesapOS

02 Mar 16:12

4.0.0

2b8d2a9

Latest

Want to help support our work? Helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Download links:

Built using archlinux-2024.02.01-x86_64.iso.

Feature highlights:

Use upstream Arch Linux packages.
- Release builds will use vanilla Arch Linux now instead of a hybrid of new Arch Linux packages and SteamOS packages.
  - This change makes winesapOS a much more stable and reliable operating system.
- The major version of winesapOS has been increased from 3 to 4 to signify this change.
Linux T2 is now the default boot kernel.
- This will provide better out-of-the-box hardware support.
- Linux LTS is still installed and available to use.
  - Linux LTS has been upgraded from 6.1 to 6.6.
Chaotic AUR repository added.
- Many Arch Linux User Repository packages are now provided by the Chaotic AUR repository.
Support for more file systems:
- CephFS
- GFS2
- GlusterFS
Conversion script.
- A simple conversion script is provided to install packages similar to what winesapOS has but on your operating system of choice.
Better hardware and boot support.
- initramfs is now built with all Linux kernel modules.
- Microcode updates for AMD and Intel processors are now pre-installed.
- Improved support for USB hubs and NVMe drives.
- Support for Intel Optane drives as the primary boot drive.
- A troubleshooting guide is provided to help with common boot issues.

Project highlights:

Almost 800 GitHub stars!
Over 100 commits since our last release.
Exactly 50 GitHub Issues addressed.
Over 95% of all GitHub Issues ever made for winesapOS have been addressed still.

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.
Major upgrades from Mac Linux Gaming Stick 2 or winesapOS 3 to winesapOS 4 can be done following this guide.

Issues addressed since 3.4.0:

Steam Deck controller may not work.
Steam Deck LCD and OLED do not boot.
- This was due to bug in the Steam Deck BIOS. Update to the SteamOS 3.5.11 preview or newer. The SteamOS 3.5.17 release was the first stable release to fix this.

Known issues:

Steam Deck OLED does not have working sound or Wi-Fi.
ASUS ROG Ally does not boot with Linux T2 which has full hardware support including sound.
- Boot with "Arch Linux, with Linux linux-lts".
- Go through the entire winesapOS first-time setup.
- Reboot and then select "Arch Linux, with Linux linux-t2".
As of 2024-03-07, Arch Linux has upgraded KDE Plasma 5 to 6.0.0 but upgrades are broken. This means that a winesapOS upgrade, by extension, leads to a broken desktop environment.
- As a short-term workaround, install an alternative desktop environment such as Cinnamon.
  - Open a TTY console by pressing CTRL + ALT + 4.
  - sudo pacman -S cinnamon maui-pix xed
  - Restart LightDM: sudo systemctl restart lightdm
  - Find the previous TTY with w and then go back with CTRL + ALT + <TTY_NUMBER>.
  - At the login page of LightDM, select the wrench icon in the top-right to change the desktop environment to Cinnamon before logging in.
- As a long-term solution, wait for the winesapOS 4.1.0 release before upgrading.
  - As of winesapOS 4.1.0-alpha.0 and KDE Plasma 6.0.3, upgrades are now working.
  - Run the following commands to upgrade to it:
```
export WINESAPOS_UPGRADE_VERSION_CHECK=false
curl https://raw.githubusercontent.com/LukeShortCloud/winesapOS/4.1.0-alpha.0/scripts/winesapos-upgrade.sh | sudo -E bash
```

The full change log can be found here.

What's next?

We are exploring different ways to provide an installer. This will make it much easier for users to install winesapOS to an internal drive. This will also open the door to support dual-boot with other operating systems on the same storage device.

Assets 2

31 Dec 07:25

LukeShortCloud

3.4.0

9017958

3.4.0 - The Game Mode Update

Want to help support our work? Helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Download links:

Built using archlinux-2023.12.01-x86_64.iso and SteamOS 3.4 packages.

Feature highlights:

Game Mode is now supported.
- For both Steam and Open Gamepad UI.
  - More information on how to use these new sessions can be found here.
- Run a single program without a full desktop environment.
SteamOS packages are now deprecated.
- In the next major release of winesapOS, we will offer alternative packages.
- For more information on this change, refer to: #561 (comment)
Improved compatibility with programs designed to run on SteamOS.
Intel Arc dGPU support is now stable.
- When booting up, select the Arch Linux, with Linux linux-t2 boot option.
Vulkan support enabled for older AMD dGPUs.
- Southern Islands (SI), Sea Islands (CIK), and newer AMD GPUs all support Vulkan now.
winesapOS packages are now signed with a GPG key.
Support for more file systems:
- Bcachefs
- JFS
zram is provided as an optional alternative to swap.
Intel Mac support is now provided by packages from the Linux T2 project.
- In previous releases, we had used external kernel modules built against Linux LTS.
- This provides a more stable and maintainable experience.
Wayland support for KDE Plasma.
- Wayland is now installed but Xorg is still used by default.
Support for more hardware.
- Lenovo Legion Go.
  - When booting up, select the Arch Linux, with Linux linux-t2 boot option.
- GPD Win 4 (2022 and 2023 Editions).
  - When booting up, select the Arch Linux, with Linux linux-t2 boot option.
- iPhone.
  - File transfers and Internet tethering now works.
- Racing wheels.
- Razer accessories.
Recovery console.
- If LightDM fails to start, end-users will automatically be dropped into a recovery console with hints on how to fix the problem.
Downloading and extracting winesapOS release images has been simplified.
- There is now only one zip file for each image type.
- Download sizes are now smaller.

Project highlights:

This is our biggest release ever!
Over 700 GitHub stars!
Over 150 commits since our last release.
Over 100 GitHub Issues addressed.
Over 95% of all GitHub Issues ever made for winesapOS have been addressed.
Special thanks to @alkazar for helping me better understand Gamescope sessions and @ShadowApex for his incredible work on Open Gamepad UI (both from the amazing ChimeraOS project)!
New contributors - thank you for all of your amazing ideas and help implementing them!
- @ohaiibuzzle
- @wallentx

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.
Major upgrades from Mac Linux Gaming Stick 2 to winesapOS 3 can be done following this guide.

Issues addressed since 3.3.0:

None.

Known issues:

Steam Deck controller may not work.
- When booting up, select the Arch Linux, with Linux linux or Arch Linux, with Linux linux-t2 boot option for controller support.
Steam Deck LCD and OLED do not boot.
- Update to SteamOS 3.5.11 or newer.
- Or go into the BIOS and change the "USB Configuration" from "DRD" (which is currently broken) to "XHCI".
Steam Deck OLED does not have working sound or Wi-Fi.

The full change log can be found here.

Contributors

ShadowApex, alkazar, and 2 other contributors

Assets 2

14 Jul 19:36

LukeShortCloud

3.3.0

d550352

3.3.0 - The Major Upgrade Update

Want to help support our work? Helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Download links:

Built using archlinux-2023.07.01-x86_64.iso and SteamOS 3.4 packages.

Feature highlights:

Major upgrades are now supported.
- Mac Linux Gaming Stick (winesapOS) 2 can now be upgraded to winesapOS 3.
Improved hardware support.
- The Steam Deck, Steam Machines, Framework laptops, and Microsoft Surface laptops are now fully supported.
- Older Intel iGPUs and NVIDIA dGPUs are now supported.
- Linux LTS has been updated from 5.15 to 6.1 for better support of newer hardware.
Added more file systems support.
- The following file system drivers and tools have been added: CIFS/SMB, EROFS, F2FS, FATX16 and FATX32, NFS, and ReiserFS.
- winesapOS now supports 16 different families of file systems.
AppImage support.
- AppImages can be installed via the new AppImagePool package manager.
GPL support.
- AMD, Intel, and NVIDIA have the Vulkan graphics pipeline library enabled by default. This will lead to little to no stuttering in most games that do not already have shader cache.
SteamOS is now optional.
- A lot of the benefits that SteamOS packages have been merged upstream. For providing a more stable experience, our release images now default to using upstream Arch Linux packages. SteamOS packages and repositories can still be installed during the first-time setup.

Project highlights:

Over 600 GitHub stars!
- Thank you for all of your continued feedback and support!
Around 150 commits since our last release.
Over 1000 life time commits have been made directly to winesapOS.
Over 100 GitHub Issues addressed.
Over 90% of all GitHub Issues ever made for winesapOS have been addressed.

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.
Major upgrades from Mac Linux Gaming Stick 2 to winesapOS 3 can be done following this guide.

Issues addressed since 3.2.1:

Steam and other graphical applications fail to launch.
Steam Deck client shows corrupt graphics on NVIDIA.

Known issues:

Steam Deck controller may not work.
- When booting up, select the Arch Linux, with Linux linux boot option for controller support.

The full change log can be found here.

Assets 19

15 Feb 20:00

LukeShortCloud

3.2.1

938788d

3.2.1 - The SteamOS 3.4 Update

Want to help support our work? Helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Built using archlinux-2023.02.01-x86_64.iso and SteamOS 3.4 packages.

Feature highlights:

Switch to the renamed SteamOS 3.4 repository names.
- This caused a lot of issues for users on older versions of winesapOS and other SteamOS 3 forks. For users on those older versions, it is recommended to upgrade to the latest release using the "winesapOS Upgrade" desktop shortcut.
Decreased the swappiness level.
- From 10% down to 1% per CryoByte33's CryoUtilities recommendation.
Allow the password to be changed during the first-time setup.

Project highlights:

Over 500 GitHub stars!
- We love and appreciate all of our supporters. <3

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.

Issues addressed since 3.2.0:

Package upgrades used to fail due to missing holo and jupiter repositories. Valve renamed their repositories along with their SteamOS 3.4 release to have an additional -rel suffix.

Known issues:

Steam and other applications fail to launch.

Solution: update the Mesa graphics drivers. Arch Linux recently switched from LLVM 14 to 15 which broke our build of Mesa. A new build of Mesa has been pushed up to the winesapOS repository. Use the commands below to update the graphics drivers.

sudo pacman -S -y -y
sudo pacman -S mesa-steamos mesa-vdpau-steamos opencl-mesa-steamos vulkan-intel-steamos vulkan-mesa-layers-steamos vulkan-radeon-steamos vulkan-swrast-steamos lib32-libva-mesa-driver-steamos lib32-mesa-steamos lib32-mesa-vdpau-steamos lib32-opencl-mesa-steamos lib32-vulkan-intel-steamos lib32-vulkan-mesa-layers-steamos lib32-vulkan-radeon-steamos lib32-vulkan-swrast-steamos libva-mesa-driver-steamos

Reboot winesapOS after the packages have been updated.

Steam Deck client shows corrupt graphics.
- Solution: the Steam Deck client works best on modern AMD GPUs but has also been reported as working on some Intel and NVIDIA graphics devices. Use the "Steam Desktop" application instead.

The full change log can be found here.

What's next?

Major upgrades! We are investigating how we can support upgrades from winesapOS 2.2.0 to 3.X.Y. We want all of our users to experience SteamOS 3 on the desktop. After that, we will finally be implementing the Steam Deck game mode session for a more console-like experience. For a full look into our roadmap, check out our planned milestones.

Assets 21

24 Nov 15:24

LukeShortCloud

3.2.0

1c4d481

3.2.0 - The Minimal Image Update

Want to help support our work? Consider donating via our Patreon page or helping out with open feature and bug GitHub issues. Our CONTRIBUTING.md guide provides all of the information you need to get started as a winesapOS contributor.

A huge thanks to Intel for sponsoring this release! Looking for data center grade drives at consumer prices? Many of these drives are on sale now at NewEgg. Get them while supplies last!

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Built using archlinux-2022.11.01-x86_64.iso and SteamOS 3.3 packages.

Feature highlights:

Minimal image.
- We now offer a minimal image that is 7 GiB in size.
  - This is down from the 29 GiB size of the performance and secure images.
- The first-time setup allows users to select the software they want to install.
Improved Mac support.
- Wi-Fi now works on older Macs that do not have the Apple T2 security chip.
- Fans are now much quieter.
Improved controller support.
- More third-party controllers are supported.
- A regression was fixed where original Xbox and Xbox 360 controllers did not work.
Screen rotation support.
- For portable handheld PCs such as the GPD Win Max and the Steam Deck.
Support for running as a guest virtual machine.
- VirtualBox, VMware Fusion, and VMware Workstation are all now officially supported.
- We install guest tools for the best integration and experience possible.
Improved stability.
- Packages are now compiled against Arch Linux instead of SteamOS.
  - Graphics drivers, among other things, are more stable now because of this.
- Upgrades have been thoroughly tested on a wide range of hardware.
- GitHub Actions provides automated testing that has helped us find issues and fix them faster.
  - Thanks @Thijzer for helping implement this!

Project highlights:

Over 400 GitHub stars!
- Thanks for your continued support! Let us know what you'd like to see next in winesapOS!

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.

Issues addressed since 3.1.1:

"Add/Remove Software" (Pamac) fails to launch if it has been updated.
- Pamac has been replaced with bauh which is a more stable package manager for non-Manjaro Linux distributions.
Steam Deck client cannot login.
- This is no longer an issue since the stable Steam client was updated last week to include the new Steam Deck gamepad UI.

Known issues:

Package upgrades fail due to missing holo and jupiter repositories. Valve renamed their repositories along with their SteamOS 3.4 release.
- Solution: switch to the new repository names.
```
sudo sed -i s'/\[holo\]/\[holo-rel\]/'g /etc/pacman.conf
sudo sed -i s'/\[jupiter\]/\[jupiter-rel\]/'g /etc/pacman.conf
sudo pacman -S -y -y
```
Steam Deck client shows corrupt graphics.
- Solution: the Steam Deck client works best on modern AMD GPUs but has also been reported as working on some Intel and NVIDIA graphics devices. Use the "Steam Desktop" application instead.

The full change log can be found here.

What's next?

Contributors

Thijzer

Assets 20

13 Nov 22:41

LukeShortCloud

3.2.0-rc.0

0eb337d

3.2.0-rc.0 Pre-release

Pre-release

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Built using archlinux-2022.11.01-x86_64.iso and SteamOS 3.3 packages.

Contributors

Thijzer

Assets 20

14 Jul 06:27

LukeShortCloud

3.1.1

a3cbf5a

3.1.1 - The Boot Fix Update

Want to help support our work? Consider donating via our Patreon page or helping out with open feature and bug GitHub issues. Our DEVELOPER.md guide provides all of the information you need to get started as a winesapOS contributor.

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Built using archlinux-2022.07.01-x86_64.iso and SteamOS 3.2 packages.

Feature highlights:

Boot issues have been fixed.
- For any users who have had issues booting winesapOS 3.0 or 3.1, it will now work in 3.1.1.
- Unforunately, the issues were from our Steam Big Picture theme for GRUB.
- Vimix is our new GRUB theme that works better across a wide range of hardware.
AUR packages are now pre-built and available in the winesapOS repository.
- Upgrades and custom builds are now a lot faster because of this.
WirePlumber is used as the audio server.
- It replaces pipewire-media-session.
- This aligns with what Arch Linux and SteamOS recommend as the modern PipeWire implementation to use.
- Upstream Arch Linux issues with upgrade conflicts regarding these packages has been addressed in winesapOS.

Project highlights:

Over 300 GitHub stars!
- We appreciate each and every single one of you! Keep the feature and bug reports coming in. winesapOS is made by Linux gamers for Linux gamers. We could not do this project without your support!

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.

Known issues:

Steam Deck client shows corrupt graphics.
- Solution: the Steam Deck client works best on modern AMD GPUs but has also been reported as working on some Intel and NVIDIA graphics devices. Use the "Steam Desktop" application instead.
Steam Deck client cannot login.
- Solution: please read this troubleshooting guide for how to workaround this. It applies to all Linux distributions and is not specific to the PS4Linux project.
"Add/Remove Software" (Pamac) fails to launch if it has been updated.
- Solution: Run the "winesapOS Upgrade" desktop shortcut to re-install an older version of Pamac that works.

The full change log can be found here.

What's next?

We are continuing work on a minimal image and automated CI/CD testing. For a full look into our roadmap, check out our planned milestones.

Assets 16

01 Jul 05:40

LukeShortCloud

3.1.0

3641a5f

3.1.0 - The Controllers and Flatpak Update

The full read me file for winesapOS can be found here.

Setup instructions and system requirements can be found here.

Built using archlinux-2022.06.01-x86_64.iso and SteamOS 3.2 packages.

Feature highlights:

Arch Linux packages have been updated.
- Official upstream SteamOS 3 uses Arch Linux packages from January 2022 (currently 5 months old) that have never been updated.
- We now use the latest upstream packages.
- This resolves many issues including AUR packages failing to build and KDE Plasma prompting for passwords twice.
Improved controller support.
- We now fully support controllers as much as the Steam Deck does.
Most applications are installed as Flatpaks now.
Improved graphics driver support for Intel and NVIDIA devices.
- We now provide modified SteamOS graphics drivers that re-enable support for all graphics devices (instead of being limited to only AMD devices).
winesapOS repository created.
- This contains pre-built packages from the AUR including linux-steamos, mesa-steamos, and lib32-mesa-steamos. We maintain all of these new SteamOS packages on the AUR.
Improved upgrades.
- The upgrade process is more stable and deals with known issues regarding SteamOS packages.
PlayStation 4 support.
- In collaboration with the PS4Linux project, a fork of winesapOS is available for the PS4.

Project highlights:

150 git commits since the last major update.
80 GitHub issues (bug and feature requests) addressed.
Over 200 GitHub stars!
- A huge thank you to our awesome community of supporters!

Upgrades:

Before upgrading, please read the upgrade notes.
Follow this guide in our README.md file on how to perform a system upgrade.

Known issues:

winesapOS boots to a black screen, boots to the UEFI menu, or boots into the GRUB menu again.
- Solution short-term: disable the Steam Big Picture theme for GRUB by commenting out GRUB_THEME in /etc/default/grub and then re-generating the GRUB configuration file with the command grub-mkconfig -o /boot/grub/grub.cfg.
- Solution long-term: winesapOS 3.1.1 will be released soon with a new theme that works better on all hardware.
Steam Deck client shows corrupt graphics.
- Solution: the Steam Deck client works best on modern AMD GPUs but has also been reported as working on some Intel and NVIDIA graphics devices. Use the "Steam Desktop" application instead.
Steam Deck client cannot login.
- Solution: please read this troubleshooting guide for how to workaround this. It applies to all Linux distributions and is not specific to the PS4Linux project.
"Add/Remove Software" (Pamac) fails to launch if it has been updated.
- Solution: Run the "winesapOS Upgrade" desktop shortcut to re-install an older version of Pamac that works.
Plasma sometimes crashes.
- Solution short-term: Plasma will ask to restart the session. Most applications will remain open but some may crash.
- Solution long-term: Upgrade Plasma, along with all system packages, with pacman -Syyu.

The full change log can be found here.

What's next?

This update lays the groundwork needed for us to support a minimal release image that will be a lot smaller in size. A lot of people have been asking for this and we're listening! For a full look into our roadmap, check out our planned milestones.

Assets 16

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Contributors

Contributors

Contributors

Releases: LukeShortCloud/winesapOS

4.0.0 - The Conversion Update

3.4.0 - The Game Mode Update

Contributors

3.3.0 - The Major Upgrade Update

3.2.1 - The SteamOS 3.4 Update

3.2.0 - The Minimal Image Update

Contributors

3.2.0-rc.0

3.2.0-beta.0

3.2.0-alpha.0

Contributors

3.1.1 - The Boot Fix Update

3.1.0 - The Controllers and Flatpak Update