Connect and Materials+

On this page 6 sections

Open Painter Connect is a small companion extension with code you can inspect. It signs in to openpainter.dev with a device code, asks which packs your account can access, and installs them as ordinary .openpaintmaterial files into Open Painter's library folder. The painter itself never talks to the network and never needs Connect; remove it and everything you installed keeps working.

Requirement
Blender	5.2 or newer
Open Painter	Installed and enabled
Account	A free account at openpainter.dev. Materials+ packs additionally need an active subscription; team libraries need membership.
Permissions	Network (sign in and download packs) and files (write into the library folder), both declared in the extension manifest

Install

Download open_painter_connect.zip from the download page.
In Blender, Edit › Preferences › Add-ons › Install from Disk… and pick the ZIP. Enable Open Painter Connect.
Open the sidebar (N) in the 3D Viewport or the Open Painter editor. The Materials+ panel is in the Painter tab.

If the panel says "Open Painter is not installed", install the painter first; Connect finds the core extension and its configured library directory automatically.

Click Sign in in the panel (or in Connect's preferences).
Connect shows a short code and opens openpainter.dev/device in your browser. If it does not open, click Open browser and enter the code by hand.
Sign in on the website if needed and approve the code. The panel updates on its own.

No password is ever typed into Blender. The resulting token is stored in Blender's config directory (open_painter_connect/auth.json, mode 0600), not in your preferences file, and can be revoked at any time from Account › Devices or with Sign out in Blender.

Sync, install and update

After sign-in Connect fetches the manifest of packs your account can access — Materials+ packs, free starter packs, and one team-<slug> pack per team you belong to — and compares versions and checksums with what is installed. Each pack shows one of these states:

State	Meaning
Not installed	Available to your account; click Install.
Installed	Up to date.
Update available	A newer version is published; click Update, or use the Update all button in the panel header.
Access ended	Your subscription or team membership no longer covers this pack. Installed files stay on disk; downloads and updates stop.
No longer offered	The pack was withdrawn from the catalog. Installed files stay.
Files missing	Files Connect installed were deleted or changed on disk. Reinstall to restore them.
Working / Failed	A download is in progress or the last one failed; the notice explains why.

Installs download over a short-lived signed link, verify every file against the SHA-256 in the pack manifest, and only extract materials/*.openpaintmaterial and previews/*.png. Files land in Open Painter's library folder under a name that includes the pack id, so packs never collide; Open library folder in the panel header shows where. Installed materials appear in Open Painter's Assets › Library like any material you saved yourself.

With Update installed packs automatically enabled (the default), Connect checks for new versions of packs you already installed every six hours while Blender is open. When the server is unreachable the panel shows the last known library and marks itself offline.

Remove and sign out

Remove deletes a pack's files — only files Connect installed itself and whose checksum still matches, tracked in connect_state.json in the library folder. Materials you saved or edited are never touched. Sign out removes the local token and revokes it on the server; installed files stay. Disabling and re-enabling the extension restores your sign-in and installed-pack state.

Preferences

Setting	Default	Purpose
Update installed packs automatically	On	Background version checks every few hours.
Show packs whose access ended	On	Keep expired packs visible in the panel.
Server	https://openpainter.dev	Change only for a self-hosted or staging platform.
Developer mode	Off	Verbose logging.

The preferences also show the signed-in email, the detected Open Painter version and the library path.

What Connect sends and stores

Sends: the device-code sign-in, manifest requests, and download requests, each with a OpenPainterConnect/<version> user agent. Nothing about your scenes or projects.
Stores: the token in Blender's config directory, a manifest cache, and an install-state file next to the materials.
Never: reads your .blend files, deletes files it did not install, or runs when Blender is closed.

Connect is GPL-3.0-or-later and pure Python; the source is in the platform repository's addon_connect/ directory. How the pieces fit together is on the Connect overview.