Skip to content

Commit 680a0c7

Browse files
committed
Document USB issues in README.md
Fixes #68
1 parent 0af2949 commit 680a0c7

File tree

1 file changed

+17
-0
lines changed

1 file changed

+17
-0
lines changed

README.md

+17
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,13 @@ or on Arch with
7373
sudo pacman -S python-pipx
7474
```
7575

76+
You will also need the USB development libraries; on Ubuntu/Debian, install
77+
with
78+
79+
```bash
80+
sudo apt-get --no-install-recommends install libusb1-dev
81+
```
82+
7683
By default, users don't have permission to access generic USB devices, so you will
7784
need to add a rule. The first time you run `labelle`, it will give instructions
7885
about how to do this:
@@ -90,6 +97,16 @@ You do not have sufficient access to the device. You probably want to add the a
9097

9198
<!-- markdownlint-enable MD013 -->
9299

100+
## Interference from CUPS
101+
102+
Sometimes, the CUPS printing system will attempt to communicate with the label
103+
maker, causing interference with Labelle. If you don't otherwise have a USB
104+
printer, you can disable CUPS attempting this with:
105+
106+
```bash
107+
sudo touch /etc/udev/rules.d/70-printers.rules
108+
```
109+
93110
## Testing experimental features
94111

95112
To install a test branch, by GitHub user `ghuser` for the branch `branchname`, run

0 commit comments

Comments
 (0)