Meshy for OrcaSlicer: Install and Use
Use Meshy inside OrcaSlicer: design images, turn images into 3D models, texture them, check and repair printability, make multi-color and split versions, and send the result into your current project. You can also upload your own model (a file, or an object on the plate) for a check, repair, texture or multi-color.
Requirements
- macOS or Windows.
- OrcaSlicer 2.5.0 or later. Plugins are new in 2.5; version 2.4 has no plugin support. Download it from the OrcaSlicer releases page.
- A Meshy Pro plan or higher. Everything the plugin does with Meshy, print checks included, needs it. A free account can sign in, but any action shows an upgrade prompt that links to the Meshy pricing page.
Install
Pick one of the two ways below. Do not install both, because the two copies conflict.
Option 1: Plugin Hub (recommended)
-
Open OrcaSlicer 2.5 and choose File → Plugins.
-
In the Plugins window, click Install plugin, search for Meshy, and install it.
-
Orca asks for the plugin's permissions. Approve all of them (what each one is for).
-
A Meshy tab appears at the top of the window. If it does not, restart OrcaSlicer once.
Plugins installed from the Hub show an update notice in the Plugins window. Updating is one click there.
Option 2: Install from a file
-
Download the zip from Meshy and unzip it. It contains
meshy_orcaslicer.pyand this guide. -
In OrcaSlicer, choose File → Plugins. In the Plugins window, click the small arrow next to Install plugin, choose Install local plugin, and select
meshy_orcaslicer.py.Only the
.pyfile is accepted, not the zip. -
Approve the permissions Orca asks for (what each one is for).
-
The Meshy tab appears at the top. If it does not, restart OrcaSlicer once.
Plugins installed from a file get no update notices. To update, download the new zip and install the new meshy_orcaslicer.py the same way.
Permissions
When the plugin loads, Orca asks for these permissions. Approve all of them, or the plugin cannot work.
| Permission | What it is for |
|---|---|
Network access to api.meshy.ai and assets.meshy.ai | Call Meshy, and download generated models and images. |
Local port 127.0.0.1:53247 | The plugin's own local server. It receives the sign-in callback from your browser, hands models to Orca for import, and serves the 3D preview of files you upload. It is reachable only from this computer. |
| Run programs |
macOS: /usr/bin/open … opens the sign-in and pricing pages in your browser, and opens orcaslicer://… to import a model into the current project.Windows: rundll32.exe url.dll,FileProtocolHandler … opens the sign-in and pricing pages in your browser, and opens orcaslicer://open?file=… links to import a model into OrcaSlicer.Both: /bin/mkdir (Windows: cmd.exe /d /c mkdir) creates Downloads/meshy-for-orcaslicer, and /usr/bin/open (Windows: explorer.exe) shows that folder or the cache folder.
|
Read and write files in Downloads/meshy-for-orcaslicer | Saves the copies you make with Save to Downloads. |
| Threading | Network requests run in the background, so Orca's window stays responsive. |
Sign in
-
In the Meshy tab, click Sign in with browser. Your browser opens meshy.ai.
-
The consent page names the app Meshy for OrcaSlicer. Sign in to Meshy if needed, then approve.
-
The browser shows a page saying you can return to OrcaSlicer. The plugin signs in on its own. There is no code to type.
The sign-in link expires after 10 minutes. If it does, click Sign in with browser again.
What you can do
The Meshy tab
The tab has three modes:
- Design: describe what you want, optionally add up to five reference images, and make an image. Choose from the GPT Image and Nano Banana image models.
- Generate: turn one image, or up to four views of the same object, into a 3D model with Meshy 7.1. Texturing uses Meshy N1 by default, which gives clean colors suited to printing. Choose Meshy 7 for finer detail.
- Upload: use your own
.glb,.stl,.objor.3mffile, or an object from the plate.
Each result keeps its versions as a model chain, with a 3D preview you can rotate. From a result you can:
- Check printability. It looks for watertightness, non-manifold edges, holes and thin walls. The check uses no credits. If it finds problems, Repair is offered.
- Texture or Retexture a model.
- Make a multi-color 3MF, matched to the filament count of your current printer.
- Split a model into parts you print separately and assemble.
- Send it into your project with Prepare to print. This also opens the Meshy panel in Prepare.
Every button that spends credits shows its cost. My creations lists your earlier images and models.
The Meshy panel
In Prepare and Preview, a docked Meshy panel sits beside the plater. It keeps everything on one page: Create (design an image or generate a model), My creations, and the Workbench, which works on one asset at a time, an object on the plate or a creation. Check, repair, color, split or texture it right there, and click Add to plate.
If you close the panel, reopen it with the panel button in the tab's left rail, or from Speed Dial (press Space) → Meshy Panel.
Good to know
- An imported STL that is too big for your printer's build volume is scaled down to fit (to about 80% of the volume).
- Meshy deletes results 3 days after they finish. The plugin saves each finished result on your computer, so it stays usable after that. Saved results and uploads are kept when you update the plugin. Removing a result from My creations also deletes its saved copy.
- The plugin follows Orca's light or dark theme and its interface language (19 languages).
Known limits
- Windows: OrcaSlicer opens an imported model in a new window unless only one instance is allowed. Turn on Preferences → Allow only one OrcaSlicer instance to import into the window you are working in.
- OrcaSlicer keeps a copy of each imported model in its download folder (
meshy_model.stl,meshy_model(1).stl, …). You can delete them. - Split works only on models generated by Meshy, not on uploaded models. It also needs the original result on Meshy, so it works within the 3 days after a model is generated.
- For multi-color, you choose the printer by brand. When you import the multi-color or split 3MF, Orca may switch the active printer, so check the printer after importing.
- An uploaded model stays on your computer. It is sent to Meshy only when you run a check, repair, texture or multi-color on it. A GLB or 3MF file can be up to 100 MB; an STL or OBJ file up to 1 GB, as long as the model it converts to is 100 MB or smaller.
- For an object on the plate, the painted colors are read from the
.3mffile it was opened from. If they cannot be read, you get a notice. Save the project as a.3mfand drop that file into the Meshy tab to keep the colors.
Send feedback
Please attach a screenshot and the debug.log file. The log contains no sign-in credentials. It is in the same place whether you installed from the Hub or from a file:
- macOS: in Finder, press ⇧⌘G and open
~/Library/Application Support/OrcaSlicer/orca_plugins/plugin_data/meshy-orcaslicer/. - Windows: open
%APPDATA%\OrcaSlicer\orca_plugins\plugin_data\meshy-orcaslicer\in File Explorer.