App Manager

App Manager is an easy-to-use tool for creating and performing various operations with Verge3D applications.

Contents

Running App Manager

The App Manager is implemented as web pages shown by the locally-run web server, similar to WiFi router admin panel.

By default, the pages are served from the address localhost:8668, which you can navigate to, refresh or bookmark. The server can be launched in several ways (see below).

A. From Blender, 3ds Max or Maya

The local web server is started automatically when you launch your 3D tool with Verge3D plug-in installed. Upon clicking on the App Manager button (Blender) or menu option (Max, Maya), the App Manager page is shown in the web browser.

If the web server happens to be down for some reason (e.g. you closed the first launched instance of your 3D editor), this operator also restarts it.

B. Using Desktop Application

The local web server can be launched even without Blender, 3ds Max or Maya. Simply click on the desktop icon created by the Verge3D installer (Windows-only). The App Manager page will be immediately shown in the web browser.

If the web server is already running (e.g. you launched it from the 3D editor), this desktop application just opens the App Manager in the browser.

C. In Command-Line

Install Python 3, e.g. from Microsoft Store. Once you have Python 3 installed, launch Command Prompt and type:

cd verge3d

(or whatever path you installed Verge3D in), and then for Blender version type:

python manager\server.py BLENDER

for Max version type:

python manager\server.py MAX

or for Maya:

python manager\server.py MAYA

Finally, open up the browser and navigate to localhost:8668 as usual. Users of maxOS or Linux can use the same commands, only with forward slashes.

Exploring Applications

List on the Main Page

Upon starting or refreshing the main page, the App Manager scans the folder applications in the installation directory, and displays all found folders as a list. If External applications directory is specified in App Manager settings, the folders from inside that directory are also appended to the bottom of the list.

For each application in the list, the App Manager displays all .html, .gltf/.glb and 3D editor save files (.blend, .max, .ma/.mb) found in an application folder. These files can be viewed by clicking on their icons.

Application lines which contain too many files are expandable through the triangle icon near app name.

Applications can be filtered using the search field on the top.

Application Page

By clicking on the application name, a more elaborate page is shown.

On the application page, all files are listed with their names, also runnable. The files on this page are filterable via the search input.

Creating Applications

A new application can be created using the button on the left bar.

You may type a name for the new application, and select a template from which the app will be created. By default, 3 templates are offered: Standard Light/Dark and Code-Based. More templates can be added for choosing from.

You can also include optional modules in the application to enable Internet Explorer 11 support, add compatibility with the legacy WebVR API, or include the physics engine in the application.

Once a new application is created, there will be shown a link which you may use to go to the application page (or you may just close it).

The new app will start being displayed in the main list.

Operations

Edit Puzzles

You can start adding or editing Puzzles for an application by clicking the button in the 'operations' column on the main page:

... or by using the button on the right bar when on the application page:

See more information on Puzzles here.

Open Folder

You can open the application folder by clicking the button in the 'operations' column on the main page:

... or by using the button on the right bar when on the application page:

This operation will invoke the default file manager of your operating system (e.g. File Explorer on Windows 10).

Publish

You can publish an application by clicking the button in the 'operations' column on the main page:

... or by using the button on the right bar when on the application page:

This operation will start uploading the application to Verge3D Network (operation cancellable), so that it becomes available online.

If uploading fails with the message "The difference between your local system time and the server time is too large", then you should correct time on your computer and try again.

After uploading is complete, a window will be shown from which you can copy the link to your app or the embedding code.

You can also use social sharing buttons and QR code generator there.

Uploaded files can be inspected or removed on the Network Directory page.

Upload Archive

You can upload the zip archive of an application folder by using the button on the right bar when on the application page:

This operation will zip your application folder and will upload the archive to Verge3D Network (operation cancellable), so that it becomes available for sharing with your co-workers, clients or Verge3D developers.

If uploading fails with the message "The difference between your local system time and the server time is too large", then you should correct time on your computer and try again.

After uploading is complete, a window will be shown from which you can copy the link to the zip archive.

Uploaded files can be inspected or removed on the Network Directory page.

Update

If an application is based on an older version of Verge3D, a button for updating it becomes active in the 'operations' column on the main page:

The button will also appear on the right bar of the application page:

See more information on updating here.

Move to Trash

You can delete an application by clicking the button in the 'operations' column on the main page:

... or by using the button on the right bar when on the application page:

The application is moved to the system Trash from which it is possible to restore it.

Got Questions?

Feel free to ask on the forums!