Skip to content

Add experimental Lutris and Bottles support, release 2.9.0-4 #28

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Arkazzae merged 1 commit into from
Oct 23, 2026
Merged

Add experimental Lutris and Bottles support, release 2.9.0-4 #28

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 5 additions & 1 deletion .SRCINFO
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
pkgbase = vortex-linux
pkgdesc = Community build of Vortex with generic Linux compatibility patches
pkgver = 2.9.0
pkgrel = 3
pkgrel = 4
url = https://github.com/Arkazzae/VortexLinux
install = vortex.install
arch = x86_64
Expand Down Expand Up @@ -95,6 +95,8 @@ pkgbase = vortex-linux
source = 0036-linux-appimage-nxm-links.patch
source = 0037-linux-case-consistent-folders.patch
source = 0038-linux-default-wine-prefix.patch
source = 0039-linux-lutris-store.patch
source = 0040-linux-bottles-store.patch
source = vortex.sh
source = vortex.desktop
source = README.md
Expand Down Expand Up @@ -148,6 +150,8 @@ pkgbase = vortex-linux
sha512sums = SKIP
sha512sums = SKIP
sha512sums = SKIP
sha512sums = SKIP
sha512sums = SKIP
sha512sums = 935db5c6cee19f2c016e67168bfae7b491044735de76c673abb3b125dd325fd5e779d7efe12ba80178d46689ae70a25e558a3fa846417d44c5f4ca256e7f4bf2
sha512sums = e3f31d298a2b674b54c7fc89fb3f06d9645fc5879a54f2ebf2ea20e9ee7ae55f1bfe3284c1f90a591d6be2d6bcd251790ddc27771d65303e7a6a56d331df4632
sha512sums = 2161dfa1cf027cdc074de7195b5f206b17ebd829ae415b9e7c9ee5f06d3952b6583030022dbe0d6e9221b5c577c411d7cd5322241f6d2299d9c886641215699b
Expand Down
9 changes: 9 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,6 +10,15 @@ publishes a new Vortex version, taking any pending notes with it.

## Unreleased

- Experimental: games installed through Lutris' Wine runner are recognised.
Point Vortex at the game folder and it deploys into the game's Lutris prefix,
starts the game through Lutris and runs modding tools with the game's Wine
build. GOG and Epic games from Lutris' services are also found when a game
extension looks them up by store ID.
- Experimental: games installed in a Bottles bottle are recognised the same
way. A game folder inside a bottle, or one holding a program added to a
bottle, uses that bottle as its prefix, starts through `bottles-cli` and runs
tools with the bottle's runner.
- The 2.6.2 recipe carries the Linux fixes from 2.8.2-3 through 2.9.0-3:
extension config paths, deployment preflight and target logging, extensions
behind a symlinked home, differently cased game paths, backslash archive
Expand Down
6 changes: 5 additions & 1 deletion PKGBUILD
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@

pkgname=vortex-linux
pkgver=2.9.0
pkgrel=3
pkgrel=4
pkgdesc="Community build of Vortex with generic Linux compatibility patches"
arch=('x86_64')
url="https://github.com/Arkazzae/VortexLinux"
Expand Down Expand Up @@ -139,6 +139,8 @@ _patches=(
'0036-linux-appimage-nxm-links.patch'
'0037-linux-case-consistent-folders.patch'
'0038-linux-default-wine-prefix.patch'
'0039-linux-lutris-store.patch'
'0040-linux-bottles-store.patch'
)

source=(
Expand Down Expand Up @@ -213,6 +215,8 @@ sha512sums=(
'SKIP'
'SKIP'
'SKIP'
'SKIP'
'SKIP'
# Keep integrity checks for binaries downloaded outside this repository.
'935db5c6cee19f2c016e67168bfae7b491044735de76c673abb3b125dd325fd5e779d7efe12ba80178d46689ae70a25e558a3fa846417d44c5f4ca256e7f4bf2'
'e3f31d298a2b674b54c7fc89fb3f06d9645fc5879a54f2ebf2ea20e9ee7ae55f1bfe3284c1f90a591d6be2d6bcd251790ddc27771d65303e7a6a56d331df4632'
Expand Down
29 changes: 29 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -14,6 +14,7 @@ This repo does the other thing: it patches Vortex to actually understand Linux,
- Maps `Documents` / `AppData` into the right prefix, so mods and saves land where the game actually looks
- Discovers Epic, GOG and Amazon games in native and Flatpak Heroic installations
- Launches games through Steam or Heroic
- Experimental: recognises Windows games installed through Lutris or Bottles, deploys into their prefix and launches them through the launcher
- Runs Windows modding tools in the game’s Wine/Proton prefix, including calls made by extensions
- Reads and writes Windows INI files while preserving encoding, comments and hardlinks
- Builds Bethesda plugin management with native Linux LOOT
Expand All @@ -22,6 +23,17 @@ This repo does the other thing: it patches Vortex to actually understand Linux,

These are general Linux fixes, not per-game hacks. Game-specific Vortex extensions can still carry their own Windows-only assumptions, so some games may still need fixes.

### What runs where

| Part | Runs as |
|---|---|
| Vortex itself: UI, downloads, installers, deployment | native Linux process |
| Game discovery and launch through Steam, Heroic, Lutris, Bottles | native, through each launcher |
| Mod deployment, INI edits, LOOT sorting, FOMOD installers | native |
| Windows-only modding tools such as xEdit or BodySlide | the game's own Wine or Proton prefix |
| Windows .NET runtimes those tools need | bundled, loaded through Wine |
| Vortex's few Windows-only helpers, and tools run with no game selected | a separate Wine prefix under `~/.local/share/vortex-linux` |

## Upstream is catching up 🎉

Vortex itself is slowly becoming more Linux-friendly. Since 2.7.1, the extension API's `util.epicGamesLauncher` is a shim over `GameStoreHelper` instead of `undefined` everywhere except Windows, so our Epic API fallback patch is gone 🎊.
Expand Down Expand Up @@ -93,6 +105,23 @@ If Heroic is an AppImage outside `PATH`, set `HEROIC_BINARY` to its executable.
Launch it once before scanning for games. Linux-native Heroic games keep their
native configuration paths.

**Lutris and Bottles (experimental).** Games that use Lutris' Wine runner work
too. If Vortex doesn't find the game by itself, set its folder manually, as it
appears inside the Lutris prefix (also when that folder is a symlink to another
disk). Vortex recognises that it belongs to Lutris, uses the game's Lutris
prefix, starts it through Lutris and runs tools with the Wine version selected
for it in Lutris. Tools need a Wine build for now; games set to Proton in Lutris
can be deployed to and launched, but not run tools. Set `LUTRIS_BINARY` if
`lutris` isn't on `PATH`.

Bottles works the same way: set the game folder inside the bottle, or the folder
of a program you added to a bottle. Vortex uses the bottle as the prefix, starts
a program added in Bottles through `bottles-cli`, and runs tools with the
bottle's runner. Bottles keeps bottles by name, so rename bottles that share a
name. Flatpak Bottles only sees folders its sandbox allows. Set
`BOTTLES_CLI_BINARY` if `bottles-cli` isn't on `PATH`. Both are new and lightly
tested; please report what breaks.

The separate prefix for Vortex’s own helper processes still defaults to
`${XDG_DATA_HOME:-$HOME/.local/share}/vortex-linux/wineprefix`.

Expand Down
Loading
Loading