Home

Awesome

gshade_installer

This is a CLI GShade installer for Linux. It both downloads and updates GShade and can be used to install / update your GShade installs for individual games that will be run through WINE.

Please note that as of 06-21-22, this installer no longer interacts with WINE directly, as it seems to no longer be necessary.

Getting Started

Once you've got the script and it's executable, you can simply run it. There is a basic menu.

If you would prefer to run the commands directly, the help menu should give you the basics (./gshade_installer.sh --help):

Syntax options:
                                ./gshade_installer.sh                                           -- Guided tutorial
                                ./gshade_installer.sh update [force|presets]                    -- Install / Update to latest GShade.  Optionally force the full update or just presets.
                                ./gshade_installer.sh list                                      -- List games, numbers provided are for use with remove / delete options.
                                ./gshade_installer.sh lang <en|ja|ko|de|fr|it> [default|#]      -- Change the language of GShade's interface.  Defaults to the master copy if unspecified.
                                ./gshade_installer.sh remove <#>                                -- Remove <#> from database, leave GShade in whatever shape it's currently in.
                                ./gshade_installer.sh delete <#>                                -- Delete GShade from <#> and remove from database.
<WINEPREFIX=/path/to/prefix>    ./gshade_installer.sh ffxiv                                     -- Install to FFXIV in provided Wine Prefix or autodetect if no Wine Prefix
 WINEPREFIX=/path/to/prefix     ./gshade_installer.sh [dx(?)|opengl] /path/to/game.exe          -- Install to custom location with designated graphical API version. 'dxgi' is valid here if needed.

                                                                        Note: game.exe should be the GAME'S .exe file, NOT the game's launcher, if it has one!

You can clone the repo and run the script from within it. Instructions to do so are below the prerequisites.

Prerequisites

Universally required:

Additional requirements for Linux:

Additional requirements for Mac:

<sup>1</sup> As of 02-23-21, 7z (generally provided by the p7zip package in most distros, p7zip-full on Ubuntu) is also required. If you have a reliable source of the required 32-bit d3dcompiler that doesn't need it, I'm open to removing the requirement, but right now we're using the winetricks method.

Installation

There's multiple ways to run the installer, this is just one method.

  1. Clone the repo: git clone https://github.com/Mortalitas/GShade-Bash-Installer.git
  2. Change directory into it: cd gshade_installer
  3. Run the script: ./gshade_installer.sh

We install to the $XDG_DATA_HOME/GShade/ directory, which defaults to $HOME/.local/share/GShade/.

Updating

When updating GShade through the script (./gshade_installer.sh update or through the guided menu's 1 option), all existing installs are updated if an update is found.

If any of the following seems complicated -- just run ./gshade_installer.sh and follow the guided prompts.

If you're installing GShade for use with FFXIV, you can try the auto-installer by running ./gshade_installer.sh ffxiv, which will search for a default-location Steam install (the default WINE prefix in Steam is $HOME/.steam/steam/steamapps/compatdata/39210/pfx, and the game itself is in $HOME/.steam/steam/steamapps/common/FINAL FANTASY XIV Online/game/), a Lutris install (by looking for a configuration file), the default XLCore location, or by checking a provided WINEPREFIX.

If you wanted to install GShade to a Steam install of FFXIV manually, you would use the following command:

WINEPREFIX="$HOME/.steam/steam/steamapps/compatdata/39210/pfx" ./gshade_installer.sh dx11 "$HOME/.steam/steam/steamapps/common/FINAL FANTASY XIV Online/game/ffxiv_dx11.exe"

If you're having any problems, you can check ./gshade_installer.sh debug, which will print something similar to this: Debug example Green is good. Red indicates an error with that component. Yellow is informational, such as a 'hard install' without symlinks. Neither good nor bad -- just something to be aware of when troubleshooting.

You can get just the games.db list by requesting it with ./gshade_installer.sh list. You can remove an item from the list with ./gshade_installer.sh remove <#>, or delete the GShade installation from the game with ./gshade_installer.sh delete <#>.

If you're having trouble and asking a friend for help, you can use ./gshade_installer.sh debug upload and give your friend the URL. They can use the URL with curl <URL> to see the exact output you would see if you ran the debug yourself.

Troubleshooting

If you need assistance, please check the GShade Discord for the #troubleshooting channel.

Contributors

If you are a code contributor, please feel free to add yourself to the list during your commit! My memory is roughly sieve-shaped!