Skip to content

Commit

Permalink
Document USB issues in README.md
Browse files Browse the repository at this point in the history
Fixes #68
  • Loading branch information
jgoerzen committed Aug 9, 2024
1 parent 0af2949 commit 680a0c7
Showing 1 changed file with 17 additions and 0 deletions.
17 changes: 17 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 libusb1-dev
```

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:
Expand All @@ -90,6 +97,16 @@ You do not have sufficient access to the device. You probably want to add the a

<!-- markdownlint-enable MD013 -->

## Interference from CUPS

Sometimes, the CUPS printing system will attempt to communicate with the label
maker, causing interference with Labelle. If you don't otherwise have a USB
printer, you can disable CUPS attempting this with:

```bash
sudo touch /etc/udev/rules.d/70-printers.rules
```

## Testing experimental features

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

0 comments on commit 680a0c7

Please sign in to comment.