Skip to content
Craft Wiki

Troubleshooting

If CADCraft flashes in Task Manager and quits before its window appears, your graphics driver may be the cause. CADCraft uses DirectX 12 on Windows. Start it with Vulkan instead. In PowerShell, from the folder that contains cadcraft.exe:

Terminal window
$env:WGPU_BACKEND = "vulkan"
& .\cadcraft.exe
Remove-Item Env:WGPU_BACKEND # go back to the default for later launches

Avoid setting it to "gl" for this problem: on some AMD drivers that brings the crash back.

The drawing is blank, objects are invisible or the window is black

Section titled “The drawing is blank, objects are invisible or the window is black”

These graphics problems have been reported:

  • The window is black, with no tools (#2490).
  • The window is transparent and glitchy on CachyOS (#2448).
  • Objects disappear as soon as you draw them, in Windows inside a VMware virtual machine (#2622).

You can choose the graphics backend with the WGPU_BACKEND variable: dx12, vulkan or gl. In the VMware case, gl fixed it and vulkan didn’t start at all. See the first entry on this page for how to set it in PowerShell. Try the backends one at a time. If none of them helps, report it with your log attached.

A Windows installer message that says “This app is already installed for everyone”, or winget upgrade failing with error 0x8a150049 (MSI error 1603), means the installed copy and the update are for different people. Update with the same choice as the copy you have:

  • If you installed it for everyone, run the new installer and choose Everyone on this computer, or run msiexec /i <file>.msi ALLUSERS=1 from an elevated terminal.
  • If you installed it for your account only, choose Only for me.

To change who it’s installed for, uninstall first. See Windows.

This is a known problem when you update with winget (#2847).

If the graphics driver resets or stops responding, CADCraft shows a Graphics error notice and autosaves every drawing with unsaved changes. Save your work if you can, then restart CADCraft. Any autosaved drawings are offered when it starts again.

CADCraft autosaves drawings with unsaved changes every 10 minutes. If it closes unexpectedly, open it again: a Drawing Recovery list shows the drawings it saved. Choose Open to get one back, then save it under a name of your choice. Discard deletes the copy, and Later keeps it and asks again next time.

To autosave more or less often, change Automatic save every in Tools › Options › Open and Save. 0 minutes turns autosave off. The web version doesn’t autosave.

A drawing won’t open, or opens with errors

Section titled “A drawing won’t open, or opens with errors”

Choose File › Drawing Utilities › Recover… and pick the file. CADCraft tries to repair it as it opens it. File › Drawing Utilities › Audit checks the open drawing for errors.

Very large DWG files can take a while to open, because CADCraft converts them first.

CADCraft reads SHX fonts only when their .shx files are in the drawing’s folder or in a folder named by CADCRAFT_SHXPATH, so text in an SHX style whose font it can’t find is drawn with CADCraft’s own drafting font. If text in Chinese, Japanese, Korean or Arabic doesn’t show properly, install a font that has those characters, such as Noto Sans CJK or Noto Sans Arabic, and restart CADCraft. See Fonts.

CADCraft can’t yet save everything that other CAD programs put in a drawing. See DWG and DXF files. If you still have the original file, open that one. If you saved over it, the previous version may still be next to it as a backup: drawing.bak for drawing.dwg, or drawing.dxf.bak for drawing.dxf. Copy it and rename it back to .dwg or .dxf to open it.

On a Wayland desktop, CADCraft runs through XWayland by default, because that’s the only way dragging files into the window works. If you started it with CADCRAFT_WAYLAND=1 for native Wayland, dragging files in won’t work: start it without that variable.

I can’t see the cursor with a screen magnifier

Section titled “I can’t see the cursor with a screen magnifier”

Over the drawing, CADCraft hides the system cursor and draws its own crosshair, so magnifiers and screen recorders can lose track of it. Choose View › Accessibility › Show System Cursor to keep a small system cursor visible in the middle of the crosshair.

CADCraft can only plot to files for now: PDF, PNG or SVG (#670). Plot to a PDF, then print the PDF from any PDF viewer. See Print.

Export to PDF doesn’t ask for a paper size

Section titled “Export to PDF doesn’t ask for a paper size”

File › Export to PDF… uses the current page setup. To choose the paper, scale or plot style, use File › Print… instead, or set them for a layout in File › Page Setup Manager….

I can’t use my AutoCAD plot styles (.ctb)

Section titled “I can’t use my AutoCAD plot styles (.ctb)”

CADCraft can’t read AutoCAD’s .ctb, .stb or .pc3 files yet (#2752). Use a built-in table such as monochrome.ctb, or make your own in File › Plot Styles…. See Plot styles.

In File › Print…, turn off Fit to paper, then type the Scale you want, such as 1:50. If a layout from another CAD program ignores its page setup, that’s a known problem (#2493).

CADCraft draws in 2D only for now. Most tools on the Modeling tab of Tool Sets, and the 3D views and orbit, are not available yet.

CADCraft writes a log you can attach to a bug report.

System Log folder
Windows %APPDATA%\CADCraft\logs\
macOS ~/Library/Application Support/CADCraft/logs/
Linux ~/.config/cadcraft/logs/

The current log is cadcraft.log. The log from the run before is cadcraft.1.log, so if CADCraft crashed, attach that one too.

The folder above logs is CADCraft’s settings folder.

These are open. We’ll update this list when they’re fixed.

  • You can’t bring back the menu bar after you hide it (#2272). The right-hand panel can’t be closed on its own (#2274), and the Reference Manager can’t be closed once it’s open (#2273).
  • The Flatpak can’t use a 3D mouse, because its sandbox has no access to the device (#2713).
  • On macOS, double-clicking a DWG file doesn’t open it (#2892). Open it with File › Open… in CADCraft.
  • On KDE Plasma, the Open file dialog can appear behind the CADCraft window, so CADCraft looks frozen (#2642). Switch to the dialog from the taskbar.
  • On Linux, interface text can slowly turn into garbled symbols until you restart (#2777).
  • On Windows, updating from the launcher or the .msi can stop with “This installation package could not be opened” (#2754).