Related Projects AffinityPluginLoader WineFix

AffinityPluginLoader & WineFix

AffinityPluginLoader (APL) is a plugin loader for Affinity by Canva (v3), written and maintained by noahc3. It is not part of this project. This page explains what it does and gives credit to its author.

Full upstream documentation lives at apl.ncuroe.dev.

What APL Does

APL loads custom code into Affinity at startup and lets that code patch Affinity's own methods while it runs, using the Harmony library. This means bug fixes and feature patches can ship as small plugin files, instead of editing Affinity's own program files on disk.

APL works on both Windows and Linux (through Wine). It does not support macOS.

Install APL

1. Download affinitypluginloader-vX.X.X-amd64.zip from the latest APL release.
2. Extract the zip into your Affinity install directory (the folder that contains Affinity.exe).
3. Launch AffinityHook.exe instead of Affinity.exe from now on.

See the APL installation guide for full detail, and the Affinity by Canva install guide on this wiki for where this step fits in a full Linux setup.

WineFix

WineFix is an APL plugin, also by noahc3, that fixes several Wine-specific Affinity bugs. Install APL first, then add WineFix the same way. Extract its release zip into the Affinity install directory.

WineFix currently patches:

• Preferences failing to save on application exit
• Vector path preview lines drawing incorrectly (a patched d2d1.dll)
• The colour picker's zoom preview showing a black image on Wayland
• An intermittent startup crash caused by parallel font enumeration
• The Canva sign-in dialog (patched out as a temporary measure, pending a real protocol-handler fix; see Related-Projects-LoginFix for a different community plugin that fixes sign-in directly instead)

WineFix is configurable from Affinity's own preferences dialog, or through TOML files and environment variables. See the WineFix configuration reference for details.

Known open WineFix bugs, per its own documentation: accepting crash reporting can cause a permanent crash until preferences are cleared, and the embedded SVG document editor can crash after being open for a while.

Building on APL

LoginFix, a separate community plugin covered elsewhere on this wiki, is built as its own APL plugin and needs APL installed first as a prerequisite. It fixes the Canva sign-in crash directly, rather than disabling sign-in the way WineFix currently does.

Licensing and Credits

APL itself (AffinityHook, AffinityBootstrap, AffinityPluginLoader) is licensed under the MIT License.

WineFix is licensed under GPLv2, except for its bundled d2d1.dll source, which is licensed under LGPLv2.1 per upstream Wine licensing (it applies a cubic bezier subdivision algorithm and makes d2d1.dll buildable standalone).

Canva and its subsidiaries are separately exempt from both the MIT and GPLv2 terms above, and may license APL/WineFix code under the Zero-Clause BSD license instead (this exemption does not cover the d2d1.dll source).

Full credit to noahc3 for building and maintaining both APL and WineFix. APL's own credits also thank this project (AffinityOnLinux), Harmony, ElementalWarrior Wine, upstream Wine, and Affinity by Canva.