Right-click a 3D file, or a zip with a model and its textures, and convert it to another 3D format, or preview it.
Works in Windows Explorer, macOS Finder, KDE Dolphin and GNOME Files. Free, open source, and everything happens on your own computer.
Website, downloads and docs: https://srlegrand.github.io/convert3d/
| Format | Needs |
|---|---|
| fbx, glb, gltf, obj, abc, usd, usda, usdc, usdz, blend, stl, ply | Blender 4.2+ |
| dae, 3ds, x, 3mf, x3d (and ~35 more read-only: lwo, ase, ms3d, md2, md3, ifc, off, smd…) | Assimp |
| ma, mb | Maya or Aztek |
| max | 3ds Max (Windows only) |
Blender is required. The rest are optional. Any format can be converted to any other if the tools for both are installed.
| System | Download | Then |
|---|---|---|
| Windows | Convert3D-Setup.exe | Run it. No admin rights needed. It offers to install Blender. |
| macOS | Convert3D-macOS.pkg | Right-click the file and choose Open. |
| Linux | Convert3D-x86_64.AppImage | Make it executable, double-click it, then reopen your file manager. |
Or from a terminal on macOS and Linux (x86_64 and ARM), for your user only:
curl -fsSL https://raw.githubusercontent.com/srlegrand/convert3d/main/install.sh | shconvert3d needs Blender 4.2 or newer:
winget install BlenderFoundation.Blender, brew install --cask blender, or sudo snap install blender --classic.
Assimp is optional: brew install assimp, sudo apt install assimp-utils or sudo dnf install assimp.
The installers are not code-signed, so Windows SmartScreen ("More info" > "Run anyway") and macOS Gatekeeper (right-click > Open, or System Settings > Privacy & Security > "Open Anyway") ask for confirmation the first time.
Right-click a 3D file, or a zip:
- Windows - Convert 3D to or Preview 3D (on Windows 11 under Show more options, or Shift + right-click)
- macOS - Quick Actions → Convert 3D… and pick a format, or Preview 3D
- Linux - Convert 3D to or Preview 3D in Dolphin, under Scripts in GNOME Files
Options, at the bottom of the Convert 3D to menu (on macOS the Convert 3D Options Quick Action), chooses where converted files are saved, what happens when the name is taken, and which application reads or writes each format.
On macOS, if the Quick Actions don't appear: System Settings → General → Login Items & Extensions → Finder, and turn on Convert 3D… and Preview 3D.
Flatpak Blender isn't detected automatically. Point convert3d at it: convert3d set-tool blender /path/to/blender.
Needs Rust.
cargo install --git https://github.com/srlegrand/convert3d
convert3d installIf you install Assimp, Maya or 3ds Max later, run convert3d install again to add their formats to the menu.
The command is convert3d on Linux (linked in ~/.local/bin) and after the macOS package,
%LOCALAPPDATA%\convert3d\bin\convert3d.exe on Windows, and
~/Library/Application Support/convert3d/bin/convert3d after the macOS terminal install.
Check what was found:
convert3d doctorIf a tool is installed somewhere unusual:
convert3d set-tool blender "/path/to/blender"
convert3d set-tool assimp "/path/to/assimp"
convert3d set-tool mayapy "/path/to/mayapy"
convert3d set-tool 3dsmax "C:\Program Files\Autodesk\3ds Max 2026\3dsmaxbatch.exe"- Windows - Settings > Apps > Installed apps > Convert 3D > Uninstall
- macOS -
convert3d uninstall, thensudo rm /usr/local/bin/convert3dif you used the package - Linux - double-click the AppImage again and choose Remove, or run
convert3d uninstall
This removes the menus, the thumbnailer and convert3d's copy of itself.
chair.fbx→chair.glb, in the same folder.- Formats with separate texture files (obj, gltf, usda, dae…) go into a folder:
chair_obj/. - If the input was a zip, multi-file results are zipped:
chair_obj.zip. - Nothing is overwritten. An existing file gets
chair_(2).glb, thenchair_(3).glb.chair (2)is the same file aschair.
Preview 3D opens the model in your web browser: drag to orbit, right-drag to pan, scroll to zoom. It shows
triangle, material and texture counts and the model's size, plays animations, and has wireframe, grid and
background toggles. The page works offline. A .glb opens instantly; other formats are converted with
Blender first, which takes a few seconds. The last 20 preview pages are kept in the cache folder.
On Linux, convert3d install also adds a thumbnailer, so file managers that support freedesktop thumbnailers
show the model as its icon: KDE Plasma 6 Dolphin, Thunar, Nemo and Caja. Each thumbnail is rendered by Blender
and takes a couple of seconds the first time. The file manager caches it after that.
- KDE Plasma 5 and GNOME Files don't show them. Plasma 5 doesn't read thumbnailer files. GNOME runs thumbnailers in a sandbox that can't reach Blender.
- In Dolphin, check that previews are turned on, and that the file size limit in Settings → Interface → Previews isn't below your model sizes.
- macOS Finder and Windows Explorer have no thumbnails from convert3d. Finder's Quick Look (space bar) already
previews
.usdz,.usd,.obj,.stl,.plyand.abc.
Make one by hand:
convert3d thumbnail --size 512 chair.fbx chair.pngThe zip is searched for a model (FBX first, then glTF, USD, Alembic, OBJ…). Texture paths that point
somewhere that no longer exists, such as C:\Users\someone\textures\wood.png, are fixed by finding a file with the same
name in the zip.
convert3d convert --to glb chair.fbx table.obj props.zip
convert3d convert --to usdz --out-dir ./usd *.fbx
convert3d formats
convert3d view chair.fbx # open a preview in the browser
convert3d view --no-open chair.fbx # just print the preview page's path.maxneeds 3ds Max, which is Windows only..ma/.mbneed Maya or Aztek.- Alembic, STL and PLY have no materials, so textures are dropped when converting to them.
When a conversion fails, the error dialog shows the end of the log. Full logs are in the folder shown by
convert3d doctor.
Every push to main is built and tested by GitHub Actions and, if everything passes,
published as a new release with the next patch version (v0.1.0 -> v0.1.1). The download
links above always point at the latest release, so they need no updating.
To start a new minor or major version, push a tag yourself:
git tag v0.2.0 && git push origin v0.2.0
| Path | What |
|---|---|
src/, scripts/ |
the program (Rust) and the scripts it runs inside Blender, Maya, 3ds Max and Aztek |
viewer/ |
the preview page; npm run build rebuilds viewer/dist |
packaging/ |
installer definitions (Inno Setup, macOS package, AppImage) |
install.sh |
the terminal installer for macOS and Linux |
tests/ |
smoke test run against a real Blender by CI |
docs/ |
the website (GitHub Pages) |