From 516448a69674b4879c296d72e4eebcc2e890c72f Mon Sep 17 00:00:00 2001 From: John Goerzen Date: Thu, 8 Aug 2024 17:06:32 -0500 Subject: [PATCH 1/2] Document USB issues in README.md --- README.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/README.md b/README.md index a50cb92c..ccdfb571 100644 --- a/README.md +++ b/README.md @@ -73,6 +73,13 @@ or on Arch with sudo pacman -S python-pipx ``` +You will also need the USB development libraries; on Ubuntu/Debian, install +with + +```bash +sudo apt-get --no-install-recommends install libusb-1.0-0 +``` + By default, users don't have permission to access generic USB devices, so you will need to add a rule. The first time you run `labelle`, it will give instructions about how to do this: From 9a251e2e594dbe06141d02a6ef6413ee8289a19b Mon Sep 17 00:00:00 2001 From: Ben Mares Date: Sat, 28 Sep 2024 16:30:22 +0000 Subject: [PATCH 2/2] Mention the actual error when libusb is missing --- README.md | 10 ++++++++-- 1 file changed, 8 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index ccdfb571..5df2fbdb 100644 --- a/README.md +++ b/README.md @@ -73,8 +73,14 @@ or on Arch with sudo pacman -S python-pipx ``` -You will also need the USB development libraries; on Ubuntu/Debian, install -with +In case the USB development libraries are not already installed, you may see an +error like + +```python +DeviceManagerError: Failed scanning devices: No backend available +``` + +To fix this, on Ubuntu/Debian, install with ```bash sudo apt-get --no-install-recommends install libusb-1.0-0