Getting started
On this page
QuadPen 0.14.0 is available for Windows x64 (from the Microsoft Store) and Linux x64 (from quadpen.com). The Mac version (one download for Apple silicon and Intel Macs) comes on 1 January 2027.
Requirements#
A 64-bit Windows 10/11 or Linux system (x64), or macOS 11 Big Sur or later on an Apple silicon or Intel Mac.
A GPU and driver that work with the native 3D viewport. On Linux, QuadPen uses Vulkan, so install the Vulkan driver package for your distribution.
On Linux, glibc 2.35 or newer: for example Ubuntu 22.04, Linux Mint 21, Pop!_OS 22.04, Debian 12, Fedora 36 or newer, openSUSE Tumbleweed, Arch Linux and Manjaro.
On Linux, native file dialogs use
xdg-desktop-portalwith the desktop's portal backend. Most desktops install this automatically; minimal window managers may needxdg-desktop-portal-gtkorzenity.
The Windows build is self-contained and does not require a separate Visual C++ Redistributable installation.
Install on Windows#
On quadpen.com, click Get it from Microsoft Store, or search for QuadPen in the Microsoft Store app.
Click Get (or Install). The Store installs QuadPen and keeps it up to date.
Start QuadPen from the Start menu.
The Store download is the free trial. Your license is bought on quadpen.com and entered in Help → License…; the Store takes no part in it.
To remove QuadPen, open Settings → Apps → Installed apps, find QuadPen and choose Uninstall. Your settings, the trial and your license stay, so a later install picks them up again.
Install on macOS#
The Mac version comes on 1 January 2027. Then:
Download
quadpen-0.14.0-macos-universal.dmgfrom quadpen.com.Open the disk image and drag QuadPen onto the Applications folder.
Start QuadPen from Applications or Launchpad.
On a Mac, use Cmd where this manual says Ctrl, and Option where it says Alt.
Install on Linux#
Download
quadpen-0.14.0-linux-x64.tar.gzfrom quadpen.com.Extract it and go into the folder:
tar -xzf quadpen-0.14.0-linux-x64.tar.gzInstall it for your user account:
./install.shQuadPen appears in your applications menu, and
.penscene files open in it. Everything goes into your home folder (~/.local); no administrator rights are needed. To run it without installing, start./quadpenin the folder instead.
To remove it, run ./install.sh --uninstall from the same folder. Your settings, the trial and your license stay in ~/.config/QuadPen.
If the application cannot initialize the viewport, install the Vulkan drivers for your distribution. On Debian, Ubuntu, and Fedora the package is mesa-vulkan-drivers. For a headless machine or a very old GPU, install Mesa's lavapipe software rasterizer as a fallback.
First launch#
QuadPen opens with an empty scene. The default theme is Dark Gray, and the default navigation preset is Maya with inverted mouse zoom. The tool dock is on the left, the inspector is on the right, and the statistics overlay and view cube are visible in the viewport. Strip is selected as the starting tool.
You can work in the viewport immediately after loading a reference:
File → Load High Poly… (Ctrl+H) replaces the active reference.
File → Load Low Poly… imports an existing retopology mesh with its UVs from OBJ, FBX, glTF or GLB. Quads stay quads. FBX keeps the polygons as authored and applies the model transforms and units. glTF only stores triangles and splits vertices at UV seams, so QuadPen welds those vertices and joins each triangle pair that forms a flat, convex quad with matching UVs back into one quad (on the test models 99.8–100% of quads come back; dented quads stay as two triangles).
Drag and drop an
.obj,.ply,.gltf,.glb,.dae, or.fbxfile onto the viewport.
The first loaded mesh becomes the active reference. Scenes can contain additional references; they appear in the SCENE section of the inspector, where you can show or hide them and choose Use to make one active. For OBJ references, UVs are retained for texture display and transfer, and OBJ or PLY vertex colors are displayed.
Trial and license#
QuadPen starts with a 15-day trial with every feature. After 15 days, export, subdivided export, bake and turntable need a license; opening, editing and saving scenes keep working, so nothing you made is ever locked away.
Help → License… shows how many trial days are left. To activate a license you bought:
Copy the license key (
QP-XXXXX-XXXXX-XXXXX-XXXXX) from the page you saw after paying, or from the email that came with it.Open Help → License…, paste the key, and if you like change Computer name (the name this activation is listed under).
Click Activate.
There are two kinds of license, and the same key works on Windows, Linux and Mac:
| License | How it works |
|---|---|
| Standalone | Active on 2 computers at a time. QuadPen checks the key online once; after that it works offline. To move it to another computer, click Deactivate on this computer in the same window first, then activate there. While it is activated, QuadPen checks it again about once a week when you are online. |
| Floating | For teams. Install QuadPen on as many computers as you like; the license is used by one person at a time for each floating license bought. A running QuadPen holds a seat and gives it back when it closes. It needs the internet while it runs: when every seat is in use, Help → License… says so, export, bake and turntable wait, and QuadPen asks again every minute. If QuadPen crashes, its seat is free again after 10 minutes. Remove the key from this computer gives the seat back and forgets the key. |
If a computer with a Standalone license is gone, write to hello@quadpen.com.
Basic workflow#
Load a reference and press F to frame it.
Choose Strip and drag along a major form, or choose Draw and lay out strokes before pressing Enter.
Use Move to select and move vertices, edges, or faces. Grow the patch with Extrude from red boundary edges, and fill gaps with Bridge.
Turn on Live (Symmetry section) before building the second half, or use Mirror plane afterward.
Run Relax on a selection, then Snap all so every vertex sits on the reference.
Preview Subdivision to check the smooth surface.
Save the scene and export the retopology mesh.
Save your scene#
Use File → Save scene (Ctrl+S) or File → Save scene as… to write a native .pen scene. A scene stores the retopology objects, their names, geometry, UVs, the export path, the reference paths and visibility states, and any guide strokes drawn for automatic retopology. Reference meshes stay external, so keep those files in place when you reopen the scene. If a reference is not where the scene says, for example because the scene was moved to another computer, QuadPen looks for a file of the same name next to the .pen file: keeping the two in one folder is enough.
Legacy .qforge and .qpen scenes still open. If you open another scene, create a new one, or quit with unsaved changes, QuadPen asks whether to save, discard, or cancel.