Skip to content

GleammerRay/WineSteam

Repository files navigation

Wine Steam

Install Wine Steam on Linux without pain and hassle.
Now works on Steam Deck!

Works great with NEOTOKYO.
  - Dalem_master

Contents

  1. Features
  2. Prerequisites
  3. Installation
  4. Usage
  5. Updating
  6. Uninstalling
  7. Tools
  8. Install Location
  9. Known issues

Features

  • Easy installation ⚡ - Wine GE and DXVK are automatically installed.
  • No interference 🕴️ - WineSteam can run alongside native Steam without making it go offline.
  • Steam Deck support 🎮 - Flatpak installation mode allows WineSteam to be installed on Steam Deck.
  • Isolation 📦 - Harmful programs can't touch your files from within WineSteam (if installed using flatpak installation mode).

Prerequisites

  • git - required for installing and updating WineSteam. 🔃
  • util-linux - used to avoid network interference with the native Steam client. 🌐
  • flatpak - recommended to make installation easier. 📦 (otherwise see https://github.com/lutris/docs/blob/master/WineDependencies.md)
  • winetricks (optional for flatpak installation) - needed to create and set up the Steam wineprefix. 🪄
  • (optional) zenity or kdialog - GUI frontends. ✨

Installation

  1. Execute the line below to get the required dependenicies on Ubuntu or another Debian-based distribution:
sudo apt install git util-linux flatpak
  1. Either manually clone the repository or use an all-in-one installer by running the following:
bash <(curl -L https://github.com/GleammerRay/WineSteam/blob/main/winesteam_curl_installer.sh?raw=true)

Usage

Simply run bash winesteam.sh!

The utility starts Steam if the installation is complete or runs the setup if otherwise.

You will be asked a few questions at the start of the setup via your terminal or via GUI if you have zenity or kdialog installed.

During setup a Wine configuration menu may appear. It is recommended that you enable Graphics -> Emulate a virtual desktop for better image quality in games and to always have an equivalent of windowed fullscreen mode regardless of game settings (recommended setting for NEOTOKYO°). If you're unsure of what to change, just click OK.

If you're unable to log into Steam via QR code, try restarting and using manual log in instead. Sometimes it may take several tries to log in.

It is recommended to use View -> Small Mode in Steam to minimize crashes and bugs.

Read Adding as an App for adding Wine Steam to your applications launcher.

Updating

To update WineSteam, just run bash update.sh. This will pull the latest commit and download runtime packages.

Uninstalling

To uninstall WineSteam, run bash uninstall.sh and enter "y" to confirm.
You will be able to install it again by running bash winesteam.sh.

Tools

Adding as an App

If you wish to install Wine Steam into your app launcher, run bash install_desktop.sh. This will add the Wine Steam desktop launcher into your applications menu. You might need to restart your computer for the Wine Steam icon to cache.

Winetricks

To get access to the various winetricks tools and utilities for your Wine Steam prefix, run bash winetricks.sh and choose Select the default wineprefix.

Prefix Configuration

Run bash winesteamcfg.sh to access the Wine configuration menu for your Wine Steam prefix.

4GB Patcher

WineSteam is now using WINE_LARGE_ADDRESS_AWARE=1 with Wine GE, so the 4GB Patcher is no longer required. It is kept here for archiving purposes.

32bit games and software often require more memory for better performance, but are limited to 2GB of RAM by default. To aid that, run bash 4gbpatch.sh <executable path> (without angle brackets) to patch the program.

The script is using the patch from https://ntcore.com/?page_id=371.

DXVK Patch

Direct3D is part of directx APIs that allows 3d graphics on windows, this patch applies transition layer from Direct3D to Vulkan.

Some people don't need this patch, if your games work without it, DON'T APPLY IT.

It is strongly recommended that, if you need DXVK for some games, you try using Proton in native Steam for these games first.

To apply the DXVK patch, run bash dxvkpatch.sh.

Visual C++ Runtimes Installer

Visual C++ runtimes are no longer installed by default as they tend to break Wine Steam installations. If you have tried using Wine Steam before this notice appeared and it did not work, do try again.

Only run bash vcruntimes.sh if your desired game doesn't work. This may fix or create bugs and crashes in your Wine Steam games and applications.

Install Location

After the setup, the prefix is located at .winesteam/prefix in your home directory.

Known issues

  • Steam client is laggy.
    • Use Steam small mode (click on View -> Small Mode in the Steam client for a more basic, yet more stable UI).
  • Log in using QR code is buggy and doesn't always work.
    • Using manual sign in often works better.
  • Game graphics are slow, buggy and look weird

NEOTOKYO° issues

  • Wine program error The program hl2.exe has encuntered a serious problem and needs to close.
    • Fixed by using the 4GB Patcher or lowering texture quality.
  • While sending client info, Microsoft Visual C++ Runtime error appears.
  • Broken font.
    • Are you sure you didn't skip font installation by accident?
  • While running command !motd on BonAHNSa server, game crashes with C++ runtime error.
    • Fixed by running the Visual C++ Runtimes Installer. This installer is known to break NEOTOKYO° online games entirely on some systems, make sure to back up your prefix before using it.

Made with 💜 by Gleammer.