Skip to content
hx-wPublic

About

Instant mobile 3D review for local PLY, STL, and OBJ meshes

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Repository files navigation

Blind: a terminal robot shares a wireframe duck for someone to inspect on a phone

Blind

From your terminal to a shared 3D view.

Release macOS and Linux License: MIT

Blind turns meshes, notes and diagnostics into a link you can open on a phone or desktop. An agent can create the scene from the CLI; a person can rotate, inspect, annotate and share what they see.

  • Rotate the model, inspect a section, or mark a detail directly on its surface.
  • Put Markdown, JSON, images and logs beside the geometry for context.
  • Share the view and its PNG. Original files stay on their source machine or object store.

Quick start

Install the latest release on macOS (Apple Silicon or Intel) or Linux x86_64:

curl -fsSL https://raw.githubusercontent.com/hx-w/blind/main/install.sh | sh

Start the server:

blind serve

In another terminal on the same machine, as the same user, register locally and share a small sample mesh:

blind join --local
curl -fsSLo demo.ply https://raw.githubusercontent.com/hx-w/blind/main/tests/fixtures/tetra.ply
blind share demo.ply --format json

Open viewer_url in your browser, or on a phone that can reach this machine. Use image_url for a PNG of the same view. Keep owner_url private. Replace demo.ply with your own PLY, STL, OBJ or PTS file.

Already using a team server? Follow Client registration instead. To host one, see team server setup.

Bring the context

blind share model.ply notes.md metrics.json --format json
blind share --config collection.json --format json

Documents open alongside the model. Collections keep several independent scenes under one link. See components and collection configuration for examples.

Links last seven days by default and depend on their original sources remaining available and unchanged. Sharing and link lifetime explains permanent links, reshares and source changes.

Documentation

I want to… Guide
Share files, label groups, script an agent or create collections CLI guide
Inspect, annotate, compare sections or use the viewer on a phone Viewer guide
Display Markdown, JSON, images, Mermaid/DOT, HTML or custom content Scene components
Set up a team server, connect machines, update or troubleshoot Client and Server
Read from S3-compatible storage or signed download domains Object storage
Extend Blind with Client or Server resolvers and URL-scoped components Plugins
Integrate with HTTP or understand saved scene state API · Sharing contract
Build, test or contribute Development · Architecture

Releases · Changelog · Security · MIT license

About

Instant mobile 3D review for local PLY, STL, and OBJ meshes

Topics

Resources

Contributing

Security policy

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages