From 2571cff5f9251c5bbea993cdb15b9471fe17a2fe 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 Fixes #68 --- README.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/README.md b/README.md index a50cb92c..cbe55a6f 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: @@ -90,6 +97,16 @@ You do not have sufficient access to the device. You probably want to add the a +## 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 From 2dd0b4816fdfed09ae8f2745f63f40c1da55144a Mon Sep 17 00:00:00 2001 From: John Goerzen Date: Tue, 13 Aug 2024 21:31:12 -0500 Subject: [PATCH 2/2] Mention overflow error --- README.md | 5 +++-- 1 file changed, 3 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index cbe55a6f..664e8523 100644 --- a/README.md +++ b/README.md @@ -100,8 +100,9 @@ You do not have sufficient access to the device. You probably want to add the a ## 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: +maker, causing interference with Labelle. This commonly causes overflow errors. +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