Labelle

开源标签打印软件

• 第一个版本由Sebastian Bronner创建：https://sbronner.com/dymoprint.html
• 克隆到Github并由@computerlyrik和@maresb维护： https://github.com/computerlyrik/dymoprint
• 迁移到labelle-org并由@tomers、@maresb和@tomek-szczesny维护： https://github.com/labelle-org/labelle

功能

• 文本打印
• QR码打印
• 条形码打印
• 图像打印
• 上述功能的组合
• 基于PyQt6的GUI应用程序
• 通过使用Zadig将驱动程序设置为WinUSB以支持Windows

支持的设备

• DYMO LabelManager PC
• DYMO LabelPoint 350
• DYMO LabelManager 280
• DYMO LabelManager 420P
• DYMO LabelManager Wireless PnP

Labelle 与 DYMO 没有合作关系。请参阅下方的 免责声明。

有关实验设备支持的更多信息，请参阅 #4。

如果您有一款我们尚未支持的设备或胶带尺寸，第一步是尝试让它打印。在某些情况下，这只需要 添加设备ID。一旦您可以打印，您可以按照 这些说明 来帮助我们确定您的胶带尺寸的打印头大小和边距。

安装

建议使用 pipx 安装 Labelle，以便它在隔离的虚拟环境中运行。

pipx install labelle

如果 pipx 尚未安装，您可以在 Ubuntu/Debian 上使用以下命令进行安装：

sudo apt-get install pipx

或者在 Arch 上使用：

sudo pacman -S python-pipx

如果 USB 开发库尚未安装，您可能会看到类似以下错误：

DeviceManagerError: Failed scanning devices: No backend available

要修复此问题，在 Ubuntu/Debian 上，使用以下命令安装：

sudo apt-get  --no-install-recommends install libusb-1.0-0

默认情况下，用户没有权限访问通用 USB 设备，因此您需要添加一条规则。第一次运行 labelle 时，它会提供如何操作的说明。

$ labelle "Hello world"
...
You do not have sufficient access to the device. You probably want to add the a udev rule in /etc/udev/rules.d with the following command:

  echo 'ACTION=="add", SUBSYSTEMS=="usb", ATTRS{idVendor}=="0922", ATTRS{idProduct}=="1001", MODE="0666"' | sudo tee /etc/udev/rules.d/91-labelle-1001.rules
...

测试实验功能

要安装由 GitHub 用户 ghuser 为 branchname 分支创建的测试分支，请运行

pipx install --force git+https://github.com/ghuser/labelle@branchname

要恢复到发布版本，请运行

pipx install --force labelle

要安装特定的发布版本，在上述命令中将 labelle 替换为 labelle==x.y.z。

开发和代码风格

要安装开发版本，请fork并克隆此存储库，并在（理想情况下在 venv 中）运行

pip install --editable .

此项目使用 pre-commit 在提交之前运行一些检查。安装完 pre-commit 可执行文件后，请运行

pre-commit install

字体管理

默认字体通过 labelle.ini 管理。这应该放在您的配置文件夹中（通常是 ~/.config）。这里提供了一个示例文件。

对于我的 Arch-Linux 系统，字体位于例如：

/usr/share/fonts/TTF/DejaVuSerif.ttf

您还可以从 http://font.ubuntu.com/ 下载字体并使用它。

对于字体发现，Labelle 包含来自 matplotlib 的代码片段。有关更多信息，请参阅 此处，有关许可证，请参阅 LICENSE。

Labelle 包含 Carlito 字体，许可证为 SIL 开源字体许可证。

模式

打印文本

labelle MyText

多行将在空白处生成

labelle MyLine MySecondLine # 将打印两行

如果您需要空白，请用 " " 包围

labelle "prints a single line"

打印 QR码和条形码

labelle --help

打印代码和文本

只需在您的 qr 或条形码文本后添加文本即可

labelle -qr "QR Content" "Cleartext printed"

图片打印

任何具有 JPEG 标准的图片都可以打印。请注意，它将被缩小到胶带大小。

labelle -p mypic.jpg ""

请注意尾随的 "" - 您可以在这里输入文本，该文本将在图像之前打印

更多控制使用批量模式

当使用 --batch 运行时，labelle 会为您提供对输出的更多控制。与 UI 一样，此模式允许每种类型的多个块。--batch 从 stdin 读取。每行必须以命令开头，后跟冒号和详细信息。命令如下：

• LABELLE-LABEL-SPEC-VERSION:1 必须是第一行。
• TEXT: 开始新的文本块。任何之前的文本行都将首先打印。
• NEWLINE：向当前文本块或二维码添加额外的行。用于创建多行文本块。
• QR：创建二维码块

例如，以下输入

LABELLE-LABEL-SPEC-VERSION:1
TEXT:FD12
NEWLINE:2013
QR:1234
TEXT:BIG
TEXT:LINE1
NEWLINE:LINE2
QR:12345

创建一个标签，包含

• 一个2行文本块（第一行 FD12，第二行 2013）
• 然后，为1234创建一个二维码
• 然后，一个带有文本 BIG 的单行文本块
• 然后，另一个2行文本块
• 最后，一个二维码

看起来像这样

GUI

运行Labelle GUI

labelle-gui

GUI应用程序功能

• 实时预览
• 边距设置
• 字体大小选择器
• 胶带颜色方案可视化
• 可以使用“节点”列表自由排列内容
  • 文本节点
    • 有效负载文本 - 可以是多行的
    • 字体选择器
    • 字体缩放 - 行高的百分比
    • 框架边框宽度调整
  • 二维码节点
    • 有效负载文本
  • 条码节点
    • 有效负载文本
    • 编码选择器
  • 图片节点
    • 文件路径

节点可以自由排列，只需在列表上拖放行。要从标签中添加或删除节点 - 右键单击列表并从上下文菜单中选择操作。要打印 - 点击打印按钮。

示例

示例 1：多个文本 + 二维码

示例 2：两个图像 + 带有框架的文本，红色上的白色

示例 3：带有文本、文本和图片的条码

关于名称

名称“Labelle”是由@claui提出的多语言双关语。

语言	单词/解释	含义	发音（IPA）	简体音标拼写
英语	标签	打印的贴纸	/ˈleɪbəl/	LAY-buhl
法语	La belle	美丽的	/la bɛl/	lah BEL
德语	Libelle（发音相似）	蜻蜓	/liˈbɛlə/	lee-BELL-uh

免责声明

• 本软件按原样提供，不提供任何保证。请参阅许可协议以获取详细信息。
• Labelle与DYMO、其子公司或其关联公司没有关联、关联、授权、认可或以任何方式官方联系。官方DYMO网站可在www.dymo.com找到。DYMO®名称及其相关名称、标志、徽章和图像是各自所有者的注册商标。目前，Labelle软件旨在支持DYMO制造的一些设备；然而，没有暗示认可或伙伴关系。