Affinity Wine DocumentationAffinity Wine Documentation
Guide
Contributing
  • To-Do
  • License
  • Analytics
Source
Guide
Contributing
  • To-Do
  • License
  • Analytics
Source
  • Guide
    • Introduction
    • Compiling Wine
    • Wineprefix Setup
    • See also
  • Q&A
  • Troubleshooting

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:

rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineboot --shutdown

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

Kill the Wineserver and Its Child Applications:

rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineserver --kill

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

Fixing Flickering and Other Visual Glitches

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

rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity winetricks renderer=gl
rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity winetricks renderer=vulkan

Shell aliases

If you've followed the guide, you can add the following aliases to your shell config to quickly launch the apps. Edit it according to your setup.

# Launch wineAffinity with rum
alias affinity-designer='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"'
alias affinity-photo='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"'
alias affinity-publisher='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"'
# Launch wineAffinity with rum
alias affinity-designer='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"'
alias affinity-photo='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"'
alias affinity-publisher='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"'
# Choose alias or abbr according to your taste

# abbr
# Launch wineAffinity with rum
abbr --add affinity-designer 'rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"'
abbr --add affinity-photo 'rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"'
abbr --add affinity-publisher 'rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"'

# alias
# Launch wineAffinity with rum
alias affinity-designer='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"'
alias affinity-photo='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"'
alias affinity-publisher='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wine "$HOME/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"'
# Choose alias or subfunctions according to your taste

# alias
# Launch wineAffinity with rum
alias affinity-designer = rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"
alias affinity-photo = rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"
alias affinity-publisher = rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"

# function & subfunctions
# Launch wineAffinity with rum
def affinity [] { help affinity }
def 'affinity designer' [] { # Launch designer with rum in ~/.wineAffinity
    rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Designer 2/Designer.exe"
}
def 'affinity photo' [] { # Launch photo with rum in ~/.wineAffinity
    rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Photo 2/Photo.exe"
}
def 'affinity publisher' [] { # Launch publisher with rum in ~/.wineAffinity
    rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wine $"($env.HOME)/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe"
}

You can also add the following to kill the Wineserver as mentioned in the "Kill or Shutdown Wine / Affinity" section.

# Kill wineAffinity
alias affinity-kill='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineserver --kill'
# Kill wineAffinity
alias affinity-kill='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineserver --kill'
# Choose alias or abbr according to your taste

# abbr
# Kill wineAffinity
abbr --add affinity-kill 'rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineserver --kill'

# alias
# Kill wineAffinity alias
alias affinity-kill='rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity wineserver --kill'
# Choose alias or subfunctions according to your taste

# Kill wineAffinity
alias affinity-kill = rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wineserver --kill

# function & subfunctions, add it to the rest
def 'affinity kill' [] { # Kill wineserver with rum in ~/.wineAffinity
    rum affinity-photo3-wine9.13-part3 $"($env.HOME)/.wineAffinity" wineserver --kill
}

Desktop Shortcuts with rum

NEEDS TO BE MOVED TO OWN TIPS PAGE

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

[Desktop Entry]
Name=Publisher 2
GenericName=Publisher on Wine
Comment=
Exec=rum ElementalWarrior-[ver] /home/[USER]/.wineAffinity wine '/home/[USER]/.wineAffinity/drive_c/Program Files/Affinity/Publisher 2/Publisher.exe'
# Change the rum [version] and the [USER] paths to the right directory

Icon=/home/[USER]/.wineAffinity/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-publisher-2'

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=publisher.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

This example uses Publisher 2; edit it according to the Affinity software you installed.

Installer Not Displaying

If the installer does not display, some users on the Affinity Forum resolved this by displaying Wine windows in a Virtual Desktop. You can enable Wine's Virtual Desktop with winecfg, a GUI to configure settings for your Wine prefix.

  1. Start winecfg through rum in the desired prefix:

    rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity winecfg
  2. Go to the "Graphics" tab and enable "Emulate a virtual desktop." Feel free to change the "Desktop size," but it's not mandatory for the installation process.

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 through rum in the desired prefix:

    rum affinity-photo3-wine9.13-part3 $HOME/.wineAffinity 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.


For more bug reports and fixes, visit the original forum topic and the Codeberg Issues.

Edit this page on Codeberg
Last Updated:
Contributors: wanesty, Garteal