Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
14 changes: 12 additions & 2 deletions Guides/Bottles/Guide.md
Original file line number Diff line number Diff line change
Expand Up @@ -48,11 +48,21 @@ This is also known as your Wine runner.
- [ElementalWarrior](/Guides/Bottles/InstallScripts/Affinity-ew.yaml)
- [Wine-tkg-affinity](/Guides/Bottles/InstallScripts/Affinity-tkg.yaml)
7. In Bottles, import the install script file for your Wine fork. `Import Configuration -> Affinity-ew.yaml`
8. Click **Create**.
8. Click **Create**. If Wine asks to install Mono, click **No** or **Cancel**.

<img height="350" alt="image" src="https://github.com/user-attachments/assets/f17de84b-859a-49a2-8d01-09da643a2fbf" />

## 5. Extract WinMetadata
## 5. Remove Wine Mono and install .NET Framework

Bottles pre-installs **Wine Mono Windows Support**, which conflicts with .NET Framework 4.8 and can cause CLR crashes (for example `Unhandled exception: 0xe0434352`) when running the Affinity installer. [Wine Mono must be removed before installing .NET Framework 4.8](https://github.com/wine-mono/wine-mono#composition).

1. Open your bottle → **Tools** → **Legacy Wine Tools** → **Control Panel** → **Add/Remove Programs**.
2. If **Wine Mono Windows Support** is listed, select it and click **Remove**.
3. Open **Dependencies** and install **dotnet48**. The install should take several minutes; if it finishes very quickly, Wine Mono may still be present—repeat steps 1–2 and reinstall **dotnet48**.

This workaround is [documented in Bottles issue #2887](https://github.com/bottlesdevs/Bottles/issues/2887#issuecomment-2646118028).

## 6. Extract WinMetadata

1. Download the [`WinMetadata.zip` archive file](https://archive.org/download/win-metadata/WinMetadata.zip).
2. Extract the `WinMetadata` folder from the archive into `drive_c/windows/system32`.
Expand Down
11 changes: 10 additions & 1 deletion Guides/Bottles/GuideV2.md
Original file line number Diff line number Diff line change
Expand Up @@ -34,10 +34,19 @@ Alternately, you may want to install Bottles using the [unofficial AppImage](htt
5. Set the runner to **kron4ek-wine-<version>-amd64**
6. Download the [install script file](https://github.com/DaRandomCube/AffinityOnLinux/blob/main/Guides/Bottles/InstallScripts/affinity-nu.yaml)
7. In Bottles, import the install script file for your Wine fork. `Import Configuration -> Affinity-nu.yaml`
8. Click **Create**.
8. Click **Create**. If Wine asks to install Mono, click **No** or **Cancel**.

<img width="1108" height="884" alt="bottle_creation_window" src="https://github.com/user-attachments/assets/ffd4641b-66a9-4bc7-8718-ef64b937e0fc" />

## 4. Remove Wine Mono and install .NET Framework

Bottles pre-installs **Wine Mono Windows Support**, which conflicts with .NET Framework 4.8 and can cause CLR crashes (for example `Unhandled exception: 0xe0434352`) when running the Affinity installer. [Wine Mono must be removed before installing .NET Framework 4.8](https://github.com/wine-mono/wine-mono#composition).

1. Open your bottle → **Tools** → **Legacy Wine Tools** → **Control Panel** → **Add/Remove Programs**.
2. If **Wine Mono Windows Support** is listed, select it and click **Remove**.
3. Open **Dependencies** and install **dotnet48**. The install should take several minutes; if it finishes very quickly, Wine Mono may still be present—repeat steps 1–2 and reinstall **dotnet48**.

This workaround is [documented in Bottles issue #2887](https://github.com/bottlesdevs/Bottles/issues/2887#issuecomment-2646118028).

## 5. Add Windows.winmd

Expand Down
5 changes: 2 additions & 3 deletions Guides/Bottles/InstallScripts/Affinity-ew.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@ Arch: win64
CompatData: ''
Creation_Date: '2024-10-18 16:42:58.782336'
Custom_Path: false
DLL_Overrides: {}
DLL_Overrides:
mscoree: n,b
DXVK: dxvk-2.4.1
Environment: Custom
Environment_Variables: {}
Expand All @@ -21,8 +22,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
- dotnet40
- dotnet48
- vcredist2022
#Install vcredist2015 if the program crashes on you while saving.
Language: sys
Expand Down
5 changes: 2 additions & 3 deletions Guides/Bottles/InstallScripts/Affinity-tkg.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,8 @@ Arch: win64
CompatData: ''
Creation_Date: '2024-10-18 16:42:58.782336'
Custom_Path: false
DLL_Overrides: {}
DLL_Overrides:
mscoree: n,b
DXVK: dxvk-2.4.1
Environment: Custom
Environment_Variables: {}
Expand All @@ -21,8 +22,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
- dotnet40
- dotnet48
- vcredist2022
#Install vcredist2015 if the program crashes on you while saving.
Language: sys
Expand Down
3 changes: 1 addition & 2 deletions Guides/Bottles/InstallScripts/affinity-nu.yaml
Original file line number Diff line number Diff line change
Expand Up @@ -3,6 +3,7 @@ CompatData: ''
Creation_Date: '2025-11-20 14:10:50.517344'
Custom_Path: false
DLL_Overrides:
mscoree: n,b
wintypes: n
DXVK: dxvk-2.6.1
Environment: Custom
Expand All @@ -22,8 +23,6 @@ Installed_Dependencies:
- verdan32
- webdin32
- allfonts
- dotnet40
- dotnet48
Language: sys
LatencyFleX: latencyflex-v0.1.1
NVAPI: dxvk-nvapi-v0.9.0
Expand Down