AffinityOnLinux
⚠️ IMPORTANT: Before Opening IssuesDO 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.
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:
- Download the AppImage from GitHub Releases
- Make it executable:
chmod +x Affinity-3-x86_64.AppImage - 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 | python3Python 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.