Install Guide ScriptInstaller

Install Affinity Using the AffinityOnLinux Script Installer

This guide sets up Affinity using the AffinityOnLinux script installer, an automated tool that installs Wine dependencies and Affinity for you, instead of running each command by hand.

The installer is two files working together:

• AoL_ScriptInstaller-GameDirection.sh: a bash launcher that detects your distro, installs Python 3 and its dependencies if missing, then starts the main installer.
• affinity_installer_unified.py: a PyQt6 GUI installer with its Wine/Affinity setup logic embedded as a bash backend in the same file.

Step-by-Step Installation Guide

Step 1: Download Affinity

Download Affinity.msix or Affinity.exe from the Affinity download page.

• From the "Download for Windows" drop-down menu, select "Windows (Intel/AMD)" to download Affinity.msix.
• Select "Enterprise (Intel/AMD)" to download Affinity.exe.

Step 2: Download the Installer Scripts

Download both files from this repository's script installer directory:

• AoL_ScriptInstaller-GameDirection.sh
• affinity_installer_unified.py

Keep both files in the same directory. The shell script launches the Python installer from alongside itself. It will not work if you separate the files.

Step 3: Grant Executable Permissions

In the directory containing both files, run:

chmod +x ./*.sh

This makes AoL_ScriptInstaller-GameDirection.sh executable.

Step 4: Run the Installer Script

Run AoL_ScriptInstaller-GameDirection.sh and follow its prompts.

Note

The dotnet48 installation step can take a while and may appear to hang. This is expected. Wait for it to finish.

What the Installer Does

AoL_ScriptInstaller-GameDirection.sh detects your Linux distribution (Ubuntu/Debian, Fedora, or Arch family), installs Python 3 and its pip/venv dependencies if they are missing, then hands off to affinity_installer_unified.py.

affinity_installer_unified.py is a self-contained PyQt6 GUI: it auto-installs PyQt6 if missing, then runs an embedded bash backend that sets up the Wine prefix, installs dependencies through winetricks, runs the Affinity installer, and creates .desktop shortcuts.

Post-Installation

After installation completes, the installer creates a .desktop file in the same directory. Use it to launch Affinity from your desktop environment or file manager.

Credits

This installer script and its unified Python installer are maintained as part of this repository. See Credits for the project's contributor list.

Troubleshooting

• dotnet48 installation seems stuck. Check on it periodically. It can take a long time to complete. This is expected.
• The installer fails or behaves unexpectedly. Check the AffinityOnLinux Discord for help, and share your install log so the community can identify the failure point.
• The community asks for your system information while troubleshooting. Run neofetch or fastfetch and share the output. These are the tools the community uses to help diagnose issues.

Known Issues

Some users hit a GLIBC version mismatch with this script installer on older distributions. See General-Known-Issues for the symptom and workaround.