
Troubleshooting
The window doesn’t open on Windows
Section titled “The window doesn’t open on Windows”If WordCraft flashes in Task Manager and quits before its window appears, your graphics driver may be the cause. Start it with a different graphics system. In PowerShell, from the folder that contains wordcraft.exe:
$env:WGPU_BACKEND = "vulkan"& .\wordcraft.exeRemove-Item Env:WGPU_BACKEND # go back to the default for later launchesIf that doesn’t help, try "dx12" in place of "vulkan".
It quits with “Parent device is lost”
Section titled “It quits with “Parent device is lost””If WordCraft closes right after its window appears and the log says “Parent device is lost”, start it with WGPU_BACKEND set to "vulkan", as above. This avoids DirectX 12 altogether.
It’s slow on an older Windows PC
Section titled “It’s slow on an older Windows PC”On some older graphics chips, DirectX 12 only offers a software renderer that draws everything on the processor. WordCraft normally switches to OpenGL by itself. If it is still slow, look for lines starting with graphics: in the log to see which one it chose, and try setting WGPU_BACKEND to "gl" or "dx12", as above.
Text is blurry on Linux, or files can’t be dragged in
Section titled “Text is blurry on Linux, or files can’t be dragged in”On a Wayland desktop, WordCraft runs through XWayland by default, because that’s the only way dragging files into the window works. For sharper text with fractional scaling, switch to native Wayland: choose File › Options › Advanced › Linux display server › Wayland, then restart WordCraft. Dragging files into the window won’t work while it uses Wayland. Choose X11 (XWayland) or Automatic to switch back.
Read Aloud is silent on Linux
Section titled “Read Aloud is silent on Linux”Read Aloud uses a speech program installed on your system: espeak-ng, espeak or Speech Dispatcher. The .deb and .rpm packages install one for you. With the AppImage or the tarball, install it yourself:
sudo apt install espeak-ng # Debian, Ubuntusudo dnf install espeak-ng # Fedorasudo pacman -S espeak-ng # ArchThe Flatpak can’t speak yet.
A language shows “(no dictionary)”
Section titled “A language shows “(no dictionary)””The status bar shows the language of the text with (no dictionary) when WordCraft can’t check its spelling. Install its Language pack: see Languages and spelling.
A document doesn’t look as it does in another app
Section titled “A document doesn’t look as it does in another app”WordCraft is in alpha. Some layouts may break onto pages differently, and some chart types (stock, bubble, surface, pie of pie, 3-D) show a placeholder. Charts from Word are kept when you save, but stay read-only. If you need an exact copy, keep the original file. Please report the document if you can share it: real files are how we find these problems.
I can’t print, or my printer isn’t listed
Section titled “I can’t print, or my printer isn’t listed”- No printers found. Add the printer in your system settings, then press Refresh printers on File › Print. Meanwhile, Save these pages as PDF… gives you a file to print from any PDF viewer.
- Stuck on “Submitting print job…”. A sleeping or network printer can hold the job. Press Cancel printing, wake the printer and try again. If the job already reached your system’s print queue, cancel it there.
Known problems, not fixed yet:
- On Windows, the printer list can stay empty while a network printer is in power save (#5710).
- Some Windows network printers fail with “Failed to parse print capabilities” (#5413).
- On Windows, printing can fail with “No such interface supported (0x80040003)” (#5174).
- On macOS, manual two-sided printing doesn’t pause for you to flip the pages (#5769).
Open or Save does nothing on Linux
Section titled “Open or Save does nothing on Linux”WordCraft opens the system’s file dialog through xdg-desktop-portal. Install it with xdg-desktop-portal-gtk or xdg-desktop-portal-kde, then restart WordCraft.
If the dialog still doesn’t appear, choose File › Open › Browse in WordCraft…. It opens WordCraft’s own file browser, which doesn’t need the portal.
A document asks for fonts my computer doesn’t have
Section titled “A document asks for fonts my computer doesn’t have”The status bar shows 1 font not installed (or n fonts not installed) when a document uses fonts your computer lacks, such as Aptos. WordCraft draws that text in substitute fonts, so lines and pages can break in different places than in Word. Click the notice to see which fonts. Install them, then open the document again.
The window misbehaves on Linux
Section titled “The window misbehaves on Linux”File › Options › Advanced › Linux display server chooses the display server WordCraft uses. A change applies the next time WordCraft starts.
If text or the interface turns into noise on older Intel graphics, start WordCraft from a terminal with OpenGL instead of Vulkan:
WGPU_BACKEND=gl wordcraftThe window never appears, or WordCraft freezes on Windows
Section titled “The window never appears, or WordCraft freezes on Windows”Check the log for lines starting with graphics:, and try another graphics system as described in The window doesn’t open on Windows. If WordCraft closed while you had unsaved work, see Document recovery.
Known problems, not fixed yet
Section titled “Known problems, not fixed yet”- On Windows, WordCraft can freeze when you create or open a document (#5801).
- On Windows, WordCraft can close while you work in a second document, and the unsaved work isn’t recovered (#5809).
- On some Linux desktops the file dialog doesn’t open (#5699).
- File › Save As has no File name field on the page. Set the name in the dialog that Browse… opens (#5800).
- On Linux with Wayland, the window can’t be resized on some systems (#5886), and its size isn’t remembered (#5751).
WordCraft closed and I lost my work
Section titled “WordCraft closed and I lost my work”Open WordCraft again. If it kept a copy of your unsaved work, it shows it under File › Recover. See Document recovery.
Find the log
Section titled “Find the log”WordCraft writes a log you can attach to a bug report. It records parts of a document it couldn’t read, pictures or fonts it had to leave out of a PDF, and errors it recovered from. It never contains your document’s text.
| System | Log folder |
|---|---|
| Windows | %APPDATA%\WordCraft\logs\ |
| macOS | ~/Library/Application Support/WordCraft/logs/ |
| Linux | ~/.config/wordcraft/logs/ |
The current log is wordcraft.log. The log from the run before is wordcraft.1.log, so if WordCraft crashed, attach that one too.
The folder above logs is WordCraft’s settings folder.
Still stuck?
Section titled “Still stuck?”- Ask in the ArtCraft Discord.
- Report a bug on GitHub, with the log attached.