Skip to content

Commit 2b8f2be

Browse files
authored
Readme update (#17)
* Add useage documentation * Change the second default model * Update image paths
1 parent 8a403e1 commit 2b8f2be

File tree

9 files changed

+45
-10
lines changed

9 files changed

+45
-10
lines changed

README.md

Lines changed: 12 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -32,38 +32,42 @@ pip install jupyterlab_gather
3232

3333
1. Go to https://www.100ms.live/ and click `Try for Free` to get started.
3434

35-
![landing page](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/1_landing.png 'Landing')
35+
![landing page](./docs/images/1_landing.png 'Landing')
3636

3737
2. Login however you like.
3838

39-
![login page](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/2_login.png 'Login')
39+
![login page](./docs/images/2_login.png 'Login')
4040

4141
3. Select `Video Conferencing`.
4242

43-
![use case page](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/3_usecase.png 'Use Case')
43+
![use case page](./docs/images/3_usecase.png 'Use Case')
4444

4545
4. Go to the dashboard.
4646

47-
![role page](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/4_role.png 'Role')
47+
![role page](./docs/images/4_role.png 'Role')
4848

4949
5. Click on `Join` to see your room details.
5050

51-
![dashboard](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/5_dashboard.png 'Dashboard')
51+
![dashboard](./docs/images/5_dashboard.png 'Dashboard')
5252

5353
6. Copy the room code for whichever role you like. This code will be entered on the join form to gain access to the video conference room. Anyone with the code will be able to join the room.
5454

55-
![room code](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/6_roomcode.png 'Room Code')
55+
![room code](./docs/images/6_roomcode.png 'Room Code')
5656

5757
7. Start Gather from the JupyterLab start page.
5858

59-
![jupyter](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/7_jupyter.png 'Jupyter')
59+
![jupyter](./docs/images/7_jupyter.png 'Jupyter')
6060

6161
8. Enter the room code on the join form and click `Join`.
6262

63-
![gather join](https://github.com/gjmooney/jupyterlab-gather/blob/add_state_db/docs/images/8_gather.png 'Join Room')
63+
![gather join](./docs/images/8_gather.png 'Join Room')
6464

6565
9. And that's all! You're all set up!
6666

67+
## Usage
68+
69+
[Check here for usage instructions](./docs/usage.md)
70+
6771
## Uninstall
6872

6973
To remove the extension, execute:

docs/images/usage/1_preview.png

367 KB
Loading
283 KB
Loading

docs/images/usage/3_conference.png

223 KB
Loading

docs/images/usage/4_ar_duck.png

370 KB
Loading
383 KB
Loading

docs/images/usage/6_run_away.png

341 KB
Loading

docs/usage.md

Lines changed: 31 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,31 @@
1+
# jupyterlad_gather
2+
3+
[![Github Actions Status](https://github.com/QuantStack/jupyterlab-gather/workflows/Build/badge.svg)](https://github.com/QuantStack/jupyterlab-gather/actions/workflows/build.yml)[![Binder](https://mybinder.org/badge_logo.svg)](https://mybinder.org/v2/gh/QuantStack/jupyterlab-gather/main?urlpath=lab)
4+
5+
## Usage
6+
7+
### Starting AR Presentation mode
8+
9+
1. After entering your username and room code and clicking join, you'll be at the preview screen where you can join the call, go back to the previous form, or change the devices you're using.
10+
11+
![preview](./images/usage/1_preview.png 'Preview Screen')
12+
13+
2. Here is where you can select which camera and microphone you'd like to use for the call.
14+
15+
![device options](./images/usage/2_device_options.png 'Device Options')
16+
17+
3. After clicking join you'll be at the main conference screen. There is a control bar on the bottom of the screen with the normal options you'd expect from a video conference tool, with one extra item.
18+
19+
![conference](./images/usage/3_conference.png 'Conference')
20+
21+
4. This enables the augmented reality mode, allowing you to present GLTF models to the rest of the room. On the sides are several toolbars allowing you to customize the scene.
22+
23+
![its a duck](./images/usage/4_ar_duck.png 'Its a duck')
24+
25+
5. These toolbars allow you to load other models into the scene, currently up to two AR cubes are supported. You can also manipulate the scale of the model.
26+
27+
![toolbars](./images/usage/5_model_options.png 'Toolbars')
28+
29+
6. Be careful.
30+
31+
![careful](./images/usage/6_run_away.png 'Careful')

src/index.ts

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -83,8 +83,8 @@ const plugin: JupyterFrontEndPlugin<void> = {
8383
});
8484

8585
registry.registerModel({
86-
name: 'brain stem',
87-
url: 'https://github.khronos.org/glTF-Sample-Viewer-Release/assets/models/Models/BrainStem/glTF/BrainStem.gltf'
86+
name: 'fox',
87+
url: 'https://github.khronos.org/glTF-Sample-Viewer-Release/assets/models/Models/Fox/glTF/Fox.gltf'
8888
});
8989
}
9090
});

0 commit comments

Comments
 (0)