Laser projects

XCS thumbnails not showing? Why your file manager hides xTool designs

By Petros, who builds Meshory · Updated Sep 16, 2026 · 8 min read

A folder of xTool projects looks the same whatever is inside them: the app icon, over and over. The design is in there, and so is a small picture of it that xTool saved on the way out. Nothing in Explorer or Finder is asking for that picture. Here is why, what each platform can do about it today, and where every preview fix stops.

You buy a bundle of laser designs, unzip it, and get thirty files named like cat_coaster_v2_final.xcs. Finding the one you want means opening them in xTool one after another, and you will do it again next month, because there is still nothing to look at.

Why your file manager shows the xTool icon

A file manager draws a preview only for formats with a registered thumbnail handler: a small piece of software that knows how to turn that kind of file into a picture. Windows ships handlers for photos, videos and a short list of others, and none for .xcs. The xTool installer registers which app opens the file, not how to draw it. macOS works the same way through Quick Look.

What makes it feel like a bug is that the picture already exists. An .xcs file is a single JSON document holding your canvas, and xTool tucks a small PNG of the design inside it when you save. An .xs file, the format xTool Studio adopted in version 1.7, is a zip that holds the canvas in a few files and, in most projects, the same cover image. The preview is sitting right there, and nothing on the outside knows to look for it.

What works on macOS

A Quick Look extension adds the missing handler. MakersPreview, a small paid app on the Mac App Store, covers XCS alongside STL, OBJ, 3MF, GLB and Bambu's LAC. It draws thumbnails in Finder windows and a full preview when you press space. Its page lists .xcs and says nothing about .xs.

1. 1Install it from the Mac App Store and give macOS a moment to register the extension.
2. 2Open a folder of projects in Finder. Thumbnails render lazily, a screenful at a time.
3. 3If old icons stick around, quit Finder and reopen it so the cached icons are redrawn.

What works on Windows

Less. We searched for an Explorer thumbnail handler for .xcs and found none, and nothing fills the gap for laser projects the way stl-thumb does for 3D models. Explorer keeps showing the xTool icon however you arrange the folder.

That leaves an app that reads the files itself. Iron Vault is the closest one built only for laser work. It costs $19.99, runs on Windows 10 and 11, and indexes files where they sit, building previews for .xcs and LightBurn projects with search and a duplicate finder on top. Its page lists SVG, DXF, LightBurn, .xcs, PDF, AI and common image formats, but not .xs, and it says nothing about looking inside archives.

What xTool's own software does

If you never leave xTool, check Studio first. Version 1.8 added Local Space, which xTool describes as managing files "on your local disk directly in Studio", next to the cloud projects in My Space. The release notes stop there. They do not say whether Local Space draws thumbnails or reads subfolders, so try it on your own folders before you plan around it.

Creative Space itself stopped at V2.7 in June 2025, and machines launched after August 2025 run on Studio only. Studio 1.7 and later still open your old .xcs projects and can save them back out, while Studio 1.6 and earlier cannot open an .xs file at all.

If you only need to see one file

Sometimes the question is a single project: a design a friend sent, or one you bought before the laser arrived. You can look at it without xTool installed.

• XCStoSVG, a free web page, converts an .xcs project to SVG inside your browser, so the file stays on your computer. Its authors flag skewed shapes as the part most likely to come out wrong.
• Meshory's viewer opens .xcs and .xs projects full size with zoom and rotate, including a project still inside its ZIP.
• The SVG version, when the seller offers one, opens in far more programs than either xTool format.

Where preview fixes stop

A thumbnail handler only changes what the file manager draws. Four limits come with that:

• One computer at a time: an extension registers on the machine you installed it on. A laptop, a desktop and a shared drive mean three installs, on the platforms where an extension exists at all.
• The ZIP stays shut: bought designs arrive as archives, and a handler only draws files you have already unpacked.
• One format each: a laser folder is rarely only .xcs. There are SVGs and DXFs, the PNG the seller included, a readme, and now .xs files from Studio.
• Nothing to search: a preview answers what a file is. It cannot answer where the hexagon coaster went, which is the question you started with.

Viewing .xcs, .xs and SVG files in one place

The other route is an app that indexes your folders and draws everything itself, which is what Meshory does. Point it at the folders your designs already live in and it reads them in place. xTool projects get the cover xTool saved, or a thumbnail drawn from the design when a project has none, photos on the canvas and shapes in their layer colors included. Both .xcs and .xs count. In our test against 64 publicly shared .xcs projects, 61 came out with a thumbnail.

SVG cut files get the same treatment: a rendered thumbnail in the grid, and a full-size view when you open one. So do the JPGs and PNGs the seller packed in, the PDF instructions and the readme, which open in the app rather than pulling you out to another window. The format table lists what each one gets.

Archives are browsed like folders, so a ZIP, RAR, 7Z or TAR of designs shows its contents with a thumbnail each, and nothing is unpacked to disk to get there. Search covers names, folder paths and your own tags, including paths inside those archives, so typing coaster finds every coaster design, loose or still zipped. A project opens full size with zoom and rotate, and one button hands it to xTool when you want to edit it. xTool XCS & XS files covers the details, and what gets indexed covers the rest of the list.

It runs on macOS, Windows and Linux, and nothing leaves your machine: scanning, thumbnails and search all happen locally. When your laser designs share a drive with 3D print files, one library holds both, which is the case a laser-only gallery cannot cover.

Which fix suits you

On a Mac with a folder of .xcs files and nothing else, the Quick Look extension is the cheapest answer, and it makes Finder itself more useful. A preview handler runs out as your folders widen. It will not follow you to another machine or into a ZIP, and it never gives you the search you came for.