winesapOS
4.2.0 - The Ventoy Update
Winesapos facilita la configuración de Linux y juega los juegos de una unidad externa interna o portátil.
¿Por qué usar Winesapos?
Las imágenes de lanzamiento se pueden descargar aquí.
Objetivos del proyecto:
¿Quieres ayudar a apoyar nuestro trabajo? Considere ayudar con la función abierta y los problemas de errores. Nuestra Guía de MD contribuye con toda la información que necesita para comenzar como colaborador de Winesapos.
TABLA DE CONTENIDO
Estas son razones por las cuales MacOS es inferior en comparación con Linux cuando se trata de juegos.
noatime y nodiratime para no escribir los tiempos de acceso para archivos y directorios./tmp/ , /var/log/ y /var/tmp/ ) se montan como sistemas de archivos solo de RAM./home/ .pacman Package Manager.Todos los Intel Mac son compatibles. Linux funciona en la mayoría de las Macs fuera de la caja en estos días. Los controladores están preinstalados para el hardware más nuevo donde falta soporte nativo de Linux.
Para la instalación en una unidad interna, Winesapos debe instalarse como un botín de doble junto con macOS. No funcionará como el único sistema operativo instalado en un Intel Mac.
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Teclado | Sí | Patches Linux-T2 |
| Panel táctil | Sí | Patches Linux-T2 |
| Nvme | Sí | Patches Linux-T2 |
| Sonido | Sí | Patches Linux-T2 y Apple-T2-Audio-Config |
| Admiradores | Sí | mbpfan |
| Bluetooth | Sí | Patches Linux-T2 y MAPPLE-BCM-Firmware |
| Wi-Fi | Sí | Broadcom-WL y Apple-BCM-Firmware |
| Escáner de huellas digitales | No | |
| Barra táctil | Sí | Patches Linux-T2 |
Notas sobre el soporte Bluetooth y Wi-Fi si no está funcionando fuera de la caja:
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Teclado | Sí | asustl |
| Panel táctil | Sí | |
| Nvme | Sí | |
| Sonido | Sí | Linux-circulware-asus |
| Admiradores | Sí | asustl |
| Bluetooth | Sí | |
| Wi-Fi | Sí | |
| Escáner de huellas digitales | No |
Brindamos soporte tanto para el ASUS ROG aliado original como para el nuevo ASUS ROG Ally X.
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Controlador | Sí | parches de Linux-Nobara |
| Nvme | Sí | |
| Sonido | Sí | parches de Linux-Nobara |
| Admiradores | Sí | |
| Bluetooth | Sí | |
| Wi-Fi | Sí | |
| Escáner de huellas digitales | No |
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Controlador | Sí | Ayaneo-Platform-DKMS-Git y Ayaled actualizado |
| Nvme | Sí | |
| Sonido | Sí | AW87559-Cirmware |
| Admiradores | Sí | |
| Bluetooth | Sí | |
| Wi-Fi | Sí | |
| Escáner de huellas digitales | No |
Todas las computadoras marco son totalmente compatibles.
| Hardware | Compatible | Notas |
|---|---|---|
| Teclado | Sí | |
| Panel táctil | Sí | Quirk agregado para deshabilitar cuando el teclado está en uso |
| Nvme | Sí | Modo de ahorro de energía habilitado para soporte de sueño profundo |
| Sonido | Sí | Framework-DSP utilizado para mejorar la calidad de audio |
| Admiradores | Sí | |
| Bluetooth | Sí | |
| Wi-Fi | Sí | La región se establece automáticamente para habilitar Wi-Fi> = 5 |
| Escáner de huellas digitales | Sí | |
| Matriz LED | Sí | InputModule-Control utilizado para administrar matrices LED |
Para la computadora portátil Framework 16, el soporte de audio para Linux debe habilitarse en el BIOS.
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Controlador | Sí | |
| Nvme | Sí | |
| Sonido | Sí | |
| Admiradores | Sí | |
| Bluetooth | Sí | parches de Linux-Nobara |
| Wi-Fi | Sí | |
| Escáner de huellas digitales | No |
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Teclado | Sí | Pathces de la superficie de Linux |
| Panel táctil | Sí | |
| Nvme | Sí | |
| Sonido | Sí | parches de la superficie de Linux |
| Admiradores | Sí | parches de la superficie de Linux |
| Bluetooth | Sí | parches de la superficie de Linux |
| Wi-Fi | Sí | parches de la superficie de Linux |
| Escáner de huellas digitales | No | |
| Pantalla táctil | Sí | Parches IPTSD, Libwacom-Surface y Linux-Surface |
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Controlador | Sí | |
| Nvme | Sí | |
| Sonido | Sí | |
| Admiradores | Sí | |
| Bluetooth | Sí | |
| Wi-Fi | Sí | |
| Escáner de huellas digitales | No |
Tanto los modelos LCD y OLED de Steam Deck son totalmente compatibles.
| Hardware | Compatible | Controlador (s) de terceros |
|---|---|---|
| Controlador | Sí | |
| Panel táctil | Sí | |
| Nvme | Sí | |
| Sonido | Sí | Patches de Linux-Nobara y Válvula de Linux-Cirmware |
| Admiradores | Sí | |
| Bluetooth | Sí | Patches de Linux-Nobara y Válvula de Linux-Cirmware |
| Wi-Fi | Sí | Patches de Linux-Nobara y Válvula de Linux-Cirmware |
| Pantalla táctil | Sí |
Estamos trabajando activamente junto con estos proyectos de sistemas operativos para ayudar a proporcionar un soporte de juego Linux más amplio a las masas:
A partir de Winesapos 3.1.0, ahora proporcionamos a nuestro propio repositorio algunos paquetes AUR previamente construidos. Este repositorio funciona en Arch Linux y Manjaro. Está habilitado en Winesapos de forma predeterminada. Dependiendo de la distribución en la que se encuentre, así es como se puede habilitar:
sudo sed -i s'/[core]/[winesapos]nServer = https://winesapos.lukeshort.cloud/repo/$repo/$archnn[core]/'g /etc/pacman.conf
sudo pacman -S -y -y
Habilite la tecla GPG que se use importando y luego firmando localmente la clave para confiar en ella.
sudo pacman-key --recv-keys 1805E886BECCCEA99EDF55F081CA29E4A4B01239
sudo pacman-key --init
sudo pacman-key --lsign-key 1805E886BECCCEA99EDF55F081CA29E4A4B01239
| Características | Steamos 3 | Winesapos 4 |
|---|---|---|
| Repositorios de Steamos | Sí | No |
| Paquetes Arch Linux | Viejo | Nuevo |
| Compatibilidad de arranque | UEFI | UEFI y BIOS Legacy |
| Controladores gráficos | Amd | AMD, Intel, Nvidia, Parallels, Virtualbox y VMware |
| Servidor de audio | Pipewire | Pipewire |
| Sistema de archivos de solo lectura | Sí | No |
| Sistema de archivos cifrado | No | Sí (imagen segura) |
| Tipo de copia de seguridad del sistema de archivos | Particiones A/B | Instantáneas BTRFS |
| Número de copias de seguridad del sistema de archivos posibles | 1 | Ilimitado |
| Gerentes de paquetes (CLI) | Flatpak y nix | Pacman, Paru/Yay/Aur, Flatpak, Homebrew, Nix y Snap |
| Administrador de paquetes preferidos (CLI) | platero | platero |
| Gerentes de paquetes (GUI) | Descubrir (platpak) | Discover (Flatpak), Bauh (Pacman, Paru/Yay/Aur, Flatpak y Snap) y AppIMagePool (Appimage) |
| Tipo de actualización | Basado en imágenes | Administrador de paquetes |
| Número de paquetes instalados | Pequeño | Pequeño (imagen mínima) o grande (imágenes de rendimiento y seguras) |
| Lanzador de juegos | Vapor | Steam, Heroic Games Launcher, Lutris, Nvidia GeForce Now, Open GamePad UI, Prism Launcher y Xbox Cloud Gaming |
| Núcleos de Linux | Neptuno (6.5) | Linux LTS (6.6) y Linux Nobara (último) |
| Controladores adicionales de Apple Intel Mac | No | Sí |
| Conductores adicionales de la computadora portátil Asus | No | Sí |
| Conductores de mano ASUS ROG ASUS ROG | No | Sí |
| Conductores portátiles adicionales de Ayaneo | No | Sí |
| Controladores de computadora marco adicionales | No | Sí |
| Conductores adicionales de la Legión Lenovo Go Go | No | Sí |
| Controladores adicionales de la computadora portátil Microsoft Surface | No | Sí |
| Controladores de mano OnexPlayer adicionales | No | Sí |
| Entorno de escritorio | KDE Plasma 5 | KDE Plasma 6 |
| Tema de escritorio | Vapor | Brisa |
| AMD FSR | Global | Global |
| Gamescope | Global | Global |
| Vino | Protón | Proton y Ge-propon |
| Soporte del controlador de juego | Grande | Grande |
| EXFAT Almacenamiento multiplataforma | No | Sí (16 GIB en el rendimiento y las imágenes seguras) |
Winesapos 3 fue la primera distribución de Linux que se basó en Steamos 3. Históricamente, aquí están las primeras horquillas de Steamos 3:
| Distribuir | Primera vista previa | Primer lanzamiento público |
|---|---|---|
| Winesapos | 2022-03-06 | 2022-03-10 |
| Vapor para PS4 | 2022-03-09 | 2022-03-25 |
| Holoiso | 2022-04-21 | 2022-05-01 |
Mínimo:
Recomendado:
¡Nota importante sobre el almacenamiento externo!
Uno de los objetivos fundadores de Winesapos era que fuera portátil. Sin embargo, la mayoría de las unidades flash y las tarjetas SD/TF son demasiado lentas para ejecutar un sistema operativo y proporcionar una buena experiencia. Para obtener la mejor experiencia, use una de estas unidades flash recomendadas, un SSD USB-C> = 3.1 externo o una estación de acoplamiento USB-C> = 3.2 que incluye una ranura de unidad M.2 NVME.
Winesapos proporciona 3 tipos de imágenes diferentes para satisfacer las diversas necesidades de nuestros usuarios:
| Característica | Mínimo | Actuación | Seguro |
|---|---|---|---|
| Mitigaciones de la CPU | No | No | Sí |
| Encriptación | No | No | Sí (luks) |
| Cortafuegos | No | No | Sí (Firewalld) |
La contraseña root requiere restablecer | No | No | Sí |
| 16 Almacenamiento multiplataforma GIB EXFAT | No | Sí | Sí |
| Imagen de lanzamiento previamente construida | Sí | Sí | No |
El archivo mínimo del sistema de archivos raíz ( winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst ) son los archivos extraídos de la imagen mínima. Se puede usar para contenedores o instalar Winesapos en un contenedor Docker o Podman, un escenario de doble botín o WSL 2.
Si usa la imagen segura, la clave de cifrado LUKS predeterminada es password que debe cambiarse después del primer arranque. No haga esto antes del primer arranque, ya que la contraseña predeterminada se usa para desbloquear la partición, ya que se puede cambiar el tamaño para completar todo el dispositivo de almacenamiento. Cambie la clave de cifrado LUKS para la quinta partición.
$ sudo cryptsetup luksChangeKey /dev/<DEVICE>5
La contraseña de la cuenta de usuario para winesap y root son las mismas que el nombre de usuario. El usuario root está configurado para caducar de inmediato. Tras el primer inicio de sesión, se le pedirá que ingrese una nueva contraseña. Aquí está cómo cambiarlo:
winesap .winesap nuevamente. La cuenta de usuario root se bloquea hasta que se cambia la contraseña. Se recomienda cambiar esto de inmediato para permitir que la recuperación funcione.
$ sudo passwd root
winesapos-<VERSION>-<TYPE>.img.zip .en una PC o Mac.
dd CLI se puede usar para flashear la imagen.con cajas de gnomo en Linux.
$ qemu-img resize winesapos*.img +24G
con paralelo de escritorio en macOS (solo 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
con Virtual Machine Manager en Linux.
$ qemu-img resize winesapos*.img +24G
/var/lib/libvirt/images/ .con 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
con VMware Fusion en MacOS (solo 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
con VMware Workstation en Linux o Windows.
Las cuentas predeterminadas tienen una contraseña establecida que refleja el nombre de usuario:
| Nombre de usuario | Contraseña |
|---|---|
| winesap | winesap |
| raíz | raíz |
Tras el primer inicio de sesión, el Asistente "Configuración por primera vez de Winesapos" se lanzará. Ayudará a configurar los controladores de gráficos, la ubicación local, la zona horaria y más. Se recomienda completar esto en el primer arranque. Luego reinicie antes de usar Winesapos para proporcionar la mejor experiencia.
Si se usa los valores predeterminados recomendados de la configuración por primera vez y después de reiniciar, presione la tecla ENTER/return (la tecla inferior derecha en el teclado virtual) en la pantalla de inicio de sesión para el inicio de sesión sin contraseña.
En lugar de usar una compilación de lanzamiento que ya está realizada, los usuarios avanzados pueden querer crear una compilación personalizada. Esto solo requiere 1 GIB de espacio libre para descargar el entorno Live Arch Linux. También permite el uso de variables de entorno para configurar la compilación de manera diferente a las compilaciones de versión predeterminadas.
Descargue y configure el último Arch Linux ISO en una unidad flash que tiene al menos 1 GB de almacenamiento.
1a. También apoyamos la construcción de Winesapos con Manjaro a pesar de que no proporcionamos imágenes de lanzamiento para ello. Descargue la edición de escritorio Plasma, Cinnamon o Gnome de Manjaro.
Arrancar en la unidad flash.
Actualice los paquetes conocidos de caché e instale git.
pacman -S -y
pacman -S git
Clone la rama estable y vaya al directorio "Scripts".
git clone --branch stable https://github.com/winesapos/winesapos.git
cd ./winesapos/scripts/
Configure las variables de entorno para personalizar la compilación. Como mínimo, permita que la compilación funcione en un metal desnudo y defina el dispositivo de bloques para instalar el dispositivo de bloques /dev/<DEVICE> . ¡Tenga cuidado ya que esto eliminará todos los datos existentes en ese dispositivo!
export WINESAPOS_BUILD_IN_VM_ONLY=false
lsblk
export WINESAPOS_DEVICE=<DEVICE>
Por defecto, se construirá la imagen de rendimiento. Alternativamente, obtenga las variables de entorno para configurar la compilación para hacer la imagen mínima o segura.
. ./env/winesapos-env-minimal.sh
. ./env/winesapos-env-secure.sh
Ejecute la construcción.
sudo -E bash ./winesapos-install.sh
Verifique las fallas de prueba (no debe haber salida de este comando).
grep -P 'FAIL$' /winesapos/etc/winesapos/winesapos-install.log
Para obtener información más detallada sobre el proceso de compilación, recomendamos leer la guía completa de contribuyentes.
Configure la versión Winesapos para descargar y el motor de contenedores para usar.
export WINESAPOS_VERSION="4.1.0"
#export WINESAPOS_CONTAINER_ENGINE="docker"
export WINESAPOS_CONTAINER_ENGINE="podman"
Descargue, descomprima y luego importe el sistema de archivos raíz. La mayoría de los motores de contenedores solo admiten la compresión GZIP (no 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}
Verifique que se importara la imagen del contenedor.
${WINESAPOS_CONTAINER_ENGINE} images | grep winesapos
# Example output: winesapos 4.1.0 23b9bb5f1c26 26 seconds ago 8.79GB
A partir de Winesapos 4.1.0, se admite que se ejecuta como una máquina virtual en Windows> = 10 usando WSL 2.
Instale WSL 2.
Descargue el script Winesapos-WSL.PS1.
Abra PowerShell y navegue a la ubicación descargada.
Permitir y ejecutar el script PowerShell.
PS C:UsersuserDownloads> powershell -ExecutionPolicy Bypass -File .winesapos-wsl.ps1
Verifique que aparezca una nueva máquina virtual "Winesapos".
PS C:UsersuserDownloads> wsl --list
Ingrese la máquina virtual.
PS C:UsersuserDownloads> wsl --distribution winesapOS
Verifique que sea Winesapos.
cat /usr/lib/os-release-winesapos
| Nombre de usuario | Contraseña |
|---|---|
| raíz | raíz |
| winesap | winesap |
En la imagen segura, la clave de cifrado de Luks es password . La contraseña para LUKS y la cuenta root debe cambiarse de inmediato.
$ sudo cryptsetup luksChangeKey /dev/<DEVICE>5
$ sudo passwd root
Arrene la Mac en una unidad externa presionando y liberando el botón de encendido. Luego mantenga presionado la tecla OPTION (o la tecla ALT en un teclado de Windows) para acceder al cargador de arranque Mac. Seleccione el dispositivo "Boot EFI".
IMPORTANTE CUALQUIER Mac con un chip de seguridad de Apple T2, que son todas las Mac hechas en y después de 2018, necesita permitir el arranque del almacenamiento externo:
COMMAND y las teclas r para ingresar al modo de recuperación.shutdown /s /f /t 0 .A partir de Winesapos 4.2.0, Ventoy es compatible. Solo funciona con UEFI Boot (no BOOS Legacy BIOS). El script del sistema de archivos raíz de Redieve Winesapos actualmente no funciona con Ventoy, por lo que esto es más útil para fines de recuperación y resolución de problemas.
winesapos.vtoy .Se recomienda seguir la Guía Getting Start para instalar Winesapos en su propia unidad interna si también usa Linux o Windows. Luego use el BIOS de la placa base para cambiar el dispositivo de arranque. Para MacOS, la única forma de instalarlo en la unidad interna es a través de doble botín.
Sin embargo, es posible instalar Winesapos en la misma unidad que Linux o Windows. Eso es lo que esta guía cubrirá con más detalle.
Solo UEFI es compatible con las instalaciones de doble botín de Winesapos. Para Legacy BIOS Boot, cree y flashee una imagen de liberación portátil normal, como la mínima o el rendimiento. Todos los que apoyan tanto el Legacy BIOS Boot como la UEFI.
Instale (si es necesario) MacOS o Windows primero. Luego continúe con la instalación de Winesapos en la misma unidad.
Solo se admiten Intel Macs.
command y las teclas r hasta que aparezca el logotipo de Apple. Entonces suelta esas dos teclas.csrutil disable para deshabilitar SIP.refind-bin-<VERSION>.zip ../refind-install .Pasos semiautomáticos:
Siga la guía de inicio de Winesapos para obtener la imagen mínima en una unidad externa.
Arrancar en Winesapos que está en la unidad externa.
Use gparted para dividir el espacio de almacenamiento gratuito. Las etiquetas están sufectadas con el número cero "0" (no la letra "O").
Ejecute el atajo de escritorio "Winesapos Dual-Boot Installer (Beta)".
Apague la computadora, desenchufe la unidad externa Winesapos y luego encienda la computadora.
Permitir el arranque del sistema operativo original nuevamente.
command mientras se inicia. Una vez arrancado en macOS, ejecute ./refind-mkdefault (requiere que se instale 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
Pasos manuales:
Siga la guía de inicio de Winesapos para obtener la imagen mínima en una unidad externa.
Descargue el último winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst versión.
wos-drive .Arrancar en Winesapos que está en la unidad externa.
Use gparted para dividir el espacio de almacenamiento gratuito. Las etiquetas están sufectadas con el número cero "0" (no la letra "O").
Monte las nuevas particiones con Winesapos Optimizaitons y características.
# 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
Extraiga el archivo del sistema de archivos raíz Winesapos.
$ sudo tar --extract --keep-old-files --verbose --file /run/media/winesap/wos-drive/winesapos-${WINESAPOS_VERSION}-minimal-rootfs.tar.zst --directory /mnt/
Configure el cargador de arranque.
$ 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
Apague la computadora, desenchufe la unidad externa Winesapos y luego encienda la computadora.
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.
| Configuración | Recomended Default |
|---|---|
| Broadcom proprietary Wi-Fi driver | Automático |
| Girar la pantalla | No |
| Older version of winesapOS | Stop and prompt user |
| Pacman mirror region | Automatic (GeoIP) |
| Graphics driver | Colina baja |
| Swap method | zram |
| Huso horario | Automatic (GeoIP) |
| Recommended producitvity apps | Sí |
| Recommended gaming apps | Sí |
| Passwordless login* | Yes (minimal and performance) and No (secure) |
| Hide GRUB boot menu | Sí |
| Upgrade firmware | Sí |
| Change user password | Sí |
| Change root password | Sí |
| Lugar | Preguntar |
*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:
| Liberar | Upgrades Supported |
|---|---|
| Estable | Sí |
| Release Candidate (RC) | Sí |
| Beta | No |
| Alfa | No |
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:
Problemas conocidos:
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.
Anfitrión
Clientela
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.
Soluciones:
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.
Solución:
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.
Soluciones:
Challenge: the amount of reported free space seems too small or large.
Soluciones:
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.
Solución:
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
Desafíos:
Solución:
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.
Fundador:
Código:
Financiero:
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 | Sistema operativo | 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 | Manjaro | Canela | Performance and Secure |
| 2.0.0 | Mac Linux Gaming Stick | Manjaro | Canela | Actuación |
| 1.0.0 | Mac Linux Gaming Stick | Ubuntu 20.04 | Canela | Ninguno |
GPLV3
