Troubleshooting and FAQ
On this page
- QuadPen does not start on Linux
- QuadPen does not start on Windows ("overflowed its stack")
- QuadPen closes without an error
- The file dialog does not open on Linux
- The turntable export produces no MP4
- A large reference is slow to orbit
- Retopology Lab puts faces inside my model, or leaves stray pieces
- Export or Bake says it needs a license
- Activation says the key is active on as many computers as it allows
- Floating license: "no seat" or "in use on another computer"
- The license key email did not arrive
- QuadPen asks about unsaved changes
- Some objects are missing from the export
- Which file formats are supported?
- A face looks dark or flipped after export
- A scene reports a load error
- Where are settings and recent files stored?
- How do I update QuadPen?
- Is there a macOS build?
- macOS says QuadPen can't be opened
QuadPen does not start on Linux#
QuadPen uses Vulkan on Linux. Install the Vulkan driver package for your distribution; on Debian, Ubuntu, and Fedora it is mesa-vulkan-drivers. On a headless machine or a very old GPU, install Mesa's lavapipe software rasterizer as a fallback. If you build from source, also install the windowing development headers listed in the project README. Without a working Vulkan driver, the viewport cannot initialize.
QuadPen does not start on Windows ("overflowed its stack")#
Some PCs, many MSI, ASUS and Dell models among them, come with Nahimic audio software. Its on-screen overlay (NahimicOSD.dll) loads itself into every program and can crash QuadPen while the window opens, with the message thread 'main' has overflowed its stack. When Nahimic is installed, QuadPen lets Windows load only Microsoft-signed and WHQL-certified DLLs, which keeps the overlay out; graphics drivers from Windows Update and the GPU makers' certified releases still load.
If the viewport does not start on such a PC with a beta graphics driver, set the environment variable QUADPEN_ALLOW_INJECTED_DLLS=1 to turn this off, and install a certified driver. You can also add quadpen.exe to Nahimic's own list of skipped programs, BlackApps.dat in C:\ProgramData\A-Volute\<version>\Modules\ScheduledModules\Configurator (needs administrator rights), then restart the Nahimic service.
QuadPen closes without an error#
If QuadPen crashes, it writes a crash log with the panic message and backtrace:
Windows:
%APPDATA%\QuadPen\quadpen-crash.logmacOS:
~/Library/Application Support/QuadPen/quadpen-crash.logLinux:
~/.config/QuadPen/quadpen-crash.log
If neither location is available, the log is written beside the executable. When the crash dialog appears, choose Yes to open a pre-filled email to hello@quadpen.com; attach the crash log to the message. Send the last section of the log with the file that caused the crash.
Low-poly import errors are shown as a red toast and in the status bar instead of closing the app.
On Windows QuadPen opens no console window. To read its log, start it from PowerShell or the Command Prompt: the log is printed there.
The file dialog does not open on Linux#
QuadPen uses the XDG Desktop Portal for native file dialogs. Install xdg-desktop-portal and the backend for your desktop, such as xdg-desktop-portal-gtk on GNOME/GTK or xdg-desktop-portal-kde on KDE. If no portal is available, install zenity as a fallback. Minimal window managers without either may not show a file dialog.
The turntable export produces no MP4#
MP4 output requires ffmpeg on the PATH. Install ffmpeg for your platform, confirm that the ffmpeg command runs in a terminal, then export the turntable again. QuadPen still writes the complete PNG sequence when ffmpeg is missing; only the MP4 is skipped. There is no built-in MP4 writer.
A large reference is slow to orbit#
Make sure View → Large-mesh display LOD is enabled, then lower Display triangles. The LOD affects display only; picking, snapping, and baking continue to use the full-resolution reference. If the reference is still too heavy, use Decimate in the HIGH POLY TOOLS section and click Use as high poly if you want to retopologize the lighter mesh.
Extremely large sculpts can still be slow with LOD on. Decimating the reference before retopology reduces the amount of geometry the viewport and tools must handle.
Retopology Lab puts faces inside my model, or leaves stray pieces#
The sculpt is probably made of pieces pushed into each other (a hand and its forearm, a head and its horns). The hidden parts inside are meshed too. Click Join in HIGH POLY TOOLS first: it makes one closed surface with nothing inside and saves it next to your sculpt as <name>_joined.obj. Click Use as high poly, then run Retopology Lab again.
Export or Bake says it needs a license#
The 15-day trial has ended. Open Help → License…, paste the key from your purchase email and click Activate, or click Buy QuadPen. Your scenes still open and save; only export, bake and turntable wait for the license.
Activation says the key is active on as many computers as it allows#
A Standalone license is active on 2 computers at a time. Deactivate it on a computer you no longer use (Help → License… → Deactivate on this computer there), then activate again. If that computer is gone, write to hello@quadpen.com.
Floating license: "no seat" or "in use on another computer"#
Every seat of the floating license is held by a running QuadPen on another computer. Close QuadPen there, or wait: QuadPen asks again every minute and takes the seat as soon as one is free. A QuadPen that crashed or lost the internet gives its seat up after 10 minutes. The message also appears while the license server cannot be reached; check the internet connection. Opening, editing and saving work meanwhile.
The license key email did not arrive#
The key is shown on the page you see right after paying; the email can take a few minutes. Look in the spam folder. If it is not there within an hour, write to hello@quadpen.com with the order number from Paddle's receipt.
QuadPen asks about unsaved changes#
The prompt appears when you open another scene, create a new scene, quit, or close the window while the retopology has unsaved changes. Choose Save scene first to save and continue, Discard changes to continue without saving, or Cancel to stay in the current scene.
Scene saves write to a temporary file, replace the scene, and keep one .bak backup. Wait for the save to finish before quitting.
Some objects are missing from the export#
Export includes the active retopology and every stored retopo object whose visibility checkbox is enabled. Hidden objects are skipped. Check the SCENE section, enable the missing objects, or click Show all. When objects are skipped, the export toast reports how many were hidden.
Which file formats are supported?#
Import supports OBJ, PLY (ASCII or binary little-endian), glTF, GLB, COLLADA (.dae), and FBX (ASCII or binary). Export supports OBJ, PLY, DAE, binary FBX, GLB, and glTF.
Format limits to keep in mind:
PLY export does not store UVs. Use OBJ, DAE, FBX, GLB, or glTF when UVs matter.
DAE and GLB/glTF export triangulate the mesh. OBJ, PLY, and FBX keep polygons.
FBX export is binary only.
Exports write geometry; formats that support UVs also write them. No shaded material definitions are written. Imported material groups are used for Groups color baking.
Native scenes use
.pen; legacy.qforgeand.qpenscenes still open.glTF export writes a
.gltffile plus a sidecar.binfile. Keep the two files together.
A face looks dark or flipped after export#
One or more faces are wound the other way round than their neighbours. Press Fix Normals in the EDIT section: it turns only those faces and says how many. QuadPen itself draws and picks such a face like the others.
A scene reports a load error#
QuadPen checks scene files for damage and truncation. A damaged or incomplete scene reports an error instead of loading partial geometry, and the message identifies the affected line where possible. Restore the .bak backup or an earlier copy, then reopen the scene. Scenes store reference mesh paths rather than embedding the references, so the reference files must still be available at those paths.
Where are settings and recent files stored?#
On Windows, settings live in %APPDATA%\QuadPen\quadpen_layout.ini; the recent-files list is quadpen_recent.txt in the same folder. On macOS, the folder is ~/Library/Application Support/QuadPen/; on Linux, ~/.config/QuadPen/. Portable installs use a local quadpen_layout.ini when one is present in the working directory.
How do I update QuadPen?#
QuadPen checks for a new version when it starts and shows a bar when one is out; Help → Check for Updates… checks at any time. Download opens the download page: download the new version and replace the old program (unzip over it on Windows; on a Mac, drag the new QuadPen onto Applications and choose Replace). Settings, layout and recent files are kept, because they live in the settings folder, not next to the program.
Is there a macOS build?#
Yes. One download runs natively on Apple silicon and Intel Macs with macOS 11 Big Sur or later. It uses Metal for the 3D view.
macOS says QuadPen can't be opened#
If macOS says it cannot check QuadPen for malicious software, or that Apple could not verify it, open it once like this:
macOS 15 Sequoia and later: try to open QuadPen, close the message, then open System Settings → Privacy & Security, scroll down and click Open Anyway next to QuadPen. Confirm with your password.
macOS 11 to 14: Control-click QuadPen in Applications, choose Open, then Open again.
You only need to do this once.