The viewer opens several STL files at once, shows the parts in the position they were exported in, mirrors parts to the opposite side of the cockpit, and stores sets of parts that you can reopen later. Everything runs inside the browser: no file is ever uploaded.
The interface is available in Portuguese, English, Spanish and French. Switch with the PT, EN, ES and FR buttons at the top of the viewer; this manual follows your choice.
Getting started
Use Chrome or Edge on a PC, on an https:// address. They are the ones that can read and write directly in your folders. Firefox and phone browsers open and display the parts normally, but everything they save goes to the Downloads folder.
The first time round, do these three things, in this order:
- Click Sets folder and choose where your sets should be kept.
- Click Add part folder and point to a folder that holds your STLs. Repeat for every folder you use.
- When the browser asks, choose Allow on every visit, so it stops asking each session.
These registrations live in the browser and belong to the site address. If you open the viewer from another address, or from another computer, register the folders again. Nothing is moved or copied in the process.
Opening parts
Two ways: the Open files (STL, 3MF, OBJ) button, which takes several files at once, or dragging the files onto the dark area of the viewer.
Parts exported together from the same project appear already positioned relative to each other, because the viewer respects the coordinates stored in the file. Each part gets its own colour and joins the list in the sidebar.
Binary and text STL files both work. If a file is corrupt or empty, a notice appears in the corner and the other parts keep loading.
Besides STL, the viewer opens 3MF (the format Creality Print and Fusion export) and OBJ. A 3MF holding several parts opens each one separately, named file.3mf#part; so does an OBJ with several objects. Sets recognise these sub-parts.
Open from URL opens a file from an internet address, for instance a Dropbox share link (converted to a direct download automatically). Google Drive does not work, because it refuses cross-site access. Copy link copies an address like mystl.com.br/?stl=... that reopens the parts loaded from URLs; a set also records those URLs and downloads them again when reopened.
Rotate, pan and zoom
| Action | On a PC | On a phone |
|---|---|---|
| Rotate | Drag with the left button | Drag with one finger |
| Pan | Right button, or Shift + drag | Drag with two fingers |
| Zoom | Mouse wheel | Pinch |
| Select | Click on the part | Tap the part |
Zoom moves towards the pointer rather than the centre of the screen, which helps when you are going into a specific detail. If it feels too fast or too slow for your mouse, adjust the Zoom control in the top bar; your setting is remembered.
The Fit view button brings the camera back to a position that shows everything visible. Use it whenever you get lost.
In the top-right corner sits the view cube, Fusion 360 style. It turns with the scene and shows which side you are looking from: FRONT, BACK, LEFT, RIGHT, TOP and BOTTOM. Click a face to look from it, an edge for a 45° view or a corner for an isometric one; the region under the pointer is highlighted before you click. Dragging the cube itself rotates the scene. Below it, the ← → arrows turn 90° about the vertical axis and the little house returns to the home view, fitting everything; above it, the two round buttons roll the view clockwise and counter-clockwise. Front is the -Y axis of the file coordinates and top is +Z; the triad at the cube corner shows X (red), Y (green) and Z (blue).
The Ortho button swaps perspective for an orthographic camera, with no distortion, handy for comparing alignments and dimensions. Photo downloads a PNG of the scene named after the set.
View modes
Assembly
Keeps the original coordinates from the files. This is the mode for checking fits, clearances and alignment between parts.
Centre each
Puts every part on the origin, resting on the grid plane. Good for examining one part closely without the others in the way.
Side by side
Lines the parts up with a gap between them, to compare sizes and see them all at once.
Besides the modes, the top bar has Wireframe, which shows the triangle mesh, and Grid, which turns the floor grid on and off. The grid scales itself to the parts, and the footer tells you how many files and how many triangles are in the scene.
The part list
Each part in the sidebar has the checkbox that shows or hides it, the colour it is drawn in, the file name, the dimensions in millimetres, and the × that removes it from the scene.
Clicking a part, in the list or on screen, highlights it in blue in both places, and the footer shows its name. That is the quick way to find out which file a part on screen belongs to.
The dimensions are the bounding box, in X, Y and Z. Handy for checking whether a part fits your printer bed before you slice it.
Mirroring and saving
Each part's Mirror button creates the version for the opposite side of the cockpit. A mirrored part shows its name in amber in the list, and the same button undoes it.
Mirroring happens on the X=0 plane of the file's coordinates, and the vertex order is flipped along with it, so the normals keep pointing outwards. The file comes out ready for the slicer.
With a part mirrored, Save mirrored writes the new file into the same folder as the original, with (espelhado) at the end of the name. That suffix stays the same whatever the interface language, so you never end up with two different names for the same part. If the original's folder is registered, it writes straight away with no dialog, and asks before replacing an existing file.
Save all mirrored, at the top of the sidebar, does this in one go for every mirrored part in the scene.
The folders
A browser never reveals a file's full path, something like C:\Dropbox\Cockpit\.... It only grants access to folders you authorise, one at a time. That is why the viewer works with two kinds of folder.
Sets folder
Where set files are written, and where they are looked for when you open one. Only one.
Part folders
The folders where your STLs actually live. As many as you like, in different places on the disk, and their subfolders count too, down to four levels. STLs are never copied anywhere: a set only records which registered folder each part sits in and its path inside that folder.
The × next to a name only takes the folder off the viewer's list. Nothing is deleted from the disk.
If you open a part that is outside the registered folders, an amber notice appears in the sidebar with an Add the folder of [part name] button. The picker opens right inside that part's folder, so you only confirm. Without that registration the part displays fine, but a set will not be able to reopen it later.
Sets
A set is a snapshot of what is assembled on screen. It does not contain the parts, only references to them, which is why the file is a few kilobytes. What it records:
- which parts are open, and which folder each one is in;
- which are mirrored and which are hidden;
- the view mode, the wireframe and the grid;
- each part's offset, rotation and opacity;
- the explode amount, the cutting plane and the camera type;
- the notes pinned to parts;
- the camera angle, roll and distance;
- the URL of parts opened from the internet.
Saving
Click Save set, check or change the suggested name, and confirm. The file is written to the sets folder as Name.conjunto.json. If a set with that name already exists, it asks before replacing, which is how you update a set after changing it.
If any part is outside the registered folders, the dialog tells you how many before you save.
Opening
Click Open set. The sets in the folder are listed, most recent first, each with its date. Pick one and the viewer rebuilds everything as it was.
If parts are open on screen, it asks before closing them. If a part cannot be found, it loads the others and names the missing ones, almost always because their folder is not registered yet.
Since the STLs and the sets live on your disk rather than on the server, changing hosting, clearing the browser or reinstalling Windows loses nothing. At worst you register the folders again, which takes seconds.
Positioning parts
Selecting a part opens the part panel in the sidebar. There, Offset (mm) and Rotation (degrees) in X, Y and Z accept typed values or the ±10 mm and ±90° buttons. Rotation is about the file origin, and everything is stored in the set. Reset puts the part back where it started.
Dragging on screen
Under Drag, choose Move for three arrows on the part (X red, Y green, Z blue) or Rotate for three arcs. Pull them with the mouse or a finger. The step next to it (free, 0.5 mm/5°, 1 mm/15°, 5 mm/45°, 10 mm/90°) sets the increment and is remembered. Off hides the handles. This gizmo is loaded from the internet with the page; offline it will not appear, but the numeric fields keep working.
Snap by points
For fine adjustment, click Snap by points, then a point on the selected part (a hole, a corner: the click snaps to the nearest vertex) and finally the target point, on any part. The part moves so the two points coincide.
Auto adjust
The most natural way to assemble: drag the part with the gizmo close to the opening of the other one, roughly aligned and slightly inserted, then click Auto adjust in the part panel (the field next to it says which part to adjust into, the nearest one by default). The viewer works out the opening and the axis from where you left the part, refines the turn by up to 25° and centres the part in the opening. The insertion depth stays as you left it; set it with the Z field or the gizmo. It takes under a second. If the part is too far away or crosswise, it says so; bring it closer or use Suggest fit, below.
Suggest fit
For plug and socket parts (a plug that enters an opening in a shell), the Suggest fit section of the Tools panel works out the position by itself: choose the plug, the shell and, optionally, how many millimetres should go in (blank means half the plug), then click Suggest. The viewer compares the plug outline with the openings on the six faces of the shell, tries every rotation and both directions, and places the plug in the best one, reporting the end, the turn and the similarity. It takes a second or two and uses the file coordinates (Assembly mode). If no opening fits, it says so; for face-to-face joints, use snap by points. The result is a suggestion to within a millimetre or so: check it and fine-tune with the gizmo or snap by points.
Opacity and export
The Opacity slider makes the part translucent, to see what is behind or inside. Export STL saves the part with its offset and rotation applied.
Measure, section, explode
Measure
With Measure on, click two points on the parts and the distance appears, with the ΔX, ΔY and ΔZ components in the Tools panel. A third point measures the angle at the second one. The labels stay pinned to the scene. Turning the button off hides the measurements and turning it on shows them again; Clear (or a fourth click) removes them for good.
Section
Section enables a cutting plane in X, Y or Z, chosen in the Tools panel, with a slider for its position and the ⇆ button to flip the cut side. Use it to see inside and check interference between assembled parts. The cut surface looks hollow, because an STL only describes the skin.
Explode
In the Tools panel, the Explode slider (0 to 200%) pushes the parts away from the centre of the assembly to show how they fit together. Back to zero for the normal assembly.
The Tools panel
The Tools button opens, in the bottom-right corner, the panel that gathers explode, section, measurement, printing, mesh analysis, G-code and the shortcut list.
Notes
With Note on, click a point on a part and type the text. The amber balloon stays pinned to that point, follows the part if it moves, and disappears while the part is hidden. Clicking the balloon edits the text; clearing the text removes the note. Notes are saved in the set, so they come back when you reopen it.
Printing
In the Printing section of the Tools panel you pick the printer (Creality K2 Pro 300 mm, K2 Plus 350 mm, K2 260 mm or a custom one with three dimensions) and the material (PLA, PETG, ABS, ASA, TPU, PA, PLA-CF, PETG-CF or other, with an editable density) plus the price per kilo. These choices are stored in the browser.
With that, the part panel shows volume, area, solid weight and cost, and warns when the part does not fit the printer; in the list, parts that do not fit get a ⚠ next to their dimensions. Check for printing checks every part at once and also tests whether the mesh is closed, reporting how many open edges there are when it is not, which is what makes slicers complain.
Export scene (STL) produces a single STL with all visible parts in their current position, ready for the slicer.
Mesh analysis
Overhangs
Overhangs paints the faces that would need support, from amber (at the threshold) to red (facing straight down). The threshold angle (default 45°, same as Creality Print) is adjustable. The face resting on the bed does not count, and the rotation you gave the part is taken into account: rotate the part and watch the support area change. The panel reports, per part, the cm² and the percentage of the surface that need support.
Thickness
Thickness measures the wall thickness at every triangle of the mesh and paints red what is below the minimum thickness (default 1.0 mm) and amber up to twice that. It reports the thinnest wall and the percentage of the surface below the minimum. This analysis uses a library loaded from the internet; offline it tells you so.
Compare versions
In the Compare versions section of the Tools panel, choose the old part as v1 and the new one as v2 (both must be open), set the tolerance (default 0.2 mm, which absorbs the small tessellation differences between exports) and click Compare. The viewer switches to Assembly mode so the two overlap in file coordinates, hides the other parts and paints: green what v2 has and v1 does not (added or moved), red what v1 had and v2 does not (removed), grey what is unchanged. v1 is shown translucent under v2. The panel summarises the changed areas, both volumes and the difference, and the bounding boxes. Close restores the colours and the hidden parts.
G-code
In the G-code section of the Tools panel, Open G-code draws the extrusion paths of a sliced file over the outline of the configured printer bed. The Layer slider shows the print up to the chosen layer, with its Z; you can also show travel moves and keep the parts in the scene alongside. The panel reports layers, height, metres of filament, estimated weight with the configured material and the time, when the file carries it. Close removes the G-code from the scene.
Augmented reality
On Android phones running Chrome, an AR button appears. Point the camera at a table or the floor, a cyan ring marks the spot, tap the screen and the parts appear there at real size, resting on the surface. Tap again to reposition; Exit returns to the viewer. Safari on the iPhone does not offer this capability, so the button does not show there.
Keyboard shortcuts
| Key | Action |
|---|---|
| 1 to 6 | Views: front, back, right, left, top, bottom |
| Space | Fit view |
| H | Hide or show the selected part |
| M | Toggle measuring |
| C | Toggle the section plane |
| Del | Remove the selected part from the scene |
| Esc | Leave measuring, note or snap-by-points mode |
On a phone
On a phone the viewer opens and displays parts, with rotation, pinch zoom and selection by touch. What changes is disk access, which the system does not allow: mirrored files and sets go to the Downloads folder.
To open a set on a phone, choose the .conjunto.json file and then open the STLs it asks for, with Open files (STL, 3MF, OBJ). The viewer applies the mirroring and the rest of the settings by itself, and keeps showing which parts are still missing.
The drag gizmo, measuring, notes and the section plane all work by touch. On Android with Chrome there is also the AR button, described above.
To keep the viewer at hand, use your browser's add to home screen option.
If something goes wrong
The folder buttons are missing
The browser is not Chrome or Edge, or the page was opened over http://. Folder access only exists on https://.
The browser asks for permission every time
When authorising, choose Allow on every visit. If you clear the site data, the registrations are lost and have to be made again.
A set cannot find its parts
Register the folder they are in under Part folders and open the set again. If files were renamed or moved outside the registered folders, open the parts by hand and save the set over the old one, with the same name.
Parts appear scattered or very far away
They were probably exported from different projects, with different origins. Use Centre each or Side by side, then Fit view.
The drag gizmo or the thickness analysis do not appear
Both depend on files loaded from the internet when the page opens. Check the connection and reload. The rest of the viewer works without them.
Open from URL fails
The server hosting the file must allow cross-site access (CORS). Dropbox links work; Google Drive links do not. Download the file and open it from disk.
A 3MF will not open
Unzipping is done by the browser and needs a recent Chrome, Edge or Safari. Export STL from the same program as an alternative.
I changed something on the site and nothing changed
Reload with Ctrl+F5 so the browser fetches the new version.