Skip to content

Commit cc3660e

Browse files
committed
test commit for image size
test commit for image size test commit for image size test commit for image size test commit for image size test commit for image size
1 parent 2cf9972 commit cc3660e

File tree

2 files changed

+52
-29
lines changed

2 files changed

+52
-29
lines changed

getting-started/welcome-to-openadapt/developer-guide.md

+26-26
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
description: Working with OpenAdapt
33
---
44

5-
# Developer Guide
6-
75
{% hint style="info" %}
86
**Experiencing difficulty? Get support on our** [**Discord**](https://discord.gg/QKPuDqhDHF)**.**
97
{% endhint %}
@@ -64,13 +62,13 @@ alembic upgrade head
6462
{% tab title="Scripted Installation" %}
6563
[Download](https://openadapt.ai/#start)
6664

67-
# Windows:
65+
## Windows:
6866

6967
- Press Windows Key, type "powershell", and press Enter
7068
- Copy and paste the following command into the terminal, and press Enter (If Prompted for `User Account Control`, click 'Yes'):
7169
- `Start-Process powershell -Verb RunAs -ArgumentList '-NoExit', '-ExecutionPolicy', 'Bypass', '-Command', "iwr -UseBasicParsing -Uri 'https://raw.githubusercontent.com/OpenAdaptAI/OpenAdapt/main/install/install_openadapt.ps1' | Invoke-Expression"`
7270

73-
# MacOS:
71+
## MacOS:
7472

7573
- Download and install Git and Python 3.10
7674
- Press Command+Space, type "terminal", and press Enter
@@ -80,7 +78,7 @@ alembic upgrade head
8078
{% endtab %}
8179
{% endtabs %}
8280

83-
# Permissions(IMPORTANT)
81+
## Permissions(IMPORTANT)
8482

8583
See how to set up system permissions on macOS [here](https://github.com/OpenAdaptAI/OpenAdapt/blob/main/permissions_in_macOS.md).
8684

@@ -89,9 +87,9 @@ See how to set up system permissions on macOS [here](https://github.com/OpenAdap
8987
`pytest` to verify that the installation was successful.
9088
{% endhint %}
9189

92-
## Usage
90+
# Usage
9391

94-
# Shell
92+
## Shell
9593

9694
Run this in every new terminal window once (while inside the `OpenAdapt` root directory) before running any `openadapt` commands below. This is required to activate the pythom environment:
9795

@@ -108,20 +106,21 @@ Using python3.10 (3.10.13)
108106

109107
Notice the environment prefix `(openadapt-py3.10)`.
110108

111-
![image](./assets/poetry-shell.png)
109+
<img width="100%" src="./assets/poetry-shell.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
112110

113-
# Run app locally for testing
111+
## Run app locally for testing
114112

115113
`python -m openadapt.entrypoint`
116114

117115
CLI would look something like this after the command
118-
![image](./assets/developer-run-local.png)
116+
117+
<img width="100%" src="./assets/developer-run-local.png.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
119118

120119
After it runs successfully, you will see an app tray at top right of screen
121120

122-
![image](./assets/app-tray.png)
121+
<img width="100%" src="./assets/app-tray.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
123122

124-
# Make your first recording
123+
## Make your first recording
125124

126125
{% hint style="info" %}
127126

@@ -133,7 +132,7 @@ To make your first recording, try the following command:
133132
python -m openadapt.record "testing out openadapt"
134133
```
135134

136-
![image](./assets/start-recording-commad.png)
135+
<img width="100%" src="./assets/start-recording-commad.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
137136

138137
Wait until all three event writers have started:
139138

@@ -143,7 +142,7 @@ Wait until all three event writers have started:
143142
| INFO | __mp_main__:write_events:230 - event_type='window' starting
144143
```
145144

146-
![image](./assets/post-recording-start.png)
145+
<img width="100%" src="./assets/post-recording-start.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
147146

148147
To stop recording, focus the terminal and send **CTRL+C (SIGINT)**. The recording is finished saving when you see something like this:
149148

@@ -158,30 +157,31 @@ To stop recording, focus the terminal and send **CTRL+C (SIGINT)**. The recordin
158157
| INFO | __mp_main__:performance_stats_writer:433 - performance stats writer done
159158
```
160159

161-
![image](./assets/recording-saved.png)
160+
<img width="100%" src="./assets/recording-saved.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
162161

163162
Current limitations:
164163

165164
- Recording should be short (i.e. under a minute), as they are somewhat memory intensive, and there is currently an [open issue](https://github.com/OpenAdaptAI/OpenAdapt/issues/5) describing a possible memory leak.
166165
- The only touchpad and trackpad gestures currently supported are pointing the cursor and left or right clicking, as described in this [open issue](https://github.com/OpenAdaptAI/OpenAdapt/issues/145)
167166

168-
# Visualize
167+
## Visualize
169168

170169
- Quickly visualize the latest recording you created by running the following command:
171170

172171
`python -m openadapt.visualize`
173172

174173
This will generate an HTML file and open a tab in your browser that looks something like this:
175174

176-
![image](./assets/visualize-1.png)
175+
<img width="100%" src="./assets/visualize-1.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
177176

178177
- For a more powerful dashboard, run:
179178

180179
`python -m openadapt.app.dashboard.run`
181180

182-
![image](./assets/visualize-2.png)
181+
<img width="100%" src="./assets/visualize-2.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
182+
183183

184-
![image](./assets/visualize-2-1.png)
184+
<img width="100%" src="./assets/visualize-2-1.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
185185

186186
- For a desktop app-based visualization, run:
187187

@@ -191,9 +191,9 @@ Read more on [openadapt.visualize](../../reference/api-reference/openadapt-modul
191191

192192
This will open a scrollable window that looks something like this:
193193

194-
![image](./assets/visualize-3.png)
194+
<img width="100%" src="./assets/visualize-3.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
195195

196-
# Playback
196+
## Playback
197197

198198
You can play back the recording using the following command:
199199

@@ -213,14 +213,14 @@ e.g.: `python -m openadapt.replay VanillaReplayStrategy --instructions "calculat
213213

214214
See [strategy list](https://github.com/OpenAdaptAI/OpenAdapt/tree/main/openadapt/strategies) for a complete list. More ReplayStrategies coming soon!
215215

216-
## Features
216+
# Features
217217

218-
# System Tray Icon and Client GUI App(work-in-progress)
218+
## System Tray Icon and Client GUI App(work-in-progress)
219219

220220
`python3 -m openadapt.start`
221221

222-
![image](./assets/client.png)
222+
<img width="100%" src="./assets/client.png" class="r-z2wwpe r-dnmrzs" height="auto"/>
223223

224-
# Detailed performance monitoring via [pympler](https://pympler.readthedocs.io/en/latest/) and [tracemalloc](https://docs.python.org/3/library/tracemalloc.html):
224+
## Detailed performance monitoring via [pympler](https://pympler.readthedocs.io/en/latest/) and [tracemalloc](https://docs.python.org/3/library/tracemalloc.html):
225225

226-
![image](./assets/visualize-3.png)
226+
<img width="100%" src="./assets/visualize-3.png" class="r-z2wwpe r-dnmrzs" height="auto"/>

getting-started/welcome-to-openadapt/user-guide.md

+26-3
Original file line numberDiff line numberDiff line change
@@ -2,8 +2,6 @@
22
description: Installing OpenAdapt
33
---
44

5-
# User Guide
6-
75
{% hint style="info" %}
86
**Experiencing difficulty? Get support on our** [**Discord**](https://discord.gg/QKPuDqhDHF)**.**
97
{% endhint %}
@@ -20,11 +18,17 @@ We have builds available for Windows and Mac
2018
{% endhint %}
2119

2220
- Download the OpenAdapt application from [here](https://openadapt.ai/#start)
21+
2322
![image](./assets/download-page.png)
23+
2424
- Extract the zip
25+
2526
![image](./assets/downloaded-zip.png)
27+
2628
- Click on the extracted application
29+
2730
- It creates an app-tray on top right. This app tray can be used to control the application.
31+
2832
![image](./assets/app-tray.png)
2933

3034

@@ -33,8 +37,11 @@ We have builds available for Windows and Mac
3337
Now after the application is installed, you can start recording following the steps explained.
3438

3539
- Click the record button in the app-tray
40+
3641
- It opens up a prompt to name your recording
42+
3743
![image](./assets/record-prompt.png)
44+
3845
- Give it a name and click ok. Now the recording starts.
3946

4047

@@ -43,6 +50,7 @@ Now after the application is installed, you can start recording following the st
4350
To end the recording you can simply
4451

4552
- Click the stop recording button in the app-tray and the recording is saved.
53+
4654
![image](./assets/stop-recording.png)
4755

4856

@@ -51,7 +59,9 @@ To end the recording you can simply
5159
To replay the saved recordings
5260

5361
- Click on replay in the app-tray. It opens list of all the recordings.
62+
5463
![image](./assets/replay-list.png)
64+
5565
- Click on the recording you want to replay. This will open up a prompt to choose the **replay strategy** & **replay instructions**
5666

5767
![image](./assets/replay-strategy-prompt.png)
@@ -68,9 +78,13 @@ To replay the saved recordings
6878
You can visualize data about your recording events too.
6979

7080
- Click on visualize in the app-tray
81+
7182
- Choose the recording you want to visualize
83+
7284
![image](./assets/visualize-list.png)
85+
7386
- It opens an HTML page with extensive details about the events in your recordings
87+
7488
![image](./assets/visualize-userapp-1.png)
7589

7690

@@ -79,7 +93,9 @@ You can visualize data about your recording events too.
7993
If you want to delete any recording from OpenAdapt, you can do it easily.
8094

8195
- Click on delete button in app-tray
96+
8297
- A list of available recordings appear
98+
8399
- Choose the recording to delete
84100

85101

@@ -88,18 +104,25 @@ If you want to delete any recording from OpenAdapt, you can do it easily.
88104
You can now control OpenAdapt from the GUI recently introduced. You can easily see all the **recordings**, **get recording data**, **change setting such as API keys**, choose to **scrubb a recording**, **replays** etc
89105

90106
- Click on dashboard in the app-tray
107+
91108
- A GUI opens on your browser similar to this
109+
92110
![image](./assets/dashboard.png)
111+
93112
- On settings page you can change API keys, turn on scrub etc
113+
94114
![image](./assets/dashboard-settings.png)
95115

96116

97-
# Scrubbing
117+
## Scrubbing
98118

99119
You can now scrub a recording of your choice and it gets processed.
100120

101121
- In the dashboard settings, turn on scrubbing.
122+
102123
- Navigate to scrubbing and choose a recording to scrub. Choose the provider
124+
103125
- Now wait for the recording to be processed
126+
104127
![image](./assets/scrubbing-processing.png)
105128

0 commit comments

Comments
 (0)