AffinityOnLinux

Hi @ryzendew if you see this -- I made this before reading your Contributions guidelines!
I'll follow the guidelines later when I have time.

ℹ️ NOTE from forker @fazzaan
All credit goes to the original creator, @ryzendew. [original repo]

This is a fork simply to add Garuda Linux support to the Linux python installation script, because the original script wouldn't let me install it on Garuda.

• Link to github file: AffinityScripts/AffinityLinuxInstaller.py
• Link to raw python3 file: https://raw.githubusercontent.com/fazzaan/Linux-Affinity-Installer/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py

I have not done anything except add "garuda" to the various statements that check which OS you are using. All such statements are set to copy the Arch-based distros.

Everything else in this repo, including this ReadMe page, is identical to ryzendew's repo.

Note that the original in-repo URLs link to the files in my fork. This is normal behaviour and they will be updated when I sync my fork with the original repo.

Any of my edits shall be marked clearly.

NOTE THAT YOU USE THIS AT YOUR OWN RISK AND NEITHER @RYZENDEW NOR I CAN SUPPORT YOU.

I simply created this as a hack for myself, and figured it might be useful for others.

I can try to add or tweak other things in the script if you submit an issue.

Original ReadMe from dev @ryzendew

⚠️ 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 ((links to @ryzendew's repo))

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.

What is This?

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.

Quick Start

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:

Edit from me @fazzaan

This is the updated script with support added for Garuda Linux.
I'm not a developer but I have run this on my own Garuda Linux system with success, and Affinity is running now.
Check my edits here: AffinityScripts/AffinityLinuxInstaller.py

curl -sSL https://raw.githubusercontent.com/fazzaan/Linux-Affinity-Installer/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py | python3

Original from @ryzendew

curl -sSL https://raw.githubusercontent.com/ryzendew/AffinityOnLinux/refs/heads/main/AffinityScripts/AffinityLinuxInstaller.py | python3

Python GUI Dependencies

The installer will attempt to install PyQt6 automatically if missing. If automatic installation fails, install it manually:

Arch/CachyOS/EndeavourOS/XeroLinux:

sudo pacman -S python-pyqt6

Fedora/Nobara:

sudo dnf install python3-pyqt6 python3-pyqt6-svg

openSUSE (Tumbleweed/Leap):

sudo zypper install python313-PyQt6

PikaOS: Does not work with GUI installer. Use AppImage instead.

Ubuntu 25.10: If you encounter GUI issues, also install:

sudo apt install python3-pyqt6.qtsvg

Documentation

Getting Started

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

Technical Details

• 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

Additional Resources

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

Getting Help

• 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

Important Notes

Support Limitations

• 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 Warning

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

Contributing

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

License

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.