Skip to content

Commit 8015527

Browse files
committed
Updated docs
Signed-off-by: Cédric Foellmi <cedric@onekiloparsec.dev>
1 parent de1a1fd commit 8015527

1 file changed

Lines changed: 14 additions & 0 deletions

File tree

docs/webcam.md

Lines changed: 14 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -39,6 +39,20 @@ pip install 'arcsecond[webcam]'
3939

4040
:::
4141

42+
::: warning Windows users — use PowerShell, not WSL
43+
On Windows, the Arcsecond CLI **must be installed and run natively using
44+
PowerShell** (or the standard Windows Command Prompt). Do **not** use the Bash
45+
shell that comes with WSL (Windows Subsystem for Linux).
46+
47+
WSL runs in a virtualised Linux environment that does not have direct access to
48+
the host's USB devices. As a result, the webcam proxy cannot see cameras
49+
attached to the Windows machine when launched from inside WSL.
50+
51+
Install Python and the Arcsecond CLI with the native Windows Python installer
52+
(from [python.org](https://www.python.org/downloads/windows/)) and run all
53+
`arcsecond webcam` commands from a **PowerShell** or **cmd.exe** window.
54+
:::
55+
4256
## Detecting webcams
4357

4458
To scan for locally attached webcams:

0 commit comments

Comments
 (0)