A script to easily set up a SteamOS-like gaming environment on Arch Linux. This script is designed to bring SteamOS-style session switching to Arch Linux. It automates the installation and setup of a Gaming Mode (Gamescope) and a Desktop Mode (Wayland session), along with configuration for SDDM and several optional components.

• Wayland Session Selector: Allows you to choose a desktop session for your system.
• Gamescope Gaming Mode: Switch to a full-screen gaming experience similar to SteamOS. It uses gamescope-session-steam (Thanks to ChimeraOS team for this).
• GUI Helper: Easy configuration with GUI made with Zenity.
• SDDM Configuration: Automatically configures SDDM for autologin.
• Shortcut Creation: Adds a desktop shortcut for easy switching to Gaming Mode.
• Optional Tools: Offers installation of Flatpak, Decky Loader.
• Session Switcher: Shortcuts to easily switch between desktop and game mode.

• Arch Linux (or an Arch-based distribution)
• SDDM display manager
• A compatible GPU (NVIDIA hardware may face issues)
• A gamepad for best UI experience
• KDE Plasma Desktop (Other desktops are also supported, but KDE Plasma is recommended for the best experience.)

Run this code in your terminal and follow the instructions:

curl -sSL https://raw.githubusercontent.com/unlbslk/arch-deckify/refs/heads/main/install.sh > deckify_install.sh && bash deckify_install.sh; rm -rf deckify_install.sh

And that’s all!

Please note that running this script may modify important system configurations, files, and settings. In some cases, it could lead to system instability, configuration loss, or make the system unbootable. Restoring the system to a working state may require advanced technical knowledge. Before executing directly, check the content of the script.

By using this script, you acknowledge that you are fully responsible for any issues that arise, including but not limited to data loss, system corruption, or any unforeseen consequences. It is highly recommended that you back up your important data and configurations before proceeding. Use this script at your own risk.

1.Prompts you to choose a default session for desktop mode.

2. Installs yay from AUR if neither yay/paru is not installed.

3. Enables the multilib repository, updates the system, and installs Steam if it’s not already installed.

4. Installs gamescope-session-steam-git from the AUR (includes gamescope and other dependencies).

5. Generates an sddm.conf file in /etc/ to enable autologin and session switching.

6. Adds a sudoers rule to allow session switching without a password.

7. Creates a steamos-session-select file, allowing switching back to desktop mode from within Steam.

8. Installs these packages: gamescope, mangohud(for FPS counter), wget, ntfs-3g(for NTFS drive support)

9. Adds a udev rule for backlight control, enabling brightness adjustment within Steam.

10. Creates desktop and application shortcuts for Gaming Mode and a GUI Helper, adds a system update script, and enables Bluetooth services.

The GUI Helper allows you to manually install additional tools like Decky Loader.

The steamos-session-select command allows you to switch between Gamescope (Gaming Mode) and your selected Wayland session. Example usage:

steamos-session-select gamescope  # Switch to Gaming Mode
steamos-session-select desktop     # Switch to Desktop (to your selected session)

You can also switch between Gaming Mode and Desktop Mode easily using the Steam interface or the desktop shortcut created during setup.

To change the session used when switching to Desktop Mode, run the following script:

curl -sSL https://raw.githubusercontent.com/unlbslk/arch-deckify/refs/heads/main/change_default_desktop.sh > deckify_change_default_desktop.sh && bash deckify_change_default_desktop.sh; rm -rf deckify_change_default_desktop.sh

You can update the system in Steam by adding the ~/arch-deckify/system_update.sh file to Steam as a non-Steam game while in desktop mode.

In order for the system update script to work, at least one of the supported terminals (konsole, gnome-terminal, kitty, alacritty) must be installed.

Unfortunately, system updates are not possible through Steam settings.

The Decky Loader is an unofficial community-driven tool that allows you to install and manage plugins for your Steam interface. While not essential for system functionality, it provides additional customization options for SteamOS. (https://decky.xyz/) Please note that it is not an official tool and may cause issues. Any potential risks or problems are the user’s responsibility.

To install Decky Loader:

curl -sSL https://raw.githubusercontent.com/unlbslk/arch-deckify/refs/heads/main/setup_deckyloader.sh > setup_deckyloader.sh && bash setup_deckyloader.sh; rm -rf setup_deckyloader.sh

To remove Decky Loader:

curl -sSL https://raw.githubusercontent.com/unlbslk/arch-deckify/refs/heads/main/remove_deckyloader.sh > remove_deckyloader.sh && bash remove_deckyloader.sh; rm -rf remove_deckyloader.sh

All logos, trademarks, and names related to Steam, SteamOS, Steam Deck, Valve, Deckify and other software such as Plasma and Arch are the property of their respective owners. These logos and names are used for reference and informational purposes only. This project is not affiliated with, endorsed, or sponsored by Valve, Steam, SteamOS, Steam Deck, Plasma, Arch Linux, Flatpak, Decky Loader, Deckify or any of their respective organizations. All rights reserved to the original trademark holders.