Troubleshooting

Kill or Shutdown Wine / Affinity

If the software freezes or continues running in the background, use the following commands to shut it down or kill the processes.

Shutdown the Wine Environment:

WINEPREFIX="$HOME/.wineAffinity3 wineboot --shutdown

Tip: --shutdown can be abbreviated to -s.

Kill the Wineserver and Its Child Applications:

WINEPREFIX="$HOME/.wineAffinity3 wineserver --kill

Tip: --kill can be abbreviated to -k.

Flickering and Other Visual Glitches

Try the following commands to resolve visual issues, and choose the one that runs most smoothly on your machine:

WINEPREFIX="$HOME/.wineAffinity3 winetricks renderer=gl

WINEPREFIX="$HOME/.wineAffinity3 winetricks renderer=vulkan

Pixelated UI font

The UI font is likely to be pixelated, it's not an antialiasing issue, it's simply a missing font, you can install it with winetricks:

WINEPREFIX="$HOME/.wineAffinity3 winetricks tahoma

Rearranging Panels

Due to Xwayland and Wine's handling of child windows, you may encounter issues with panels not stacking or saving their positions when closing Affinity. A workaround to create a comfortable user interface is to use Wine's Virtual Desktop.

1. Start winecfg in the desired prefix:

   WINEPREFIX="$HOME/.wineAffinity3 winecfg
   

2. Go to the "Graphics" tab and enable "Emulate a virtual desktop." In this case, you'll likely want to change the "Desktop size" to match your desktop resolution, possibly subtracting the thickness of your taskbar/status bar if you have one.

3. Save your configurations and open Affinity.

4. Arrange the desired panels where you want them and save the layout in Affinity using Window > Studio > Add Preset before closing it cleanly.

5. The Virtual Desktop may not work well with floating panels, so you might want to open winecfg again to disable it after setting up your panels.

Desktop Shortcuts

To create a desktop shortcut for Affinity, your .desktop file should be located at $HOME/.local/share/applications/Affinity.desktop and look similar to this:

[Desktop Entry]
Name=Affinity
GenericName=Affinity on Wine
Comment=
Exec=env WINEPREFIX="/home/[USER]/.wineAffinity3 wine "/home/[USER]/.wineAffinity3/drive_c/Program Files/Affinity/Affinity/Affinity.exe"
# Change the [USER] paths to the right directory

Icon=/home/[USER]/.wineAffinity3/drive_c/Program Files/Affinity/AppLogo.targetsize-256.png
# Get any png or svg of the logo to add it here; To use your current icon-pack simply use the icon's name without the file extension, eg. 'affinity-3'

Categories=Graphics
# To be sorted with other Graphics software in your "start" menu

Keywords=Graphics;2DGraphics;RasterGraphics;VectorGraphics;image;editor;vector;drawing;
# Alternative keywords for app search

MimeType=application/x-affinity
# File type association

NoDisplay=false
StartupNotify=true
Terminal=false
Type=Application
StartupWMClass=affinity.exe
# Change this to 'photo.exe' or 'designer.exe'; Makes sure the open application gets shown under the shortcut instead of creating a new dock-entry; To get an application's WMClass type 'xprop WM_CLASS' into your terminal and click on the window whose class you want to know

Edit it with the correct paths.

---

For more bug reports and fixes, you can visit the AffinityOnLinux discord server and this project's Codeberg Issues.