LeShade - A Reshade Manager

This project started as a university project, and I already mentioned that in the old readme file. The project grew and became a passion project, and now I think it's good to have a new readme file.

LeShade is a reshade manager for linux. Think of a mod manager, but specifically for reshade. It includes features like:

• Common APIs support (DX9, DX10, DX11, DX12, OpenGL, Vulkan)
• Direct3D 8.x support
• ReShade with addon and non-addon versions
• ReShade with release versions support
• Uninstalling ReShade per game basis from previous installations
• Many shaders repositories
• RenoDX support (snapshot releases)

Dependencies

The project depends on wine so it can install and remove registry keys on your game prefix. Please install it.

• Arch: sudo pacman -S wine winetricks
• Fedora: sudo dnf install wine winetricks
• Debian/Ubuntu: sudo apt install wine

Usage

The program itself is very intuitive, so if you already used a mod manager or even the ReShade installer "à la" wizard you will likely not have any problems. Even though I have made a video guide. You can download the AppImage or Flatpak version on the release page.

AppImage Instructions:

1. Select LeShade-x86_64.AppImage that you have downloaded
2. Right click > Properties > Permissions > Check: Allow executing file as program (or likely)
3. Done!

Flatpak Instructions:

1. Open the terminal
2. Go to the folder that you have downloaded LeShade in (default: cd ~/Downloads)
3. Execute in the terminal: flatpak install ./LeShade-x86_64.flatpak
4. Done!

Arch Linux instructions:

You have some options on AUR, the leshade-git package that always gets the latest commit and the leshade-bin (thanks to @italoghost) that gets the latest release (not commit).

Leshade-bin:

1. Open the terminal
2. paru -S leshade-bin or yay -S leshade-bin
3. Done!

Leshade-git:

1. Open the terminal
2. paru -S leshade-git or yay -S leshade-git
3. Done!

Gentoo Linux instructions:

Available in GURU.

games-util/leshade:

1. Open the terminal
2. Add the GURU repository as described in Project:GURU/Information for End Users
3. emerge --ask games-util/leshade
4. Done!

Fedora instructions:

I've managed to create a build to Fedora copr with the latest release of LeShade.

Leshade:

1. Open the terminal
2. sudo dnf copr enable ishidaw/leshade
3. sudo dnf install leshade
4. Done!

Direct3D 8.0 instructions: If you are installing ReShade on a game that uses Direct3D 8.0, you must add the environment variables on your game launcher (Steam, Heroic Games Launcher, Lutris, Faugus Launcher). Here are two examples of how you can set those on Steam and Heroic.

Steam launch options

Heroic launch options

Vulkan instructions: If you are installing ReShade on a game that uses Vulkan, you must add the environment variables on your game launcher (Steam, Heroic Games Launcher, Lutris, Faugus Launcher). Here are two examples of how you can set those on Steam and Heroic.

Steam launch options

Heroic launch options

Compatibility

I've made a wiki page and a COMPATIBILITY.md that includes tested games by users, so you can check if your game is there. Also you can contribute to it, just access and read it.

Development

LeShade is built with PySide6 with default Qt widgets, so you can expect a seamless theme integration with your system. Qt was my choice to build the GUI because I've seen other awesome applications that use it and I really like: PCSX2, Duckstation and ShadPS4. Also, LeShade was developed exclusively by human hands, without any sort of AI bullshit. I have tested each build (AppImage and Flatpak) on Oracle Virtual with those 3 distros: Ubuntu 25.10, Ubuntu 24.04.3, Linux Mint 22.2. Also, have tested on CachyOS non-vm. You can take a look into this pull request. The logo was made by me on Inkscape.

Files

LeShade creates a folder on the config with a json file called manager.json. It stores the path and the name of the game so it can be used to show the game name on the uninstall list as well as to uninstall the game properly by using the path stored inside the file.

There is a key difference between where the leshade/manager.json will be on your computer depending on the version that you're using.

For the AppImage version, as it uses system dependencies, you will find the file at: ~/.config/leshade/manager.json.

For the Flatpak version, due to the sandbox system that the package uses, you can find the file at: ~/.var/app/io.github.ishidawg.LeShade/config/leshade/manager.json.

Contributing

If you want to contribute to LeShade, feel free to clone the repository, make the changes you want to make, and create pull requests. Every kind of contribution is very welcome!

Opening issues when you encounter an... well - issue, is a really great contribution as well.

How to contribute:

1. Fork the repository
2. Make your changes
3. Commit them: git add . && git commit -m "My changes" && git push origin main
4. Create a pull request following this pattern below

## Contribution title

**Have you used AI to vibe code?**
Response.
**Have you used AI as a research source?**
Response.
**Have you tested locally?**
Response.

### Fixes:
Description of what you have fixed.

Sources:

• d3dcompiler_47.dll 64bit and 32bit from WindowsSDK 10.0.26100.0
• d3d8to9.dll from crosire.
• icu files (executables and dlls) from icu
• AppImage Tool to build my one of my packages.