Manual for QuadPen 0.14.0

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#

The Windows build is self-contained and does not require a separate Visual C++ Redistributable installation.

Install on Windows#

  1. On quadpen.com, click Get it from Microsoft Store, or search for QuadPen in the Microsoft Store app.

  2. Click Get (or Install). The Store installs QuadPen and keeps it up to date.

  3. 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:

  1. Download quadpen-0.14.0-macos-universal.dmg from quadpen.com.

  2. Open the disk image and drag QuadPen onto the Applications folder.

  3. 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#

  1. Download quadpen-0.14.0-linux-x64.tar.gz from quadpen.com.

  2. Extract it and go into the folder:

    tar -xzf quadpen-0.14.0-linux-x64.tar.gz
  3. Install it for your user account:

    ./install.sh

    QuadPen appears in your applications menu, and .pen scene files open in it. Everything goes into your home folder (~/.local); no administrator rights are needed. To run it without installing, start ./quadpen in 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:

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:

  1. Copy the license key (QP-XXXXX-XXXXX-XXXXX-XXXXX) from the page you saw after paying, or from the email that came with it.

  2. Open Help → License…, paste the key, and if you like change Computer name (the name this activation is listed under).

  3. Click Activate.

There are two kinds of license, and the same key works on Windows, Linux and Mac:

LicenseHow it works
StandaloneActive 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.
FloatingFor 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#

  1. Load a reference and press F to frame it.

  2. Choose Strip and drag along a major form, or choose Draw and lay out strokes before pressing Enter.

  3. Use Move to select and move vertices, edges, or faces. Grow the patch with Extrude from red boundary edges, and fill gaps with Bridge.

  4. Turn on Live (Symmetry section) before building the second half, or use Mirror plane afterward.

  5. Run Relax on a selection, then Snap all so every vertex sits on the reference.

  6. Preview Subdivision to check the smooth surface.

  7. 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.