Project
A Project is a folder on disk where you keep the assets used in your stream (sets, props, avatars, and live scenes) together. On the Project page of the Remote app, you open a single folder, and its contents appear in a list so you can load and manage them all in one place.
What Is a Project?
A project is a single folder on the file system. You can place the following kinds of files in it.
| Kind | File | Related page |
|---|---|---|
| Set | .set.lsb | Stage |
| Prop | .prop.lsb / .glb / .gltf | Props |
| Avatar | .vrm / .avatar.lsb | — |
| Live Scene | .live.json | Live Scenes |
When you open a project folder, the Studio app crawls the folder and registers the supported files in the list. At this point they are not loaded yet (unloaded state); you select the ones you need and load them to use them.
Opening a Project
Project operations are only available while connected to the Studio app. When not connected, it shows "Connect to a Studio to manage assets."
- From the three-dot menu at the top of the page, choose Open Project Folder.
- In the folder picker, select the folder that holds your assets.
- The path of the opened folder is shown under the Project Folder heading, and its contents appear in the list.
When you have not opened a folder yet, it shows "No project open."
Managing Assets
Operate on each asset from the list of the opened project.
- Load / Unload: Use the icon on each asset to toggle loading and removing. Props and sets can be loaded several at a time. Only one avatar is active at a time (radio selection).
- Edit details: Selecting an asset shows its details (property editor) in the pane on the right.
- Open a live scene: For a live scene item, choosing "open" switches to that live scene (it does not have a load/unload toggle).
- Rescan: If you add or remove files in the folder externally, use the Rescan button to re-scan the folder and refresh the list.
- Delete File: For now, only preset files (
.preset.json) can be deleted from the list via Delete File. Deleting removes them from disk permanently.
Relationship to Other Pages
When you open a project, the assets registered here are also fed to the Stage, Props, and Avatar pages.
- Project page … a single list that handles every kind together (the master view).
- Stage … the page that handles only sets (
.set.lsb). - Props … the page that handles only props (
.prop.lsb/.glb). - Avatar … the page that handles only avatars.
In other words, each dedicated page is a view filtered by kind of the assets in your project. As long as a project is open, you can pull the same materials from any of these pages.