A fast, free viewer for STL, 3MF, G-code, FreeCAD, STEP, OBJ, PLY and glTF files on Windows, Linux and macOS,
with a one-click button that opens the file in your slicer.
Open a FreeCAD file and send it as a model straight to your slicer, no export step needed.
📖 Read the guide on the website: English · العربية · Nederlands
⬇ Download · Windows · Linux · macOS · How to use · Build it yourself · What's new
Microsoft retired its 3D Viewer app, and Linux never had a good one. PrintView3D fills the gap, made for people who 3D-print:
it shows models and sliced G-code, tells you the size, print time and filament use, and sends the
file to Creality Print, OrcaSlicer, Bambu Studio, PrusaSlicer, Cura and others with one click.
Designing in FreeCAD? Open the .FCStd file and send it to your slicer as a model directly,
without exporting an STL first.
| STL | Smooth-shaded model on a build plate, with size, triangle count and volume. |
| 3MF | Every object on the plate, including projects from Creality Print, OrcaSlicer and Bambu Studio. Show or hide each object (each with its size), see the project's printer and filament settings and its thumbnail. If the project is already sliced, view its toolpaths without re-slicing. Export STL: save the objects as plain STL files, combined or one per object. |
| G-code | Toolpaths coloured by type (walls, infill, top/bottom, supports, bridges, travel…), a layer slider, "show only this layer", print time, filament use and the slicer's preview picture. |
| FreeCAD | Open .FCStd documents to look at them: shown in 3D exactly as FreeCAD displays them (visible bodies only), with one click to open in FreeCAD or send to your slicer as STL. Uses your installed FreeCAD; without it you still see the preview picture. Details. |
| STEP | Open .step / .stp CAD files: shown in 3D with the help of your installed FreeCAD (converted in the background, remembered afterwards), with the CAD program, author and date from the file. OrcaSlicer, PrusaSlicer and Bambu Studio get the STEP file itself; other slicers get an STL. Details. |
| OBJ, PLY, OFF, glTF / GLB | Other common 3D formats, with the colours saved in the file (textures are not shown). OBJ objects and glTF scenes are listed as separate objects. OBJ goes to your slicer as it is; PLY, OFF and glTF are sent as STL, because not every slicer reads them. Details. |
| ZIP files | Open a downloaded model package (Printables, Thingiverse, …) directly. Only the 3D files are used; pictures, documents and links are skipped. Pick a model from the list, or show all side by side; send one model or all of them to your slicer. Details. |
| Open in your slicer | One click (or Ctrl+P) opens the current file in your slicer. Installed slicers are found automatically. |
| Default app | Optional: make PrintView3D open .stl, .3mf and .gcode files when you double-click them. Fully reversible. |
| Your language | English, العربية (Arabic, right-to-left), Nederlands, Deutsch, Français, Español and Română; switch any time in Settings, no restart needed. Help translate. |
| Themes | Four styles — Default, Gray, Graphite (warm, easy on the eyes) and Ember (warm orange and teal) — each in a light and a dark version, with Light, Dark or System (follows your computer), for the window and the 3D view. Pick from picture cards in Settings, the palette icon, Ctrl+T (next style) or Ctrl+Shift+T (light ↔ dark). Toolpath colours stay the same in every theme. |
| Thumbnails | Windows File Explorer shows previews of 3MF, STL, G-code and FreeCAD files (installed with PrintView3D, optional). On macOS (beta), Finder shows thumbnails of 3MF, STL, G-code, FreeCAD, OBJ and PLY files, and Quick Look (space bar) shows STL, 3MF, OBJ and PLY models in 3D. Details. |
| Updates | Check for updates in Settings, or once a day if you allow it. On Windows one click downloads, checks and installs the new version. The version in the corner gets a red dot when an update is ready. What is sent. |
| One window | A file you double-click while PrintView3D is open is shown in that window, instead of opening another one. Prefer a window per file? Settings → Files → Open each file in a new window. |
| Look inside | View → wireframe, X-ray (see-through), clip from the top with a height slider and a cut that faces you as you turn the view, on their own or both at once, with the cut-away part as a see-through ghost, to check meshes, hidden parts and hollow walls. Measure distances, angles and circles. Details. |
| Check before printing | Check → overhangs, thin walls, holes, tangled (non-manifold) edges, inside-out faces and loose parts, coloured on the model with a count for each. Details. |
| Start page | Your recent files, with a preview card for the one under the mouse: the picture saved in a 3MF, G-code (Creality Print too) or FreeCAD file, or the maker's photo in a ZIP, with its name and folder. Can be switched off. Details. |
| Your toolbar | Hide the buttons you don't use, shorten the view buttons to a name, a key or an icon, and join them into one group (Settings → Toolbar). Hidden buttons keep their keys and stay in the ☰ menu. Details. |
| Comfortable to use | Slicer-style camera, drag & drop, recent files, open a whole folder, screenshots, millimetres or inches, and keyboard shortcuts you can change. |
Found automatically when installed:
Creality Print · OrcaSlicer · Bambu Studio · PrusaSlicer · UltiMaker Cura · Elegoo Slicer · Anycubic Slicer Next
Any other slicer works too: choose it as Custom in Settings.
You do not need Python or anything else to use PrintView3D. Pick your system:
| System | Download | |
|---|---|---|
| Windows 10 / 11 | PrintView3D-Setup.exe (or the portable PrintView3D-windows.zip) |
Instructions |
| Linux (64-bit, x86-64) | PrintView3D-x86_64.AppImage |
Instructions |
| macOS 14.4+ (Apple silicon: M1 and newer), beta | PrintView3D-macOS-AppleSilicon.dmg |
Instructions |
| macOS 14.4+ (Intel), beta | PrintView3D-macOS-Intel.dmg |
Instructions |
All downloads are on the latest release page.
- Go to the latest release and download
PrintView3D-Setup.exe. - Double-click it and click Next → Install → Finish.
- Installs for your user account only, so no administrator password is needed.
- Adds PrintView3D to the Start menu (desktop shortcut optional) and to "Open with" for
.stl,.3mfand.gcodefiles.
- PrintView3D starts. Done.
Previews in File Explorer: the installer also shows thumbnails of 3MF, STL, G-code and FreeCAD files in File Explorer (you can untick this during installation). 3MF, G-code and FreeCAD show the preview picture saved by your slicer or FreeCAD; STL files are drawn. If thumbnails don't appear at once, switch the folder view to Large icons, or sign out and in again. (If PowerToys' File Explorer add-ons are on, PowerToys keeps showing STL and G-code thumbnails.)
Updating: download the new PrintView3D-Setup.exe and run it. It replaces the old version and
keeps your settings.
"Windows protected your PC"? Releases are not code-signed yet (free signing through the SignPath Foundation is being applied for, see Code signing policy), so Windows SmartScreen may warn the first time. Click More info → Run anyway. All the source code is in this repository, and every release is built automatically by GitHub Actions from that code.
Portable version: download PrintView3D-windows.zip, extract it and run PrintView3D.exe.
Nothing is installed. (install_windows.bat in the zip still works too.)
- In PrintView3D, click Settings.
- Open the Files page and click Register & choose as default….
- Windows Settings opens. Pick PrintView3D for
.stl,.3mfand.gcode.
Windows requires you to confirm this last step yourself; no program is allowed to do it silently. Remove registration in the same place undoes everything.
Windows Settings → Apps → Installed apps → PrintView3D → Uninstall. This removes the program,
its shortcuts and file associations, and asks whether to delete your settings too.
(Portable version: run uninstall_windows.bat from the extracted folder.)
PrintView3D for Linux is a single AppImage file: it contains everything it needs and runs on most distributions without installing packages: Ubuntu 22.04 or newer, Linux Mint 21+, Debian 12+, Fedora 36+, openSUSE Tumbleweed, Arch, Manjaro, Pop!_OS, elementary OS, Zorin OS and others.
- Download
PrintView3D-x86_64.AppImagefrom the latest release. - Make it executable: right-click it → Properties → Permissions → Allow executing file as
program, or in a terminal:
chmod +x PrintView3D-x86_64.AppImage
- Double-click it, or run
./PrintView3D-x86_64.AppImage.
Add it to your applications menu (optional, recommended): in PrintView3D open Settings → Files
and click Register & make default. PrintView3D then appears in your applications menu and in
"Open With", and opens .stl, .3mf and .gcode files on double-click. On Linux this takes effect
immediately; Remove registration undoes it.
Tip: keep the AppImage in a fixed place such as ~/Applications before registering, because the
menu entry points to wherever the file is. Or let the script do it all:
./install_linux.sh PrintView3D-x86_64.AppImage # copies to ~/Applications + adds the menu entry
./uninstall_linux.sh # removes it again(The two scripts are in the source code.)
Slicers on Linux are found automatically when installed as an AppImage (in ~/Applications,
~/Downloads, ~/Desktop, ~/bin, /opt…), as a Flatpak or Snap, from your
distribution's packages, or in /opt. Otherwise choose it once with Browse… in Settings.
Linux troubleshooting
| Problem | Fix |
|---|---|
| Nothing happens / "AppImages require FUSE" | Install FUSE: sudo apt install libfuse2 (Ubuntu/Debian), sudo dnf install fuse fuse-libs (Fedora). Or run it without FUSE: ./PrintView3D-x86_64.AppImage --appimage-extract-and-run |
GLIBC_2.35 not found |
Your distribution is older than Ubuntu 22.04 / Debian 12. Build from source instead (below). |
| Window opens but the 3D view stays black | Make sure your graphics driver is installed (Mesa or the NVIDIA driver). In a virtual machine, enable 3D acceleration. |
| Wayland desktop | Supported. PrintView3D automatically runs through XWayland, because the 3D view needs it. |
| Slow rotation on a laptop with two GPUs | Start PrintView3D from the applications menu after Register (the menu entry asks for the dedicated GPU), or use your desktop's Launch using Dedicated Graphics Card option. |
Beta. The Mac version is built and checked automatically, but has not been tried by many people on real Macs yet. Please tell us how it works: your Mac model, macOS version, and anything that looks wrong.
For macOS 14.4 (Sonoma) or newer, in two versions; pick the one for your Mac ( → About This Mac: Chip means Apple silicon, Processor means Intel):
| Your Mac | Download |
|---|---|
| Apple silicon (M1, M2, M3, M4 and newer) | PrintView3D-macOS-AppleSilicon.dmg |
| Intel (2018 and newer, the Macs that run macOS 14) | PrintView3D-macOS-Intel.dmg |
- From the latest release download the
.dmgfor your Mac. - Open it and drag PrintView3D onto Applications.
- Start PrintView3D from Applications. The first time, macOS says it cannot verify the app. Click Done (not "Move to Trash").
- Open System Settings → Privacy & Security, scroll down to Security and click Open Anyway next to PrintView3D. Confirm with your password or Touch ID.
From then on it opens normally.
Why this extra step? Apple only skips it for apps from developers who pay Apple every year for a certificate and "notarization". PrintView3D is free and has no budget for that, so it is signed without an Apple account instead. The program is the same open-source code as on Windows and Linux, built automatically by GitHub Actions. (Right-click → Open no longer works for this on macOS 15 and newer; use Open Anyway as above.)
Open files with PrintView3D: in Finder, right-click a .stl, .3mf, .gcode or .FCStd file →
Open With → PrintView3D. To make it the default: right-click the file → Get Info →
Open with: PrintView3D → Change All….
PrintView3D brings Quick Look support for 3D printing files (beta):
- Thumbnails in Finder for 3MF, STL, G-code, FreeCAD, OBJ and PLY files. 3MF, G-code and FreeCAD files show the picture your slicer or FreeCAD saved in them; STL files (and 3MF files without a picture) are drawn, like on Windows.
- Space bar preview: select a file and press the space bar. STL, 3MF, OBJ and PLY models are shown in 3D (drag to turn, scroll or pinch to zoom) with their size in millimetres. G-code and FreeCAD files show their saved picture. For everything else (layers, objects, settings) open the file in PrintView3D.
It works once PrintView3D is in Applications and has been started once (steps 1–4 above). If no previews appear, open System Settings → General → Login Items & Extensions, click Quick Look (the ⓘ next to it) and switch on PrintView3D. Finder keeps old thumbnails for a while; files you copy or save afterwards show the new ones. STEP files are not previewed: reading them needs FreeCAD, which Quick Look can't use. If another app (a slicer, FreeCAD) also offers previews for one of these file types, macOS may use that app's preview instead.
Slicers in Applications (Creality Print, OrcaSlicer, Bambu Studio, PrusaSlicer, Cura, …) are found automatically. Updates: Download update opens the release page; drag the new version into Applications to replace the old one. Older Macs that can't run macOS 14: let us know if you need a version for them.
Open a file: double-click it (if PrintView3D is the default), drag it onto the window, use
Open file or ZIP… (Ctrl+O), or pick it from Recent in the ☰ menu or on the start page. Try the files in examples/ to get started.
Home: the house button (Ctrl+W) closes the open file and goes back to the start page, with
your recent files. It also gives back the memory the file took, which matters most after a large
G-code or ZIP.
On the start page, hold the mouse over a recent file and a card in the bottom right corner shows its preview picture (3MF projects, G-code and FreeCAD files that have one), its name and the folder it is in. A ZIP shows the maker's photo or render inside it, or else the picture of its first 3MF or G-code. The card stays in the same place for every file, so you can run down the list and compare. Don't want it? Untick Settings → Viewer → Start page → Show a preview of recent files when the mouse is over them; then the files are not read until you open them.
A whole folder: ☰ → Open folder… lists the 3D files of a folder in the side panel; step
through them with ↑ / ↓ or a click.
One window: a file you double-click while PrintView3D is already open is shown in that window, which comes to the front. To give every file its own window (to compare two models side by side), tick Settings → Files → Open each file in a new window. Starting PrintView3D from the Start menu or applications menu, without a file, always opens a new window.
| Action | What it does |
|---|---|
| Left-drag | Rotate. Press on the model to rotate around that exact point; press on empty space to rotate around the model's centre. The plate always stays level. |
| Right-drag (or middle-drag, or Shift + left-drag) | Move (pan) |
| Mouse wheel | Zoom towards the mouse pointer |
While you turn, move or zoom, the pointer shows it (circling arrows, four arrows, a magnifier), and is the normal arrow again when you let go.
| View cube (top-right corner) | A see-through cube with a dashed ring. Click a face to jump to that view (Top, Front, Right, Back, Left or Bottom). Drag the cube to rotate, or drag the ring under it to turn without tilting. With the mouse over the cube, arrows and a Home icon appear: ◀ ▶ turn the model to the next 45° stop, ▲ ▼ tilt it 45° towards Top or Bottom, and Home goes back to the fitted Iso view. The arrows always land on one of the cube's 26 views (faces, edges, corners), so after a free drag the first click lines the view up again. View changes turn smoothly; click or drag to stop one. The part under the mouse lights up in the theme's main colour (amber in Ember). Because Top, Front and Right are on the cube and its Home icon is the Iso view, the toolbar keeps only Fit (handy when you have zoomed far away from the model) and Plate; hide the cube in Settings → Viewer and the Iso, Top, Front and Right buttons come back. The keys 1 2 3 4 work either way. |
Looking from underneath? The plate gets out of the way so you can see the bottom of the part.
These are the keys PrintView3D comes with. Settings → Keyboard and mouse lists them all, and you can give any of them a key of your own there: click its field and press the new key (the clear button removes it). The buttons then show your key (tooltips name no keys). Reset to defaults puts them all back. Keys the system uses (the Windows or Super key, Alt+F4, Alt+Tab, ⌘Q, Ctrl+Alt+Del and the like), Tab, Enter, Esc and Space can't be chosen, and neither can a key another action already has. The mouse controls are fixed.
| Key | Action |
|---|---|
Ctrl+O |
Open a file |
Ctrl+W |
Close the file (back to the start page) |
Ctrl+P |
Open the file in your default slicer |
Ctrl+E |
Export STL (3MF projects, FreeCAD and STEP files) |
S |
Settings (it stays open beside the main window, which keeps working) |
Ctrl+Shift+S |
Save a screenshot of the 3D view. It asks where, or saves straight to a folder of your choice: Settings → Files → Screenshots |
Ctrl+T |
Next theme style (Default → Gray → Graphite → Ember), same light/dark mode |
Ctrl+Shift+T |
Switch the theme between light and dark |
F |
Fit the model in the view |
1 · 2 · 3 · 4 |
Iso · Top · Front · Right view |
P |
Build plate on / off |
C · V |
Check section · View section, on / off (models) |
W · X · T · Y |
Wireframe · X-ray · Clip from the top · Clip facing you, on / off (models) |
L |
Lock the facing cut: it stops turning with the view (models) |
R |
Reset view: wireframe, X-ray and the cuts off, model fitted (on G-code: fit) |
M |
Measure on / off (models) |
D · A · O |
Measure a distance · an angle · a circle |
K |
Remove all measurements (Measure stays on) |
↑ / ↓ |
Next / previous layer (G-code), or the file above / below in a ZIP or folder |
Page Up / Page Down |
10 layers up / down |
Home / End |
First / last layer |
The View button in the toolbar opens the View section in the side panel, with every option as a button (a button that is on is drawn darker). It changes how a model is drawn (STL, 3MF, OBJ and the other model formats; G-code has its layer slider instead):
- Wireframe (
W): the triangles of the mesh, to see how fine it is or spot broken geometry. - X-ray (
X): the parts become see-through, so parts inside other parts, cavities and hollow walls show. - Clip from the top (
T): hides everything above a height. A slider in the side panel moves the cut; the inside of the walls that the cut lays open is drawn in red.Tor the button again shows the whole model. - Clip facing you (
Y): an upright cut that always faces you and hides the part of the model in front of it. Turn the view and the model turns through the cut; move (pan) the view and it slides across, as if you held the model up to a scanner. For a cut from the front or the side, click that face on the view cube. The slider moves the cut nearer or further, and Depth shows how far it is into the model. Lock facing cut (L, the button left of Reset view) stops the cut turning with the view, so you can turn the model and look at the cut from the side; the slider still moves it. While the cut is not locked, the Measure section shows a red dot and Facing cut not locked; hover over it for why: points placed on the cut stay behind when the view turns. - Both cuts at once:
TandYeach turn their own cut on and off, so both can be on together for a corner cut away, with a Height and a Depth slider in the side panel. What the cuts hide stays one even ghost, and each cutting plane stops where the other cut is. Reset view ends both. - Show the cut-away part and Show the cutting plane (under the sliders, both on by default): what the cut hides stays as a white, see-through ghost with outlined edges, and the cutting plane shows as a faint sheet the size of the model, so you see what the cut takes away and where. Each is a button that stays lit while on, and your choice is remembered. In Settings → Viewer, Cut-away part and Cutting plane each have a Fainter … Stronger slider; the 3D view changes while you drag.
- Drag the cuts in the 3D view (an option): tick Settings → Viewer → Also move the cutting planes by dragging them in the 3D view and each cut gets a small round handle on the edge of its cutting plane, with a short line showing which way it moves. Under the mouse its colours swap. Drag it to move the cut; its slider moves along.
- Reset view (
R): turns all of the above off and fits the model, like Fit, in one go. Measurements stay.
Wireframe and X-ray stay on when you open the next model; the cuts and the measurements are removed. The options work together (X-ray and clip, for example).
- Measure (
M, the button next to View): Distance (with ΔX ΔY ΔZ if you like), Angle and Circle (diameter and radius). A click places a point, a drag still turns the view, and a placed point can be dragged. Points snap to corners and edges, and with a cut on also to the outline of the cut, so you can measure inside the model; the value is written next to every measurement, and Clear (K) removes them all. - Object colours: click the colour box of an object in the Objects list to give it another colour; right-click goes back to the file's colour. Not saved.
- Grid numbers: Settings → Viewer → Show scale numbers on the grid writes millimetres along the build plate, as many as fit at the zoom you look at, counting from the plate's front-left corner (0). Grid lines every and Main grid lines every set the grid itself.
More, with pictures: Look inside your models. Built by @covrig.
The Check button (C, between Plate and View) opens the Check model section and colours
what may cause trouble when printing, with a count for each (models only, not G-code):
- Overhangs: faces facing down and leaning further from vertical than an angle (45° by default); faces on the plate don't count.
- Thin walls: walls and pins thinner than your nozzle (0.4 mm by default). Runs in the background, so it is off until you tick it.
- Mesh problems: Holes (open edges), Tangled edges (non-manifold), Inside-out faces (flipped normals) and Loose parts up to a size you set (5 mm by default).
A red dot marks the problems found. Click a colour box to change its colour; hover over a name for what it means. The highlights follow the cuts and the objects you hide. More: Check before printing. Built by @covrig.
Settings → Slicer → Default slicer. Each slicer is marked installed or not found. If yours
is installed in an unusual place, click Browse… and select its program file. For a slicer that
is not in the list, choose Custom program…, give it a name and select its .exe.
The green button is renamed to match ("Open in OrcaSlicer"). The small ▾ arrow next to it lists your other installed slicers, for opening a file in one of them just once.
Open a FreeCAD document (.FCStd) with Open or drag & drop it onto the window
(PrintView3D does not take over the double-click from FreeCAD).
It is for looking only; nothing in the file is changed.
- With FreeCAD installed (free, freecad.org) the model is
shown in 3D as FreeCAD displays it: visible bodies and solids only, without sketches, hidden
objects or datum planes. PrintView3D starts FreeCAD invisibly in the background to convert the
shapes (a few seconds the first time; then it is remembered until the file changes).
The big button becomes Open in FreeCAD, and the ▾ arrow sends the visible model to
your slicer as an STL. Export STL (
Ctrl+E) saves the visible solids as STL files: all in one file, or one file per solid (the same choices as for a 3MF project). This also works for STEP files. - Without FreeCAD you see the file's preview picture, the FreeCAD version and the visible objects, with a button to download FreeCAD.
FreeCAD is found automatically in its usual places (Windows installer, Linux packages, Snap, Flatpak, AppImage). If yours is elsewhere, choose it in Settings → FreeCAD.
Because FreeCAD itself opens the file, a FreeCAD or STEP file deserves the same trust as when you open it in FreeCAD: open files from people and sites you trust.
![]() With FreeCAD installed: the bracket in 3D. |
![]() Without FreeCAD: the preview picture saved in the file. |
With a 3MF project open, Export STL in the toolbar (Ctrl+E) saves its objects as plain STL
files, for example to share a model or open it in a program that does not read 3MF.
- A dialog lists every object with its name and triangle count, all ticked; untick what you don't need.
- The arrow next to the button offers every way directly: All objects as one STL, One STL per object and Choose objects… (the dialog). The one a click makes is shown in bold.
- What a click does (and
Ctrl+E) is chosen in Settings → Files → Export STL: show the list of objects (the default), save everything as one STL, or save one STL per object. Change what a click does… at the bottom of the arrow's menu opens that setting. - One combined STL: the ticked objects in one file, placed as they are on the plate.
- One STL per object: each file is named after its object and saved into a folder you choose (PrintView3D asks before replacing files that are already there).
- A file with only one object always goes straight to the Save dialog.
- Raw geometry only: modifiers, negative parts and support blockers / enforcers are left out (as recorded by Creality Print, OrcaSlicer, Bambu Studio and PrusaSlicer), and so are colours, materials and print settings. Sizes are in millimetres; the files are binary STL.
Model downloads often come as a ZIP. Open it like any other file (Open file or ZIP… or drag it onto the window); there is no need to unpack it first.
![]() Show all side by side: tick or untick each model; the G-code opens on its own. |
![]() Click a file in the list, or use ↑ / ↓: here the sliced G-code from the same ZIP. |
-
Only the 3D files are used: STL, 3MF, OBJ, PLY, OFF, glTF/GLB, STEP, FreeCAD and G-code. Pictures, PDFs, read-me files, web links, ZIPs inside the ZIP and the hidden
__MACOSXfolder are skipped, and the panel says how many were skipped. -
A ZIP with one 3D file opens just like that file.
-
More files are listed in the side panel with a coloured label for their type (STL, 3MF, G-code, …) and a short explanation of each type. The first file is shown; click another one, or use ↑ / ↓, to switch.
-
Show all side by side places the models next to each other: up to three in one row, then a grid (four as 2 × 2, six as 3 × 2, nine as 3 × 3, …), spaced by their real size. Untick models in Objects to hide them. G-code, STEP and FreeCAD files are opened one at a time.
-
Open in slicer sends the model you are looking at; in Show all, the ticked models. The arrow next to the button has Send all models in the ZIP.
-
A slicer opens a 3MF as a project on its own, so it cannot take a 3MF together with other files. When the models to send include a 3MF, PrintView3D asks: the 3MF project (with its plates and settings), the other models on one plate, or everything as STL (the project's objects become a plain STL, so all models go on one plate).
The 3D files are unpacked into PrintView3D's own cache folder (slicers need real files); the sizes are checked first, so a damaged or malicious ZIP cannot fill your disk. Files from ZIPs opened more than a day ago are removed automatically.
STEP (.step, .stp) is the common format for exchanging CAD models between programs. It stores
exact shapes (curved surfaces), not triangles, so PrintView3D uses FreeCAD to turn them into a
mesh, the same way as for FreeCAD files: hidden in the background, a few seconds
the first time, then remembered until the file changes.
- Parts: an assembly's parts are listed separately with their names from the file, and can be hidden. (If FreeCAD's import gives anything unexpected, PrintView3D shows each solid instead, so the shape is always right.)
- Without FreeCAD you still see the details from the file (STEP version, the CAD program it was made with, author, organization, date) and a button to download FreeCAD.
- Send to slicer: OrcaSlicer, PrusaSlicer and Bambu Studio open STEP files themselves and get the file as it is (also without FreeCAD). Other slicers get the visible parts as STL, which needs FreeCAD.
- STEP files are added to Open with, but PrintView3D never makes itself their default app.
| Format | What is read | Sent to your slicer as |
|---|---|---|
OBJ (.obj) |
Objects (o) or groups (g) as separate objects; colours from the .mtl file next to it, or vertex colours. |
The .obj itself |
PLY (.ply) |
Text and binary; vertex or face colours. Point clouds (no faces) can't be shown. | STL |
OFF (.off) |
Text files (also COFF), with vertex or face colours. | STL |
glTF / GLB (.gltf, .glb) |
Every object in the scene at its position, with its material colour or vertex colours. | STL |
- Sizes: OBJ, PLY and OFF have no units; PrintView3D treats the numbers as millimetres, like slicers do. If a model shows up tiny, the file was probably made in metres; your slicer can scale it. glTF is always in metres and is shown in millimetres (with Z up, as on a printer).
- Not read: textures (image files on the model), animations, and glTF files compressed with Draco or meshoptimizer (PrintView3D says so; export them again without compression).
- These types are added to Open with, but PrintView3D never makes itself their default app.
Settings → Language and units → Language switches the whole program immediately, including file dialogs and standard buttons. English is the default; Automatic follows your system language. Arabic uses a right-to-left layout; measurements always use Western digits (0.20 mm). A wrong or missing word? The link on that page leads to How to translate.
Millimetres or inches: Settings → Language and units → Lengths in shows every length (sizes, measurements, cuts, the grid and the plate) in millimetres or inches. Files are not changed.
A theme is a style in a mode. There are four styles — Default, Gray, Graphite and Ember — and each comes in a light and a dark version. The mode picks which one you see:
- Light or Dark: always that version.
- System: follows the dark/light setting of Windows, macOS or your Linux desktop, and switches along when that changes. On Linux it reads the GNOME, GTK or KDE setting; if the desktop doesn't say dark anywhere, PrintView3D starts light.
Where to choose:
- Settings → Appearance → Theme: a Light / Dark / System selector and a picture card for each style, showing PrintView3D in that style and mode. Click a card or a mode and every window switches at once, so you can try them one after another. OK keeps your choice; Cancel goes back to the theme you had when you opened Settings.
- The palette icon at the right end of the toolbar: the four styles with a colour swatch, then Light, Dark and System.
Ctrl+Tsteps to the next style and keeps the mode;Ctrl+Shift+Tswitches the same style between light and dark.
The styles:
- Default: neutral greys with teal buttons — white-grey by day, charcoal at night.
- Gray: cooler, mid greys in both versions.
- Graphite: warm coffee tones — latte and taupe by day, a dark brownish charcoal that is soft on the eyes at night.
- Ember: orange and teal. By day warm cream: the slicer button, OK and the chosen Settings page are orange; the toolbar tiles, sliders and focus are teal; Export STL and the view buttons (Fit and Plate; Iso too when the view cube is off) are filled with a deep teal with white text; text is a soft slate grey instead of black, and the 3D view a deeper sand colour, so white and yellow toolpaths stay visible. At night the same orange and teal on deep lagoon greens, with a teal-lit build plate.
Settings from older versions carry over: Automatic becomes Default + System, Ember Light becomes Ember + Light, Ember Dark becomes Ember + Dark, and so on.
Window transparency (Windows 11) sits under the theme, with the same kind of selector: Off, Mica (a soft tint of your wallpaper) or Acrylic (frosted glass). It takes effect after a restart; on other systems it stays Off.
The switch is immediate; the 3D background, plate and grid change with it, while G-code and model colours stay the same so they always match your slicer. In every theme, text and grey labels have a contrast of at least 4.5 : 1 against the window, so they stay easy to read.
Settings → Appearance → Window transparency lets the toolbar, side panel and status bar show what lies behind the window, in any theme:
- Mica: a soft tint of your desktop wallpaper (as in File Explorer).
- Acrylic: frosted glass that blurs the desktop and other windows behind it.
- Off (default): solid, as before.
The 3D view always stays solid. It takes effect after a restart: when you click OK, PrintView3D asks Restart now (it closes and opens again, with the same file) or Later. Windows draws the effect itself and shows a plain colour while the window is not active, and switches it off with Transparency effects off in Windows Settings or in battery saver. Windows 10 and other systems keep the normal look.
Settings → Toolbar (also ☰ → Customize toolbar…, or right-click the gear or an empty spot on the toolbar) chooses which buttons the toolbar shows, for a calmer toolbar if you don't use every feature:
-
Can be hidden: Home, Open, Check, View, Measure, Screenshot, Theme and Settings.
-
Always shown: the ☰ menu, Open in slicer, Export STL (3MF and CAD files), Plate and Fit.
-
The order never changes. A hidden button only leaves the toolbar; Plate stays the first of the view buttons and Fit the last.
-
Nothing gets lost. A hidden button keeps its key (
C,V,M,Ctrl+W, …), and the ☰ menu has everything, including Check, View, Measure and the Theme menu. -
Right-click a button for its settings. Each button offers one item that opens Settings at that button's own options:
Right-click on Opens Theme Appearance (the themes) Screenshot Files → Screenshots (the folder, save without asking) Open in slicer Slicer (the default slicer) Export STL Files → Export STL (what a click does) Plate Viewer → Build plate Check, View, Measure Viewer → Measure, View and Check Settings, Home, Open, Fit or an empty spot Customize toolbar…
Under Look you choose how the view buttons (Plate, Check, View, Measure and Fit) are labelled: icon, name and key (Plate (P), the default), icon and name (Plate), icon and key (P) or icon only (the tooltip names it). Join the view buttons into one group draws them as one connected bar.
Every change shows in the window, and in the picture at the top of the page, right away: OK keeps it, Cancel goes back. Reset to defaults shows every button again.
Settings → Updates shows your version and has Check for updates now. You can also switch on Check for updates automatically (once a day); PrintView3D asks once whether you want this (on the second start: the first start shows only the program), and you can change it there at any time.
When a new version exists, the version in the bottom-right corner shows a red dot (● v0.10.0 → 0.11.0), and so does Updates in Settings. Click it to see What's new, then:
- Windows (installed with Setup.exe): Install update. PrintView3D downloads the new installer, checks its SHA-256 fingerprint against the one GitHub publishes, installs it (no questions, your settings are kept) and starts the new version.
- Linux (AppImage) and the portable Windows zip: Download update opens the release page;
download the new file and replace the old one. The AppImage can also be updated with
AppImageUpdate or other tools that read
AppImage update information: they download only the changed parts, using the
PrintView3D-x86_64.AppImage.zsyncfile published with every release. PrintView3D itself never starts such a tool. - Skip this version hides that version; the next one is shown again.
After an update, the first start shows What's new since the version you had, once, however
you updated (installer, winget, zip or AppImage). Any time later, Menu → What's new shows the
notes of the version you have, with a button to every change on GitHub. Both are read from the
changelog that comes with the program, so they need no connection; a fresh install doesn't show the
window by itself. The notes are in your language where the changelog is translated (Arabic and
Dutch: CHANGELOG.ar.md, CHANGELOG.nl.md); otherwise, or
for a version not translated yet, they are shown in English.
PrintView3D works offline. It connects to the internet only for updates, and only when you click Check for updates now or have switched on the daily check:
| What is contacted | api.github.com (to ask for the newest release of this project) and, when you click Install update, the download from github.com |
| How often | At most once a day (automatic check), or when you click Check for updates now |
| What is sent | Only the request for the newest version, with the program name and version (PrintView3D/0.10.0). No personal data, no files, no usage statistics, no ID. |
| What GitHub sees | Like any website: your IP address. See GitHub's privacy statement. |
| How to turn it off | Settings → Updates → untick Check for updates automatically. Nothing is contacted after that. |
Many laptops have two graphics chips and run programs on the slower one by default. Settings → Viewer → Graphics shows which one PrintView3D uses. If it says Intel, tick Use the high-performance graphics card and click OK; choose Restart now (or Later, and it switches the next time you start PrintView3D).
Only needed if you want to change the code or don't want to use the ready-made download.
PrintView3D uses VTK for its 3D drawing, and VTK only supports certain Python versions. The newest Python is often not supported yet, and python.org's big download button always gives you the newest one.
| Python version | Works? |
|---|---|
| 3.10, 3.11 | ❌ No (too old for the library versions the builds use, such as NumPy 2.5) |
| 3.12 | ✅ Yes, recommended (what the official builds use) |
| 3.13, 3.14 | ✅ Yes |
| 3.15 and newer | ❌ Not yet (no VTK version for it) |
Already have Python? Check which versions you have: open Command Prompt and type py --list.
Install Python 3.12, using one of these:
- Easiest, in Command Prompt or PowerShell:
winget install Python.Python.3.12 - Or from python.org: go to python.org/downloads/windows, find the latest Python 3.12.x release and download the Windows installer (64-bit). During setup, tick "Add python.exe to PATH" only if you have no other Python installed.
Check with python3 --version. If it says 3.11 or older, or 3.15 or newer, install 3.12 next to it:
| Distribution | Command |
|---|---|
| Ubuntu / Mint / Pop!_OS | sudo apt install python3.12 python3.12-venv (on older Ubuntu first: sudo add-apt-repository ppa:deadsnakes/ppa) |
| Debian | sudo apt install python3 python3-venv (Debian 13 ships 3.13; Debian 12 ships 3.11, which is too old: use pyenv) |
| Fedora | sudo dnf install python3.12 |
| Arch / Manjaro | yay -S python312, or use pyenv |
You also need curl and git (usually already installed).
You can keep several Python versions side by side; they don't interfere with each other. The build scripts automatically pick a supported one (3.12 first), so an existing newer Python is not a problem.
Either click the green Code → Download ZIP button on this page and extract it, or:
git clone https://github.com/sevagjb/PrintView3D.git
Windows: double-click build_windows.bat in the project folder (or run it from a terminal).
Then run install_windows.bat. If Inno Setup 6 is
installed, the build also makes the installer dist\PrintView3D-Setup.exe.
Linux: in a terminal, in the project folder:
./build_linux.sh # makes dist/PrintView3D-x86_64.AppImage
./install_linux.sh # optional: copy to ~/Applications + add to the applications menuThe first build takes a few minutes (it downloads about 300 MB of libraries); later builds are faster.
flowchart LR
A["Find a supported Python<br/>(3.12 → 3.13 → 3.14)"] --> B["Create a private<br/>environment (.venv)"]
B --> C["Install libraries<br/>(Qt, VTK, PyVista, NumPy)"]
C --> D["Run the tests"]
D --> E["PyInstaller packs everything<br/>into dist/PrintView3D"]
E --> F["Windows: zip folder<br/>Linux: AppImage"]
- Find Python. It looks for 3.12, then 3.13 and 3.14 (Windows: through the
pylauncher; Linux:python3.12,python3.13, …) and uses the first one it finds. If none is installed, it stops and tells you what to install. - Create
.venv. A private folder with its own copy of the libraries, so nothing is installed into your system Python and nothing else on your PC is affected. Delete.venvto start fresh. A.venvmade earlier by an unsupported Python is replaced automatically. - Install libraries listed in
requirements.txt(the app) andrequirements-build.txt(PyInstaller and pytest). - Run the tests in
tests/. The build stops if any test fails. - Package. PyInstaller collects Python, the libraries and the app into
dist\PrintView3D\PrintView3D.exeplus an_internalfolder. That folder is the finished program and runs on any Windows 10/11 PC without Python. It is large (several hundred MB), mainly because of the VTK 3D engine. - Linux only: AppImage.
build_linux.shdownloads appimagetool once and packsdist/PrintView3D/into the single filedist/PrintView3D-x86_64.AppImage. (--no-appimageskips this step.)
| Problem | Fix |
|---|---|
No supported Python version was found |
Install Python 3.12 (Step 1). |
Python was not found / 'py' is not recognized |
Install Python from python.org or with winget (Step 1); both include the py launcher. |
Linux: Could not create a virtual environment |
Install the venv module, e.g. sudo apt install python3.12-venv. |
Linux: qt.qpa.plugin: Could not load the Qt platform plugin "xcb" when running from source |
Install Qt's X11 helper: sudo apt install libxcb-cursor0 (Fedora: xcb-util-cursor). The AppImage already includes it. |
Cannot install numpy … conflicting dependencies / ResolutionImpossible |
Your Python is older than 3.12 (an older build script accepted 3.10 and 3.11). Install 3.12 (Step 1) and run the build again; the script replaces the old .venv by itself. |
Build fails while installing vtk |
You are on an unsupported Python. Install 3.12 and run the build again; the script replaces the old .venv by itself. |
| Tests fail | Please open an issue and paste the output. |
Windows Defender deletes or blocks the .exe |
A known false alarm with PyInstaller programs. Allow it in Windows Security → Protection history. |
run_from_source.bat :: start from the source code, no packaging (Linux: ./run_from_source.sh)
.venv\Scripts\python -m pytest -q :: run the tests
.venv\Scripts\python tools\make_demo.py :: regenerate examples\
.venv\Scripts\python tools\make_screenshots.py :: regenerate the README picturessrc/printview3d/
app.py entry point and command-line options
loaders/gcode.py G-code reader (layers, feature types, print info, thumbnails)
loaders/mesh.py STL and 3MF readers, STL writer (Export STL)
slicer.py list of slicers, detection and launching
file_assoc.py "Open with" / default app (assoc_windows.py: registry, assoc_linux.py: freedesktop)
gpu.py graphics-card info and high-performance GPU setting
settings.py settings file: %APPDATA%\PrintView3D\settings.json
ui/ window, 3D scene, camera controls, settings dialog, theme
tests/ automated tests and sample files
tools/ demo-file and screenshot generators
packaging/linux/ AppImage launcher and menu entry
packaging/macos/quicklook/ Finder thumbnails and Quick Look preview (Swift app extensions)
printview3d.spec PyInstaller recipe (Windows and Linux)
Automatic builds: every push builds and tests the Windows program on GitHub
(Actions). When the version number in src/printview3d/__init__.py changes,
it also publishes a new release with the Windows zip and the Linux AppImage
attached.
PrintView3D.exe model.stl open a file (in the window already open, if any)
PrintView3D.exe model.stl --new-window open a file in a new window
PrintView3D.exe part.gcode --screenshot out.png save a picture and exit
[--layer 25] [--view iso|top|front|right]
PrintView3D.exe model.stl --send-to-slicer open the file in your default slicer and exit
PrintView3D.exe model.stl --send-to-slicer orcaslicer ...or in a specific one
PrintView3D.exe --lang ar start in a language (en, ar, nl, de, fr, es)
PrintView3D.exe --theme light start with a theme (auto, dark, gray, graphite, light, ember, ember_dark)
PrintView3D.exe --register add to "Open with" (Linux: also the applications menu)
PrintView3D.exe --unregister remove file associations
(on Linux use ./PrintView3D-x86_64.AppImage instead of PrintView3D.exe)
| Language | Status |
|---|---|
| English | Source language |
| العربية Arabic | Complete, reviewed by a native speaker |
| Nederlands | Complete, reviewed |
| Deutsch | Complete, needs review by a native speaker |
| Français | Complete, needs review by a native speaker |
| Español | Complete, needs review by a native speaker |
| Română (Romanian) | Complete, reviewed by a native speaker |
Speak one of these languages? Or want PrintView3D in yours? Your help is very welcome:
spotting one wrong word already helps. Translations are made right here on GitHub: change the
file for your language in translations/ and open a pull request, all in the
browser. Step by step: How to translate.
Untranslated texts simply appear in English, so a language can be added step by step.
Bug reports, ideas and pull requests are welcome; see CONTRIBUTING.md.
Is your slicer missing? It is usually a single entry in SLICERS in
src/printview3d/slicer.py.
- Windows 10/11 and Linux (x86-64) are packaged and tested. The Mac versions (Apple silicon and Intel, macOS 14.4+) are in beta. ARM Linux (Raspberry Pi etc.) is not packaged yet.
- A 3MF project saved in one brand of slicer may lose its printer/print settings when opened in a different brand. The model itself loads fine; that's how the slicers behave.
- Binary G-code (
.bgcode) is not supported yet. - File Explorer thumbnails are made for 3MF, STL, G-code and FreeCAD files; not yet for OBJ, PLY, OFF and glTF. On macOS, Quick Look covers 3MF, STL, G-code, FreeCAD, OBJ and PLY (not STEP, OFF or glTF).
- FreeCAD documents need an installed FreeCAD for the 3D view (PrintView3D does not include FreeCAD's geometry engine). Very old or very new FreeCAD versions may not open each other's files.
Windows releases are built automatically from this repository by GitHub Actions; no binaries are built or uploaded by hand.
Status: applying for free code signing for open-source projects. When approved: Free code signing provided by SignPath.io, certificate by SignPath Foundation.
| Role | Members |
|---|---|
| Committers and reviewers | sevagjb |
| Approvers | sevagjb |
Every signing request is approved by hand by an approver. Contributions from other people are reviewed before they are merged.
Privacy: this program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. PrintView3D works fully offline; it only opens your files and starts the slicer you choose. The only connection it ever makes is the update check, and only when you ask for it or switched on the daily check; see Updates and privacy.
MIT. Free to use, change and share. Built with Qt for Python, PyVista and VTK.



















