Skip to content

Instantly share code, notes, and snippets.

@micahlt
Created April 18, 2026 09:30
Show Gist options
  • Select an option

  • Save micahlt/3c97f834adaf688fe18344c0f546466c to your computer and use it in GitHub Desktop.

Select an option

Save micahlt/3c97f834adaf688fe18344c0f546466c to your computer and use it in GitHub Desktop.

CavalryOnLinux

A guide to running the Cavalry motion graphics software on Linux using Wine.

This guide has been tested exclusively on Wine 11.

Initial setup

Set up a new prefix

Create a new Wine prefix by creating a folder somewhere on your computer, preferably ~/.cavalry. Within that folder, run WINE_PREFIX=~/.cavalry winetricks which should initialize the prefix.

Install fonts and graphics improvements

In Winetricks, select "Install a Windows DLL or component", then check dxvk and click okay. After it is installed, click "Install a font" and check the corefonts option. Go through all of the font installs. Once they are complete, click "Change settings" and select the fontsmooth=rgb option. These improvements make Cavalry run much smoother.

Override DLLs

Open winecfg with WINEPREFIX=~/.cavalry winecfg

Go to the Libraries tab.

Under "New override for library," type icuuc and click Add. Do the same for icuin. Ensure they are both set to (Native, Builtin).

Install Cavalry

Run the Cavalry installer .msi file through Winetricks or through the command line.

Fix Canva sign-in

Create a new .desktop file to define the Cavalry URI protocol. With the text editor of your choice, create a new file at ~/.local/share/applications/cavalry-handler.desktop. The contents should look like the following:

[Desktop Entry]
Name=Cavalry Protocol Handler
Exec=env WINEPREFIX="/home/micahlt/.cavalry" wine "/home/micahlt/.cavalry/drive_c/Program Files/Cavalry/Cavalry.exe" "%u"
Type=Application
Terminal=false
NoDisplay=true
MimeType=x-scheme-handler/cavalry;

Then run:

update-desktop-database ~/.local/share/applications
xdg-settings set default-url-scheme-handler cavalry ~/.local/share/applications/cavalry-handler.desktop

Run the app

You should be good to run Cavalry, which you should be able to find from your system menu. Canva sign-in should work properly, and you should have GPU acceleration.

@micahlt
Copy link
Copy Markdown
Author

micahlt commented Apr 26, 2026

Very likely this will be an issue for someone with actual knowledge of Cavalry's architecture to build a patch or find a workaround for it. Possible a decompilation would help? Definitely depends on what technologies Cavalry is made with.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment