winesapOS
4.2.0 - The Ventoy Update
Winesapos使設置Linux並在內部或便攜式外部驅動器上玩遊戲變得容易。
為什麼要使用Winesapos？
發布圖像可以在此處下載。
項目目標：
想幫助我們的工作嗎？考慮幫助解決開放功能和錯誤GitHub問題。我們的貢獻。 MD指南提供了您作為Winesapos貢獻者入門所需的所有信息。
目錄
這些就是MACOS在遊戲方面比Linux較差的原因。
noatime和nodiratime以不編寫文件和目錄的訪問時間。/tmp/ ， /var/log/和/var/tmp/ ）的臨時目錄被安裝為僅ram的文件系統。/home/目錄的每月快照。pacman軟件包管理器時，Snap-Pac都會拍攝快照。支持所有英特爾Mac。如今，Linux在開箱即用的大多數Mac上都可以使用。驅動程序已預安裝，用於丟失本機Linux支持的較新硬件。
要在內部驅動器上安裝，必須將Winesapos安裝為MacOS並旁邊的雙啟動。它將無法作為Intel Mac上唯一安裝的操作系統。
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 鍵盤 | 是的 | Linux-T2補丁 |
| 觸摸板 | 是的 | Linux-T2補丁 |
| NVME | 是的 | Linux-T2補丁 |
| 聲音 | 是的 | Linux-T2補丁和Apple-t2-audio-config |
| 粉絲 | 是的 | mbpfan |
| 藍牙 | 是的 | Linux-T2補丁和Apple-BCM-Firmware |
| 無線上網 | 是的 | BroadCom-WL和Apple-BCM-Firmware |
| 指紋掃描儀 | 不 | |
| 觸摸欄 | 是的 | Linux-T2補丁 |
有關藍牙和Wi-Fi支持的註釋，如果它不在框外工作：
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 鍵盤 | 是的 | Asusctl |
| 觸摸板 | 是的 | |
| NVME | 是的 | |
| 聲音 | 是的 | Linux-Firmware-asus |
| 粉絲 | 是的 | Asusctl |
| 藍牙 | 是的 | |
| 無線上網 | 是的 | |
| 指紋掃描儀 | 不 |
我們為原始的華碩ROG盟友和較新的華碩Rog Ally X提供了支持。
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 控制器 | 是的 | Linux-Nobara補丁 |
| NVME | 是的 | |
| 聲音 | 是的 | Linux-Nobara補丁 |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | |
| 無線上網 | 是的 | |
| 指紋掃描儀 | 不 |
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 控制器 | 是的 | Ayaneo-platform-dkms-git和Ayaled升級 |
| NVME | 是的 | |
| 聲音 | 是的 | AW87559-CIRMWARE |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | |
| 無線上網 | 是的 | |
| 指紋掃描儀 | 不 |
所有框架計算機都得到充分支持。
| 硬體 | 支持 | 筆記 |
|---|---|---|
| 鍵盤 | 是的 | |
| 觸摸板 | 是的 | 當鍵盤被內置時，Quirk添加到禁用 |
| NVME | 是的 | 為深度睡眠支持啟用了節能模式 |
| 聲音 | 是的 | 框架-DSP用於提高音頻質量 |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | |
| 無線上網 | 是的 | 自動設置區域以啟用Wi-Fi> = 5 |
| 指紋掃描儀 | 是的 | |
| LED矩陣 | 是的 | 用於管理LED矩陣的輸入模塊控制 |
對於框架筆記本電腦16，需要在BIOS中啟用對Linux的音頻支持。
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 控制器 | 是的 | |
| NVME | 是的 | |
| 聲音 | 是的 | |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | Linux-Nobara補丁 |
| 無線上網 | 是的 | |
| 指紋掃描儀 | 不 |
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 鍵盤 | 是的 | Linux-surface途徑 |
| 觸摸板 | 是的 | |
| NVME | 是的 | |
| 聲音 | 是的 | Linux-Surface補丁 |
| 粉絲 | 是的 | Linux-Surface補丁 |
| 藍牙 | 是的 | Linux-Surface補丁 |
| 無線上網 | 是的 | Linux-Surface補丁 |
| 指紋掃描儀 | 不 | |
| 觸控螢幕 | 是的 | IPTSD，Libwacom-Surface和Linux-Surface補丁 |
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 控制器 | 是的 | |
| NVME | 是的 | |
| 聲音 | 是的 | |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | |
| 無線上網 | 是的 | |
| 指紋掃描儀 | 不 |
蒸汽甲板LCD和OLED型號均得到完全支持。
| 硬體 | 支持 | 第三方駕駛員 |
|---|---|---|
| 控制器 | 是的 | |
| 觸摸板 | 是的 | |
| NVME | 是的 | |
| 聲音 | 是的 | Linux-Nobara補丁和Linux-Firmware-Walve |
| 粉絲 | 是的 | |
| 藍牙 | 是的 | Linux-Nobara補丁和Linux-Firmware-Walve |
| 無線上網 | 是的 | Linux-Nobara補丁和Linux-Firmware-Walve |
| 觸控螢幕 | 是的 |
我們正在與這些操作系統項目一起積極合作，以幫助向大眾提供更廣泛的Linux遊戲支持：
從Winesapos 3.1.0開始，我們現在為自己的存儲庫提供了一些預先構建的AUR包裝。該存儲庫在Arch Linux和Manjaro上工作。默認情況下，它在Winesapos上啟用。取決於您的分佈，以下是如何啟用它：
sudo sed -i s'/[core]/[winesapos]nServer = https://winesapos.lukeshort.cloud/repo/$repo/$archnn[core]/'g /etc/pacman.conf
sudo pacman -S -y -y
通過導入該密鑰，然後在本地簽名以信任它來啟用GPG密鑰。
sudo pacman-key --recv-keys 1805E886BECCCEA99EDF55F081CA29E4A4B01239
sudo pacman-key --init
sudo pacman-key --lsign-key 1805E886BECCCEA99EDF55F081CA29E4A4B01239
| 特徵 | Steamos 3 | Winesapos 4 |
|---|---|---|
| Steamos存儲庫 | 是的 | 不 |
| Arch Linux軟件包 | 老的 | 新的 |
| 引導兼容性 | UEFI | UEFI和Legacy Bios |
| 圖形驅動程序 | AMD | AMD，Intel，Nvidia，Parallels，VirtualBox和VMware |
| 音頻服務器 | 管道 | 管道 |
| 僅讀取文件系統 | 是的 | 不 |
| 加密文件系統 | 不 | 是（安全圖像） |
| 文件系統備份類型 | A/B分區 | BTRFS快照 |
| 可能的文件系統備份數量 | 1 | 無限 |
| 包裝經理（CLI） | Flatpak和Nix | Pacman，Paru/yay/Aur，Flatpak，Homebrew，Nix和Snap |
| 首選軟件包管理器（CLI） | Flatpak | Flatpak |
| 包裝經理（GUI） | 發現（Flatpak） | Discover（Flatpak），Bauh（Pacman，paru/yay/aur，flatpak和snap）和appimagepool（appimage） |
| 更新類型 | 基於圖像 | 軟件包管理器 |
| 安裝軟件包的數量 | 小的 | 小（最小圖像）或大（性能和安全圖像） |
| 遊戲發射器 | 蒸汽 | Steam，英雄遊戲發射器，Lutris，Nvidia Geforce Now，Open GamePad UI，Prism Launcher和Xbox Cloud Gaming |
| Linux內核 | 海王星（6.5） | Linux LTS（6.6）和Linux Nobara（最新） |
| 其他Apple Intel Mac驅動程序 | 不 | 是的 |
| 額外的華碩筆記本電腦司機 | 不 | 是的 |
| 其他華碩ROG盟友手持式驅動程序 | 不 | 是的 |
| 其他Ayaneo手持式司機 | 不 | 是的 |
| 其他框架計算機驅動程序 | 不 | 是的 |
| 聯想的其他軍團駕駛員 | 不 | 是的 |
| 其他Microsoft表面筆記本電腦驅動程序 | 不 | 是的 |
| 額外的Onexplayer手持式驅動程序 | 不 | 是的 |
| 桌面環境 | KDE等離子體5 | KDE等離子體6 |
| 桌面主題 | 汽 | 微風 |
| AMD FSR | 全球的 | 全球的 |
| Gamescope | 全球的 | 全球的 |
| 葡萄酒 | 質子 | 質子和GE-Proton |
| 遊戲控制器支持 | 大的 | 大的 |
| EXFAT跨平台存儲 | 不 | 是的（性能和安全圖像的16個吉布） |
Winesapos 3是第一個基於Steamos 3的Linux發行版。從歷史上看，這是Steamos 3的第一個叉子：
| 發行版 | 首次預覽 | 首次公開發行 |
|---|---|---|
| Winesapos | 2022-03-06 | 2022-03-10 |
| PS4的Steamos | 2022-03-09 | 2022-03-25 |
| Holoiso | 2022-04-21 | 2022-05-01 |
最低限度：
受到推崇的：
有關外部存儲的重要說明！
Winesapos的創建目標之一就是要便攜。但是，大多數閃存驅動器和SD/TF卡太慢，無法運行操作系統並提供良好的體驗。為了獲得最佳體驗，請使用這些推薦的閃存驅動器之一，外部USB-C> = 3.1 SSD或USB-C> = 3.2對接站或包括M.2 NVME驅動器插槽的docking Station或Hub。
Winesapos提供了3種不同的圖像類型，以滿足用戶的各種需求：
| 特徵 | 最小 | 表現 | 安全的 |
|---|---|---|---|
| CPU緩解 | 不 | 不 | 是的 |
| 加密 | 不 | 不 | 是的（luks） |
| 防火牆 | 不 | 不 | 是（防火牆） |
root密碼需要重置 | 不 | 不 | 是的 |
| 16 GIB EXFAT跨平台存儲 | 不 | 是的 | 是的 |
| 預構建的發布圖像 | 是的 | 是的 | 不 |
最小的根文件系統存檔（ winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst ）是從最小圖像中提取的文件。它可用於容器或在Docker或Podman容器，雙啟動或WSL 2方案中安裝Winesapos。
如果使用安全映像，則默認LUKS加密密鑰是password ，應該在第一個引導後更改。不要在第一個引導之前執行此操作，因為默認密碼用於解鎖分區，以便將其調整大小以填充整個存儲設備。更改第五個分區的Luks加密密鑰。
$ sudo cryptsetup luksChangeKey /dev/<DEVICE>5
winesap和root的用戶帳戶密碼與用戶名相同。 root用戶設置為立即到期。首次登錄後，將提示您輸入新密碼。這是如何更改它：
winesap的默認密碼。winesap的默認密碼。 root用戶帳戶已鎖定，直到更改密碼為止。建議立即更改此操作以允許恢復工作。
$ sudo passwd root
winesapos-<VERSION>-<TYPE>.img.zip Archive。在PC或Mac上。
dd CLI實用程序可用於閃爍圖像。Linux上的Gnome盒子。
$ qemu-img resize winesapos*.img +24G
使用MacOS上的Parallels Desktop（僅Intel）。
qemu-img convert -f raw -O vdi winesapos-<VERSION>-<TYPE>.img winesapos-<VERSION>-<TYPE>.vdi
prl_convert winesapos-<VERSION>-<TYPE>.vdi --allow-no-os --stand-alone-disk --dst=winesapos-<VERSION>-<TYPE>.hdd
使用Linux上的虛擬機管理器。
$ qemu-img resize winesapos*.img +24G
/var/lib/libvirt/images/ 。使用VirtualBox。
VBoxManage convertfromraw --format VDI winesapos-<VERSION>-<TYPE>.img winesapos-<VERSION>-<TYPE>.vdi
qemu-img convert -f raw -O vdi winesapos-<VERSION>-<TYPE>.img winesapos-<VERSION>-<TYPE>.vdi
使用MacOS上的VMware Fusion（僅Intel）。
VBoxManage convertfromraw --format VMDK winesapos-<VERSION>-<TYPE>.img winesapos-<VERSION>-<TYPE>.vmdk
qemu-img convert -f raw -O vmdk winesapos-<VERSION>-<TYPE>.img winesapos-<VERSION>-<TYPE>.vmdk
使用Linux或Windows上的VMware工作站。
默認帳戶具有鏡像用戶名的密碼集：
| 使用者名稱 | 密碼 |
|---|---|
| Winesap | Winesap |
| 根 | 根 |
首次登錄後，“ Winesapos首次設置”嚮導將推出。它將有助於設置圖形驅動程序，語言環境，時區等。強烈建議在第一個靴子上完成此操作。然後在使用Winesapos之前重新啟動以提供最佳體驗。
如果使用首次設置的建議默認值，並在重新啟動後，請按登錄屏幕上的Enter/return/return鍵（虛擬鍵盤上的底部右鍵），以進行無密碼登錄。
高級用戶可能需要創建一個自定義構建，而不是使用已經製作的釋放構建。這只需要1個吉布的自由空間才能下載實時Arch Linux環境。它還允許使用環境變量以與默認發布構建不同的方式配置構建。
將最新的Arch Linux ISO下載並設置到具有至少1 GB存儲的閃存驅動器上。
1a。即使我們沒有為其提供發布圖像，我們也支持使用Manjaro建造酒店。下載Manjaro的血漿，肉桂或Gnome桌面版。
引導到閃存驅動器。
更新已知的軟件包緩存並安裝git。
pacman -S -y
pacman -S git
克隆穩定的分支，然後轉到“腳本”目錄。
git clone --branch stable https://github.com/winesapos/winesapos.git
cd ./winesapos/scripts/
配置環境變量以自定義構建。至少，允許構建在裸機上工作，並定義要安裝的/dev/<DEVICE>阻止設備。請小心，因為這將刪除該設備上的所有現有數據！
export WINESAPOS_BUILD_IN_VM_ONLY=false
lsblk
export WINESAPOS_DEVICE=<DEVICE>
默認情況下，將構建性能圖像。或者，源源變量以配置構建，以使最小或安全的圖像改為製造。
. ./env/winesapos-env-minimal.sh
. ./env/winesapos-env-secure.sh
運行構建。
sudo -E bash ./winesapos-install.sh
檢查任何測試故障（該命令不應輸出）。
grep -P 'FAIL$' /winesapos/etc/winesapos/winesapos-install.log
有關構建過程的更多詳細信息，我們建議閱讀整個貢獻。 md指南。
配置要下載的Winesapos版本和要使用的容器引擎。
export WINESAPOS_VERSION="4.1.0"
#export WINESAPOS_CONTAINER_ENGINE="docker"
export WINESAPOS_CONTAINER_ENGINE="podman"
下載，解壓縮，然後導入根文件系統。大多數容器發動機僅支持GZIP壓縮（不是ZSTANDARD）。
curl -LO https://winesapos.lukeshort.cloud/repo/iso/winesapos-${WINESAPOS_VERSION}/winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst
zstd --decompress winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst
${WINESAPOS_CONTAINER_ENGINE} import winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar winesapos:${WINESAPOS_VERSION}
驗證是否導入容器圖像。
${WINESAPOS_CONTAINER_ENGINE} images | grep winesapos
# Example output: winesapos 4.1.0 23b9bb5f1c26 26 seconds ago 8.79GB
從Winesapos 4.1.0開始時，使用WSL 2在Windows> = 10上作為虛擬機施用。
安裝WSL 2。
下載winesapos-wsl.ps1腳本。
打開PowerShell並導航到下載的位置。
允許並運行PowerShell腳本。
PS C:UsersuserDownloads> powershell -ExecutionPolicy Bypass -File .winesapos-wsl.ps1
驗證出現新的“ Winesapos”虛擬機。
PS C:UsersuserDownloads> wsl --list
輸入虛擬機。
PS C:UsersuserDownloads> wsl --distribution winesapOS
驗證它是Winesapos。
cat /usr/lib/os-release-winesapos
| 使用者名稱 | 密碼 |
|---|---|
| 根 | 根 |
| Winesap | Winesap |
在安全圖像上，LUKS加密密鑰是password 。 Luks和root帳戶的密碼應立即更改。
$ sudo cryptsetup luksChangeKey /dev/<DEVICE>5
$ sudo passwd root
通過按下並釋放電源按鈕，將Mac引導到外部驅動器中。然後按下OPTION鍵（或Windows鍵盤上的ALT鍵）以訪問MAC Bootloader。選擇“ EFI啟動”設備。
重要的是使用Apple T2安全芯片的任何Mac，這些Mac都是在2018年和之後製造的所有Mac，都需要從外部存儲中啟動：
COMMAND和r鍵進入恢復模式。shutdown /s /f /t 0 ，通過握住“ shift”鍵來完全關閉窗口。從Winesapos 4.2.0開始，Ventoy得到了支持。它僅適用於UEFI啟動（不是傳統BIOS啟動）。 Winesapos調整根文件系統腳本當前與Ventoy不起作用，因此這對於恢復和故障排除目的最有用。
winesapos.vtoy 。如果還使用Linux或Windows，建議遵循“入門指南”將Winesapos安裝到自己的內部驅動器上。然後使用主板BIOS更改啟動設備。對於MacOS，將其安裝到內部驅動器的唯一方法是通過雙啟動。
但是，可以將Winesapos安裝到與Linux或Windows相同的驅動器上。這就是本指南將更詳細地介紹的內容。
只有uefi才能用於葡萄酒館的雙啟動安裝。對於Legacy Bios啟動，創建並閃爍普通的便攜式發行映像，例如最小或性能。這些都支持傳統BIOS靴子和UEFI。
首先安裝（如有必要）MACOS或Windows。然後繼續將witeesapos安裝到同一驅動器上。
僅支持英特爾Mac。
command和r鍵，直到出現Apple徽標。然後放開這兩個鑰匙。csrutil disable以禁用SIP。refind-bin-<VERSION>.zip 。./refind-install 。半自動步驟：
關注Winesapos入門指南，將最小圖像放到外部驅動器上。
啟動到外部驅動器上的winesapos。
使用GPARTED來分區免費存儲空間。標籤以零“ 0”（不是字母“ O”）的後綴。
運行“ Winesapos Dual-Boot Installer（Beta）”桌面快捷方式。
關閉計算機，拔下Winesapos外部驅動器，然後打開計算機。
允許再次啟動原始操作系統。
command 。一旦啟動到MacOS，請運行./refind-mkdefault （需要安裝Xcode）。 # Enable os-prober. It is disabled by default.
sudo crudini --ini-options=nospace --set /etc/default/grub "" GRUB_DISABLE_OS_PROBER false
sudo grub-mkconfig -o /boot/grub/grub.cfg
手動步驟：
關注Winesapos入門指南，將最小圖像放到外部驅動器上。
下載最新的winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst版本。
wos-drive 。啟動到外部驅動器上的winesapos。
使用GPARTED來分區免費存儲空間。標籤以零“ 0”（不是字母“ O”）的後綴。
使用Winesapos Optimizaitons和功能安裝新分區。
# View hints about each partition.
$ lsblk
$ sudo mount -t btrfs -o subvol=/,compress-force=zstd:1,discard,noatime,nodiratime -L winesapos-root0 /mnt
$ sudo btrfs subvolume create /mnt/.snapshots
$ sudo btrfs subvolume create /mnt/home
$ sudo mount -t btrfs -o subvol=/home,compress-force=zstd:1,discard,noatime,nodiratime -L winesapos-root0 /mnt/home
$ sudo btrfs subvolume create /mnt/home/.snapshots
$ sudo btrfs subvolume create /mnt/swap
$ sudo mount -t btrfs -o subvol=/swap,compress-force=zstd:1,discard,noatime,nodiratime -L winesapos-root0 /mnt/swap
$ sudo mkdir /mnt/boot
$ sudo mount --label winesapos-boot0 /mnt/boot
$ sudo mkdir /mnt/boot/efi
# Mount the FAT32 EFI partition.
# On macOS, use the newly created EFI partition.
# On Windows, use the existing EFI partition. This is usually the first partition and 100 MiB in size.
$ sudo mount /dev/<DEVICE>1 /mnt/boot/efi
提取Winesapos根文件系統存檔。
$ sudo tar --extract --keep-old-files --verbose --file /run/media/winesap/wos-drive/winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst --directory /mnt/
配置引導加載程序。
$ grep -v -P "winesapos|WOS" /mnt/etc/fstab | sudo tee /mnt/etc/fstab
$ genfstab -L /mnt | sudo tee -a /mnt/etc/fstab
$ sudo mount --rbind /dev /mnt/dev
$ sudo mount --rbind /sys /mnt/sys
$ sudo mount -t proc /proc /mnt/proc
$ sudo chroot /mnt grub-install --target=x86_64-efi --efi-directory=/boot/efi --bootloader-id=winesapOS
$ sudo chroot /mnt grub-mkconfig -o /boot/grub/grub.cfg
$ sudo chroot /mnt mkinitcpio -P
$ sudo sync
關閉計算機，拔下Winesapos外部驅動器，然後打開計算機。
Allow booting the original operating system again.
command while booting up. Once booted into macOS, run ./refind-mkdefault (requires Xcode to be installed). # Enable os-prober. It is disabled by default.
$ sudo crudini --ini-options=nospace --set /etc/default/grub "" GRUB_DISABLE_OS_PROBER false
$ sudo grub-mkconfig -o /boot/grub/grub.cfg
After logging in for the first time as the winesap user, the first-time setup for winesapOS will appear. Users have the option to manually select their choices or go with the recommended defaults below.
| 設定 | Recomended Default |
|---|---|
| Broadcom proprietary Wi-Fi driver | 自動的 |
| Rotate screen | 不 |
| Older version of winesapOS | Stop and prompt user |
| Pacman mirror region | Automatic (GeoIP) |
| Graphics driver | 檯面 |
| Swap method | zram |
| 時區 | Automatic (GeoIP) |
| Recommended producitvity apps | 是的 |
| Recommended gaming apps | 是的 |
| Passwordless login* | Yes (minimal and performance) and No (secure) |
| Hide GRUB boot menu | 是的 |
| Upgrade firmware | 是的 |
| Change user password | 是的 |
| Change root password | 是的 |
| 語言環境 | 問 |
*Press the enter/return key (the bottom-right key on the virtual keyboard) on the login screen for passwordless login.
Upgrades are supported and recommended between all minor releases of winesapOS. For example, it is supported to go from 3.0.0 to 3.2.1.
Where it makes sense, features are backported from newer versions of winesapOS. Bug and security fixes are also included to fix problems either with winesapOS itself or with upstream changes in Arch Linux. Even if a user never upgrades winesapOS, users will continue to get regular system upgrades from Arch Linux.
Before upgrading, please read the full UPGRADE.md notes. This showcases what updates will happen automatically and what updates may need to be manually applied.
Development builds do not support upgrades. Here are the releases that we do support upgrades on:
| 發布 | Upgrades Supported |
|---|---|
| 穩定的 | 是的 |
| Release Candidate (RC) | 是的 |
| beta | 不 |
| 阿爾法 | 不 |
Here is how to upgrade winesapOS. Do NOT use "Applications (bauh)" for upgrades, only for package installations.
GUI = Launch the "winesapOS Upgrade" desktop shortcut.
CLI = Launch the winesapOS upgrade script from the stable branch.
curl https://raw.githubusercontent.com/winesapOS/winesapOS/stable/scripts/winesapos-upgrade.sh | sudo -E bash
Terminator . echo stick > /tmp/winesapos_user_name.txt
export WINESAPOS_UPGRADE_FILES=false
export WINESAPOS_UPGRADE_VERSION_CHECK=false
curl https://raw.githubusercontent.com/winesapOS/winesapOS/stable/scripts/winesapos-upgrade.sh | sudo -E bash
curl https://raw.githubusercontent.com/winesapOS/winesapOS/stable/scripts/winesapos-upgrade.sh | sudo -E bash
If desired, it is possible to remove winesapOS specific files and configuration and switch back to upstream Arch Linux using an uninstall script. It will not remove anything that is related to improved hardware compatibility.
curl https://raw.githubusercontent.com/winesapOS/winesapOS/stable/scripts/winesapos-uninstall.sh | sudo -E bash
It is possible to get an experience similar to winesapOS but on a different Linux distribution by installing applications that winesapOS provides.
What this conversion script does:
What it does NOT do:
Run this script to convert to winesapOS:
curl https://raw.githubusercontent.com/winesapOS/winesapOS/stable/scripts/winesapos-convert.sh | bash
Plug additional hardware into a USB hub. Connect the USB hub to the computer before booting.
Do NOT move the USB hub after plugging it in and booting up Linux. It can easily disconnect leading to a corrupt file system.
Consider buying an SSD instead of a flash drive for a longer life-span, more storage, and faster speeds.
Delete old Btrfs backups when the drive is running low on storage space.
$ sudo snapper list
$ sudo snapper delete <SNAPSHOT_NUMBER>
Enable Proton for all Windows games. This will allow them to run in Linux. For more information about Proton, read this starter guide. Check the compatibility rating for games on Steam by using ProtonDB.
Settings > Steam Play > Enable Steam Play for Support Titles > Use this tool instead of game-specific selections from Steam > Compatibility tool: > (select the latest "Proton" version available) > OK
On the SDDM login screen for the "winesap" user, the "Session" drop-down menu in the top-left can be used to change the session from "Plasma (Wayland)" to "Steam Big Picture (Wayland)". This provides the same experience as having a Steam Deck in "Game Mode" by launching Steam with Gamescope Session.
Switch from Game Mode to Desktop Mode:
已知問題：
Alternatively, Steam can be launched from KDE Plasma using the "Steam (Runtime)" desktop shortcut. Then it can be changed to be in the new Big Picture Mode.
There is also a session for Open Gamepad UI as an open source alternative front-end. Select the "OpenGamepadUI (Wayland)" session on the SDDM login screen. It has plugins for Steam, Lutris, and more.
When Mac hardware is detected, all sound is muted on boot because, on newer Macs, the experimental sound driver is extremely loud. This means that any volume changes will be reset on the next boot. Disable and stop the user (not system) mute service to allow the sound volume to be saved:
systemctl --user disable --now winesapos-mute.service
Snapper creates 6 monthly snapshots of the /home directory. snap-pac creates a snapshot of the root / directory before and after using pacman . Both the root and home configurations are set to only use a maximum of 50 GiB each.
During boot, GRUB will have a "winesapOS snapshots" section that will allow booting from a root directory snapshot. This will not appear on first boot because no backups have been taken yet. After a backup has been taken, the GRUB configuration file needs to be regenerated to scan for the new backups.
Manually rebuild the GRUB configuration file to load the latest snapshots:
$ sudo grub-mkconfig -o /boot/grub/grub.cfg
View the available backups:
$ sudo snapper -c root list
$ sudo snapper -c home list
Manually create a new backup:
$ sudo snapper -c <CONFIG> create
Manually delete a backup:
$ sudo snapper -c <CONFIG> delete <BACKUP_NUMBER>
A VPN is required for LAN gaming online. Use the free and open source ZeroTier VPN service for this.
主持人
客戶
Start the ZeroTier VPN service.
$ sudo systemctl enable --now zerotier-one
Connect to the ZeroTier network.
$ sudo zerotier-cli join <NETWORK_ID>
Challenge: the release image fails to be extracted from the zip file.
Solutions:
Verify the integrity of the downloaded zip files.
Linux:
sha512sum --check winesapos-<VERSION>-<TYPE>.sha512sum.txt
Windows (open Command Prompt as Administrator):
C:Windowssystem32>CertUtil.exe -hashfile C:Users<USER>Downloadswinesapos-<VERSION>-<TYPE>.sha512sum.txt SHA512
Not enough free space. Ensure you have 13 GiB (minimal image) or 31 GiB (performance image) of free space before downloading the zip files.
If using PeaZip, it sometimes fails to extract to the current directory. Try extracting to a different directory.
There are many different reasons why winesapOS may not be booting.
Challenge: the root file system does not resize itself to use all available space on the storage device.
解決方案：
Re-enable the resize service, reboot, and then view the service log. Open up a GitHub Issue with the full log output.
sudo systemctl enable winesapos-resize-root-file-system
sudo reboot
sudo journalctl --unit winesapos-resize-root-file-system
If using an external USB drive, it is possible to get errors about a Read-only file system . This is a hardware issue and indicates that the USB drive has been disconnected even if only for a fraction of a second. Short-term, reboot winesapOS to fix these errors. Long-term, try using a different USB port and/or drive and make sure that the drive does not move while in use. For the best experience, we recommend using an internal drive.
Challenge: If Wi-Fi or Bluetooth is not working and Windows is installed, it could be from fast startup being enabled and/or Windows hibernating.
Solutions:
Challenge: the amount of reported free space seems too small or large.
Solutions:
Btrfs is used as the root file system on winesapOS. The most reliable way to view the amount of storage in-use on Btrfs is with this command.
sudo btrfs filesystem df /
Snapper is used to take Btrfs snapshots (1) every time Pacman installs, upgrades, or removes a package and (2) every month. Refer to the Btrfs Backups section for more information on how to manage those snapshots.
If the first-time setup fails or needs debugging, the last log file can be found and copied to the desktop by running these two commands:
$ sudo cp "/etc/winesapos/$(sudo ls -1 /etc/winesapos/ | grep setup | tail -n 1)" /home/winesap/Desktop/
$ sudo chown winesap:winesap "/home/winesap/Desktop/$(ls -1 ~/Desktop/ | grep setup_)"
Challenge: winesapOS uses labels for file system mounts which confuses the system if more than one label is found.
解決方案：
Change the file system label of at least the root file system on one of the winesapOS drives. It is recommended to change all of the labels on that same drive. This can cause an unbootable system. Manually review the contents of /etc/fstab to ensure it is correct.
# Labels can be changed on mounted file systems.
lsblk -o name,label
export DEVICE=vda
sudo -E exfatlabel /dev/${DEVICE}2 wos-drive0
sudo -E fatlabel /dev/${DEVICE}3 WOS-EFI0
sudo sed -i s'/LABEL=WOS-EFI/LABEL=WOS-EFI0/'g /etc/fstab
sudo -E e2label /dev/${DEVICE}4 winesapos-boot0
sudo sed -i s'/LABEL=winesapos-boot/LABEL=winesapos-boot0/'g /etc/fstab
sudo btrfs filesystem label / winesapos-root0
sudo btrfs filesystem show /
sudo sed -i s'/LABEL=winesapos-root/LABEL=winesapos-root0/'g /etc/fstab
lsblk -o name,label
# GRUB needs to be updated with the new /etc/fstab information.
sudo chroot <MOUNTED_ROOT_AND_BOOT_DIRECTORY> grub-mkconfig -o /boot/grub/grub.cfg
Challenges:
解決方案：
At the GRUB boot menu select "winesapOS snapshots" and then the desired backup to load. The filesystem will be read-only by default. It can be set to enable writes with this command:
$ sudo btrfs property set -ts /.snapshots/<BTRFS_SNAPSHOT_ID> ro false
For more advanced recovery using overlayfs on-top of a read-only filesystem, refer to this grub-btrfs GitHub issue.
Reinstalling winesapOS on-top of an existing winesapOS installation of the same exact version and image type can cause issues. This is because the partitions are perfectly aligned which leads to overlapping data. Even wiping the partition table is not enough. For the best results, it is recommended to completely wipe at least the first 25 GiB of the storage device. WARNING: This will delete any existing data on that storage device.
dd if=/dev/zero of=/dev/<DEVICE> bs=1M count=25000
When using a portable device such as a laptop or gaming handheld, the operating system goes into a battery saver mode by default. This can be disabled to get maximum performance.
sudo systemctl disable --now auto-cpufreq
wine - sap - o - s .Here are community contributors who have helped the winesapOS project.
創始人：
代碼：
金融的：
These are anonymous surveys done with Linux gaming community members. Most, but not all, are winesapOS users.
Favorite (non-Valve) handheld PC brand:
6 votes.
There were no comments about what the "Other" brand is so that is unknown.
https://twitter.com/LukeShortCloud/status/1649078025634598912
Favorite desktop environments:
25 votes.
"Other" included specific mentions from the community about Cinnamon (for its similarity to Windows) and Sway (for its tiling features).
https://twitter.com/LukeShortCloud/status/1659279345926516737
| Release Version/Tag | Project Name | 作業系統 | Desktop Environment | Release Images |
|---|---|---|---|---|
| 4.2.0 | winesapOS | Arch Linux | KDE Plasma | Performance, Minimal, and Minimal Root File System |
| 4.1.0 | winesapOS | Arch Linux | KDE Plasma | Performance, Secure, Minimal, and Minimal Root File System |
| 4.0.0 | winesapOS | Arch Linux | KDE Plasma | Performance, Secure, and Minimal |
| 3.2.0 | winesapOS | SteamOS 3 | KDE Plasma | Performance, Secure, and Minimal |
| 3.0.0 | winesapOS | SteamOS 3 | KDE Plasma | Performance and Secure |
| 2.2.0 | Mac Linux Gaming Stick | 曼賈羅 | 肉桂 | Performance and Secure |
| 2.0.0 | Mac Linux Gaming Stick | 曼賈羅 | 肉桂 | 表現 |
| 1.0.0 | Mac Linux Gaming Stick | Ubuntu 20.04 | 肉桂 | 沒有任何 |
GPLV3
