Skip to content

Commit b6dcee4

Browse files
committed
Merge branch 'develop'
2 parents 699e0de + 0030624 commit b6dcee4

File tree

3 files changed

+26
-4
lines changed

3 files changed

+26
-4
lines changed

.gfx/permissions.png

64.7 KB
Loading

.gfx/sponsors/mighty.svg

Lines changed: 1 addition & 0 deletions
Loading

README.md

Lines changed: 25 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,14 @@
1010

1111
[![Downloads per month](https://img.shields.io/npm/dm/@nut-tree/nut-js)](https://www.npmjs.com/package/@nut-tree/nut-js)
1212

13+
<p align="center">
14+
Please visit
15+
</p>
1316
<h1 align="center"><a href="https://nutjs.dev">nutjs.dev</a></h1>
14-
1517
<p align="center">
16-
Native UI testing / automation with Node.js
18+
for detailed documentation and tutorials
1719
</p>
20+
1821
<br/>
1922

2023
# About
@@ -38,6 +41,11 @@ A huge **"Thank you!"** goes out to all sponsors who make open source a bit more
3841
[<img src="https://avatars.githubusercontent.com/u/1794527?v=4" width="75" alt="Chet Corcos" />](https://github.com/ccorcos)
3942
[<img src="https://avatars.githubusercontent.com/u/562800?v=4" width="75" alt="Stephan Petzl" />](https://github.com/stoefln)
4043

44+
<hr/>
45+
46+
[<img src="https://github.com/nut-tree/nut.js/raw/develop/.gfx/sponsors/mighty.svg" height="75" alt="Mighty browser logo"/>](https://www.mightyapp.com)
47+
48+
4149
# Demo
4250

4351
Check out this demo video to get a first impression of what nut.js is capable of.
@@ -141,6 +149,8 @@ This section lists runtime requirements for `nut.js` on the respective target pl
141149

142150
In order to install `nut.js` on Windows, please make sure to have the [Microsoft Visual C++ Redistributable](https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads) installed.
143151

152+
In case you're running Windows 10 N, please make sure to have the [Media Feature Pack](https://support.microsoft.com/en-us/topic/media-feature-pack-for-windows-10-n-may-2020-ebbdf559-b84c-0fc2-bd51-e23c9f6a4439) installed as well.
153+
144154
#### macOS
145155

146156
On macOS, Xcode command line tools are required.
@@ -154,10 +164,21 @@ xcode-select --install
154164
In case you're experiencing problems like your mouse not moving or your keyboard not typing,
155165
please make sure to give the process you're executing your tests with accessibility permissions.
156166

157-
If an application wants to use accessibility features, a permission pop-up should be shown.
167+
nut.js will give you a subtle hint in case permissions are lacking:
168+
169+
`##### WARNING! The application running this script is not a trusted process! Please visit https://github.com/nut-tree/nut.js#macos #####`
170+
171+
When an application wants to use accessibility features, a permission pop-up should be shown.
158172
If not, you could try to manually add the application you're running the script from.
159173

160-
`Settings -> Security & Privacy -> Privacy -> Accessibility -> Add...`
174+
`Settings -> Security & Privacy -> Privacy tab -> Accessibility -> Add...`
175+
176+
For example, if you want to execute your node script in e.g. `iTerm2`, you'd have to add `iTerm.app` to the list.
177+
When running your script from a built-in terminal in e.g. `VSCode` or `IntelliJ`, you'd have to add the respective IDE.
178+
179+
<p align="center">
180+
<img src="https://github.com/nut-tree/nut.js/raw/develop/.gfx/permissions.png" alt="accessibility permissions screen"/>
181+
</p>
161182

162183
#### Linux
163184

0 commit comments

Comments
 (0)