# MaterialSnap desktop plugins — package 0.1.1

These plugins open the complete MaterialSnap studio in your default browser and add a native material-import command. They do not embed the studio inside the modeling viewport. Export a material ZIP in the studio, extract it to a permanent folder, then use Import Material and select BaseColor.png or BaseColor.jpg. The import command creates a material without changing existing objects. Assign it and set real-world scale in the host application.

## SketchUp
Open Extension Manager → Install Extension → choose MaterialSnap-SketchUp.rbz. Enable MaterialSnap. Use Extensions → MaterialSnap → Open studio / Import material.
Intended for SketchUp Desktop 2020 onward, Windows. Color textures work on older versions; normal and roughness use APIs available in 2025 onward. This unsigned development extension may be blocked by a restrictive extension-loading policy. It is not an Extension Warehouse release.

## Rhino
Close Rhino and double-click MaterialSnap-Rhino.rhi to invoke Rhino's installer. Start Rhino and use MaterialSnap or MaterialSnapImport. If Windows does not associate RHI files, rename a copy to .zip, extract it, and drag MaterialSnap.rhp into Rhino. Keep the adjacent Studio folder beside the RHP.
Built against Rhino 7. Intended for Rhino 7 and 8 on Windows; Rhino 6 is not supported by this PBR build. Native material import creates color, roughness and height/bump. Normal maps need renderer-specific setup.

## Revit
Extract MaterialSnap-Revit.zip. Close Revit. Double-click Install-Revit.cmd. It installs for the current Windows user; administrator access is not needed. Restart Revit. Open a project and find MaterialSnap in the Add-Ins ribbon. Revit may ask whether to load the unsigned development add-in.
Prebuilt DLLs are compiled against Revit 2020, 2024 and 2026. The installer builds versions 2021–2023 against each locally installed Revit API with the Windows C# compiler. Revit 2025 requires an installed .NET SDK 8 or newer to build against its own local API; if unavailable it is skipped with a message. This is not a claim of validated support for every Revit release. Revit 2027 and future versions are not included.
Revit import uses Generic appearance color and height/bump. It does not translate PBR normal/roughness into arbitrary renderer shaders.
Uninstall: remove MaterialSnap.addin from %APPDATA%/Autodesk/Revit/Addins/<year> while Revit is closed. Files remain under %LOCALAPPDATA%/MaterialSnap for recovery and can be removed manually afterward.

## Blender
Install MaterialSnap-Blender.zip as a legacy add-on from Preferences → Add-ons → Install (or Install from Disk in newer versions). Enable MaterialSnap. Find it in the 3D View sidebar under MaterialSnap. Intended for Blender 2.83 onward; not validated in each release. No Extension Platform manifest is included. Imports base color, normal and roughness nodes.

## Validation and limits
Compiled successfully against local Revit 2020/2024/2026 and Rhino 7 APIs. Revit 2026 compilation reports transitive Autodesk reference-version warnings; host load testing is still required. Plugin entry points and package structures were checked. None of the plugins has been loaded or exercised inside the target applications during this build. Treat these as installable development previews, not a certified cross-version release.

## Online studio update — 2026-10-01
Package 0.1.1 updates the bundled launcher for Revit, Rhino, SketchUp and Blender. Native importer binaries and host compatibility are unchanged. Choose Open online studio to use https://material-snap.com/ with the current library, favorites, projects, client search, sorting and material thumbnails. Cloud features require sign-in. Future website updates are automatically available through this link. Local preview remains available when the local server is running. Local saved collections are separate from cloud account data.

Reinstall the updated package to replace an existing local-only launcher. No host settings or user material files need to be deleted. Studio exports use MaterialSnap-<material name>-<target>.zip. Native importers accept extracted BaseColor.png / BaseColor.jpg and associated maps. Public-library and cloud-project packages preserve other filenames; use manual map assignment for these packages. This release does not add native cloud synchronization or project sharing.


## Revit Finish metadata — 0.1.3
Select MaterialSnap-Finish.xml from an extracted saved-material or project export (Use as Finish, Pro / Team). Select its texture when prompted. Assign the created material to model elements and add MS_ fields to a Material Takeoff. Parameter binding and actual schedule values verified in Revit 2024; 2020 and 2026 compilation only. Room Finish assignments are not automatic. See FINISH-PARAMETERS.md in the Revit package.


## Updates — 0.2.0 (Windows)
Opening Studio checks the release manifest. If a newer version exists, accept the prompt to download and verify it. Close the host normally; a separate updater installs files and reports completion. Do not reopen until completion. Installation failures restore replaced files. Old plugin versions require one manual install of 0.2.0. Automatic Revit updates cover prebuilt 2020/2024/2026; use the installer for other years. Offline checks do not change the installed plugin. The updater has isolated install/rollback tests; a complete update cycle inside all four hosts has not been validated.


## Texture filenames — 0.2.1
Generated maps use MS_MaterialName_MapType for Free and for paid materials without a finish code. Saved paid materials with an enabled finish code use FinishCode_MaterialName_MapType. Importers accept prefixed BaseColor images and match companion maps with the same prefix; original unprefixed packages remain supported. Original source archives retain their original filenames.
