clara-rhino

For Windows users:

1. Ensure that Rhino is installed, or install from here: https://www.rhino3d.com/download/rhino/5.0/evaluation

2. Open command line (Cmd): Tap the Search button on the taskbar, type cmd in the search box and choose Command Prompt on the top.

3. Node.js version 8 or greater must be installed. In cmd, type "node -v". The version 8.. and up is required. If node is not found, or version is less than 8, Download and and folllow the instructions here: https://nodejs.org/en/download/

4. Install clara-rhino: npm install --global clara-rhino. Type clara-rhino -V to confirm.

5. Find your clara username and api token: https://clara.io/settings/api -- and add your authentication info to clara-rhino:

clara-rhino username your-username
clara-rhino apiToken your-api-token

6. Run this app. From Cmd, type:

clara-rhino go "path"

Where "path" is a .3dm file or directory of .3dm files. Multiple paths can be specified.

This will convert your files to fbx format, and import those files into clara scenes.

Note: (1). all the converted .fbx files will be saved in an fbxFiles folder from the directory you ran the command from.

(2). In case there is any special charactors in the path like white space or &, all path you entered should be qouted by double qoute. For example clara-rhino go "path1" "path2".

(3). Default visibility of scenes is unlisted. You can use --visibility option to change it. Only public, private, unlisted and gallery are allowed.

For example: clara-rhino go "path" --visibility private

(4). Default collection is "All". Specific collection can be specified by using option:

-c "collectionId"

For example: clara-rhino go "path" -c "your collection id"

(5). If you want to replace existed scenes have same names as imported files, you can use --replace option to remove all previous existed scenes with same names.

For example: clara-rhino go "path" --replace

*** For getting collection id: a. In clara.io/scenes page, right click 'All' or click the plus symbol then click "New Collection"

b. Enter the name that you like and click "Save"

c. In clara.io/scenes page, click the collection you just created. Collection id is part of the url of this page as "collection".

d. Use the this collection id as the value of option "-c" to specify the collection when uploading files.