A comprehensive solution for running Affinity software on GNU/Linux systems using Wine with hardware acceleration support.
AffinityOnLinux provides an easy way to install and run Affinity Photo, Designer, Publisher, and the unified Affinity v3 application on Linux. The installer automatically sets up Wine (a compatibility layer for running Windows applications) with all necessary configurations, dependencies, and optimizations.
New to Linux or want the easiest option? Use the AppImage:
- Download the AppImage from GitHub Releases
- Make it executable:
chmod +x AffinityLinuxInstaller-*.AppImage - Run it:
./AffinityLinuxInstaller-*.AppImage
Want full features and latest updates? Use the Python GUI Installer:
curl -sSL https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py | python3The AppImage is a portable, self-contained installer that works on most Linux distributions without requiring system-wide dependencies.
Best for:
- Users on unsupported distributions (Linux Mint, Zorin OS, Manjaro, Ubuntu, Pop!_OS)
- Users who prefer not to install Python/PyQt6 system-wide
- Quick testing or portable installations
- Older CPUs (use AppImage v2 for best compatibility)
Features:
- ✅ No installation required - just download and run
- ✅ Self-contained - includes all dependencies
- ✅ DXVK support for excellent graphics performance
- ✅ Full GUI installer functionality
Limitations:
- Does not include OpenCL/vkd3d support (use Python GUI installer for this)
- Uses DXVK by default (which is recommended for most users)
CPU Compatibility: AppImage v2 works on any CPU. Other versions may have issues on older CPUs.
A modern graphical installer with comprehensive features and automatic dependency management.
Best for:
- Users on supported distributions
- Users who need OpenCL/vkd3d support
- Permanent installations
- Users who want the latest features
Features:
- One-click full setup with automatic dependency installation
- Multiple Wine versions to choose from
- Wine version switching without reinstalling applications
- Automatic WebView2 Runtime installation for Affinity v3
- DPI scaling configuration
- Comprehensive troubleshooting tools
- Real-time status monitoring
Installation:
# Run directly from GitHub (recommended)
curl -sSL https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py | python3
# Or download and run locally
curl -sSL https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py -o install.py && python3 install.pyDependencies: The installer will attempt to install PyQt6 automatically if missing. For manual installation, see the Python GUI Dependencies section below.
Usage:
- Run the installer
- Click "One-Click Full Setup" for automatic configuration
- Choose your Wine version (10.4 recommended for most systems)
- Use "Update Affinity Applications" to install or update Affinity apps
- Check the status log to see what's installed
📖 Detailed Guide: See the GUI Installer Guide for step-by-step instructions.
Command-line installers for users who prefer terminal-based installation.
Available Scripts:
- All-in-One Installer - Install any Affinity application
- Individual Installers - Affinity Photo, Designer, Publisher, or v3 (Unified)
- Affinity Updater - Update existing installations
See the Legacy Scripts section below for details.
Officially Supported:
- Arch Linux
- CachyOS
- EndeavourOS
- Fedora
- Nobara
- openSUSE (Tumbleweed/Leap)
- PikaOS 4
⚠️ Note: Python GUI installer does not work. Use AppImage instead. - XeroLinux
Unsupported Distributions (No Support Provided):
The following distributions are not officially supported and no support will be provided for issues:
- Linux Mint - Outdated dependencies. Use AppImage instead.
- Zorin OS - Outdated dependencies. Use AppImage instead.
- Manjaro - Known stability issues. Use AppImage instead.
- Ubuntu - Outdated package management. Use AppImage instead.
- Pop!_OS - Outdated package management. Use AppImage instead.
Important: While the installer may function on unsupported distributions if dependencies are manually installed, we cannot provide support. The AppImage is strongly recommended for these distributions.
These are automatically installed by the GUI installer. For legacy scripts, install manually:
- Wine (provided automatically by installer)
- winetricks
- wget, curl
- p7zip or 7z
- tar, jq
- xz (optional)
The installer supports multiple Wine versions, all patched for Affinity compatibility:
| Version | Best For | Description |
|---|---|---|
| 10.4 (Recommended) | Most users | Latest version with best compatibility and performance |
| 10.4 v2 | Older CPUs | Optimized for CPUs from 2014-2020 (V1-V3 generations) |
| 10.10 | Testing | Alternative version for compatibility testing |
| 10.11 | Testing | Alternative version for compatibility testing |
| 9.14 (Legacy) | Fallback | Legacy version if newer versions have issues |
All versions include:
- OpenCL support patches
- AMD GPU compatibility fixes
- Affinity-specific optimizations
The installer automatically detects your CPU and recommends the best version. You can switch between versions anytime using the GUI installer.
vkd3d-proton and DXVK are modern alternatives to OpenCL that provide excellent hardware acceleration:
- vkd3d-proton: Direct3D 12 support (automatically configured)
- DXVK: Direct3D 11 support with excellent performance
- More reliable than OpenCL on many systems
- Recommended for better compatibility, especially on AMD and Intel GPUs
These are automatically configured by the installer and are the recommended method for hardware acceleration.
OpenCL support is available with all Wine versions but may have compatibility issues depending on your GPU.
GPU Compatibility:
- NVIDIA GPUs: ✅ OpenCL works well. No known issues. Wine GPU bugs can typically be addressed.
- AMD GPUs:
⚠️ OpenCL may have issues. Important: I cannot fix AMD OpenCL issues or Wine GPU bugs as I do not have access to an AMD GPU for testing. Use vkd3d-proton or DXVK instead (recommended). - Intel GPUs:
⚠️ OpenCL may have issues. Important: I cannot fix Intel GPU OpenCL issues or Wine GPU bugs as I do not have access to an Intel GPU for testing. Use vkd3d-proton or DXVK instead (recommended).
Recommendation: For AMD and Intel GPUs, use vkd3d-proton or DXVK instead of OpenCL for better reliability and performance.
The installer supports all Affinity applications:
- Affinity Photo - Professional photo editing
- Affinity Designer - Vector graphic design
- Affinity Publisher - Desktop publishing
- Affinity v3 (Unified) - All-in-one application combining Photo, Designer, and Publisher
If the installer cannot automatically install PyQt6, install it manually:
Arch/CachyOS/EndeavourOS/XeroLinux:
sudo pacman -S python-pyqt6Fedora/Nobara:
sudo dnf install python3-pyqt6openSUSE (Tumbleweed/Leap):
sudo zypper install python313-PyQt6PikaOS: Does not work with GUI installer. Use AppImage instead.
Ubuntu 25.10: If you encounter GUI issues, also install:
sudo apt install python3-pyqt6.qtsvgClick to expand legacy script options
Install any Affinity application with automatic dependency management:
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.sh)"Affinity Photo:
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityPhoto.sh)"Affinity Designer:
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityDesigner.sh)"Affinity Publisher:
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityPublisher.sh)"Affinity v3 (Unified):
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/Affinityv3.sh)"Update existing installations without full reinstallation:
bash -c "$(curl -s https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityUpdater.sh)"- GUI Installer Guide - Complete step-by-step guide with troubleshooting
- Known Issues - Common problems and solutions
- OpenCL Guide - Detailed OpenCL configuration
- Other Software on Linux - Additional compatibility information
- Discord Community: Join our Discord server for support and discussions
- GitHub Issues: Report bugs and request features on GitHub
- Documentation: Check the guides and documentation linked above
Wine 10.17 has major bugs and issues. This installer does not use it.
- AMD/Intel GPU Issues: I cannot fix OpenCL or Wine GPU bugs for AMD/Intel GPUs as I do not have access to these GPUs for testing. Use vkd3d-proton or DXVK instead.
- Unsupported Distributions: No support provided for Linux Mint, Zorin OS, Manjaro, Ubuntu, or Pop!_OS. Use AppImage at your own risk.
- PikaOS: GUI installer does not work. Use AppImage instead.
Contributions are welcome! Pull requests help improve the project for everyone. Please ensure your changes are tested and documented.
This project provides installation scripts and configurations for running Affinity software on Linux. Affinity software is a commercial product by Serif (Europe) Ltd. Please ensure you have a valid license before installing.
Disclaimer: This project is not affiliated with, endorsed by, or associated with Serif (Europe) Ltd. All trademarks and registered trademarks are the property of their respective owners.