⚠️ IMPORTANT: Before Opening Issues

DO NOT open GitHub issues until you have:

• Read this README completely
• Read all documentation pages (Installation Guide, Known Issues, System Requirements, etc.)
• Searched existing issues for similar problems
• Checked the Known Issues page

Issues opened without reading the documentation will be closed immediately.

Please take the time to read through all the documentation - it contains answers to most common questions and problems.

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:

1. Download the AppImage from GitHub Releases
2. Make it executable: chmod +x Affinity-3-x86_64.AppImage
3. Run it: ./Affinity-3-x86_64.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 | python3

sudo pacman -S python-pyqt6

sudo dnf install python3-pyqt6

sudo zypper install python313-PyQt6

sudo apt install python3-pyqt6.qtsvg

• Installation Guide - Complete installation instructions for all methods
• System Requirements - Supported distributions and dependencies
• GUI Installer Guide - Step-by-step GUI installer instructions

• Wine Versions - Available Wine versions and recommendations
• Hardware Acceleration - GPU acceleration options (vkd3d-proton, DXVK, OpenCL)
• OpenCL Guide - Detailed OpenCL configuration
• Legacy Scripts - Command-line installation scripts

• Known Issues - Common problems and solutions
• Settings Guide - Configuration options

• 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

• 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 (see Hardware Acceleration).
• Unsupported Distributions: No support provided for Bazzite, Linux Mint, Zorin OS, Manjaro, Ubuntu, or Pop!_OS. Use AppImage at your own risk (see System Requirements).
• PikaOS: GUI installer does not work. Use AppImage instead.

Wine 10.17 has major bugs and issues. This installer does not use it.

Contributions are welcome! See docs/CONTRIBUTING.md for guidelines.

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.