Armorsmith & WINE


Armorsmith can be very useful when it comes to scaling, but like pepakura, it's only available for Windows, and not everyone uses Windows.

But you can just use WINE to run it, right? Well, yesn't. It works, but it's a bit more complicated than pepakura.

So first, what do you need to get armorsmith up and running on a non-Windows system?
  • Armorsmith (kinda obvious)
  • WINE (everything above 5.0 should work, I haven't tried anything below.)
  • Windows (unfortunately you do need Windows, but it should only be necessary once) Not needed anymore!
  • (lutris. This isn't a requirement, but it can help organize things a bit better)
So, assuming you've bought armorsmith, the first step is to install it. The installer will try to install DirectX 9, but you can just cancel that, as the installation will fail anyways, and this way, you won't accidentally install the bing bar. You will need to do this both on Windows and whatever system you actually want to use (Ubuntu in my case, but it should be the same on pretty much any linux distro, and not much different for mac). You'll need it on windows first though, as our other install won't be very useful before that.
Installing on Windows first is not needed anymore, activation now works on wine too.

Once Armorsmith is installed on Windows (a VM is probably enough, but I just used my native Windows installation), log in with your email and serial number. After that, you can close Armorsmith again and shut Windows down, it's not needed anymore.

The next step is the actual install on WINE. I had more issues with regular system WINE, so I use lutris to manage the WINE prefix and launch Armorsmith, but regular system wine should work too. Since there need to be some specific settings in the prefix for Armorsmith to work though, I recommend at least using a separate WINE prefix. (If you're wondering what this prefix is, the FAQ describes it a bit more. You can kinda think of it as a Windows installation, but it's not one).
Using DXVK to translate the DirectX calls to Vulkan isn't required, but I'd recommend it (lutris has it enabled by default).
For versions after, both DXVK and D3D Extras are required. See this post for more information.
You can install Armorsmith right after you created the prefix or do it later, it doesn't really matter. It won't fully work until everything is set up though. So next are some important settings.
The most important setting though is the Windows version. Open winecfg (using winetricks, just running winecfg in the terminal or opening it using whatever prefix organizer you use) and set the Windows version to Windows 7. With Windows 10 selected, I had issues with file choosers not responding to any input.

After this is done, navigate to the Documents folder on your Windows installation, and copy the "Armorsmith Designer" folder to your documents folder in the WINE prefix (<prefix>/drive_c/users/<username>/Documents, the exact path may vary).
Once you have copied that folder, you can run Armorsmith on WINE (or install it, if you haven't before. The exact order doesn't really matter.)
You can skip this step if you're able to activate Armorsmith on WINE.

You might get some rendering glitches in the viewport from time to time, but apart from that, it should be fully usable now. I haven't tested every feature though.
Last edited:


DMO and Armory Assistant
Division Staff
Community Staff
Member DIN
I'm not running linux right now, but this is awesome. Commenting for thread updates :)


Commanding Officer
Community Staff
Division Staff
I'm with Schankerz and now I'm starting to wonder if the Canadians don't have a drinking problem. hahaha

In all seriousness though - do we need to have this in a pinned Armorsmith post? Maybe with other Armorsmith tips and tricks? RandomRanger - thoughts?


Well-Known Member
Member DIN
This SHOULD also work for anyone running an Intel-based Mac (not verified) if they don't want to use something like Parallels or Boot Camp. Not entirely sure about it working for those with Apple Silicon/M1 chips, but Parallels should work for them now.


The one issue with macs might be that apple removed 32bit support in High Sierra (I think, I don't use MacOS), but apparently codeweavers have at least somewhat worked around that, and since Armorsmith is 64bit, it might not have any 32bit dependencies. M1 should probably also work with Rosetta or qemu-user as well.


If you're using Armorsmith on linux, don't install the new update for now.
It immediately crashes upon starting, likely due to things missing in DXVK and WineD3D.

The last version of Armorsmith that I know works so far is

With vulkan renderers (both DXVK and WineD3D), there's the message
00b8:fixme:vulkan:X11DRV_vkCreateWin32SurfaceKHR Application requires child window rendering, which is not implemented yet!
which may or may not be an issue, OpenGL based WineD3D does not directly complain about anything, but Armorsmith still fails creating a texture.
With all rendering options, there is an unhandled page fault in some texture related code.


I got it to work again.

Settings (I did this with lutris, but you can also set it up manually):
  • DXVK enabled
  • D3D Extras enabled (without this is crashes)
  • wine 7.2 (I didn't try too many versions, older versions probably work fine too)
  • Windows version: Windows 7
Setting the windows version to windows 10 leads to the UI becoming unresponsive for multiple seconds every time you select something in the viewport, and I haven't found any upsides to doing so.

Also, activation now works fine, so there's no need anymore to do it on windows and copy over any files. I don't know if that directly has something to do with the update or just with some other things that I've changed, but it works.

Your message may be considered spam for the following reasons: