- First version from Sebastian Bronner: https://sbronner.com/dymoprint.html
- Cloned to Github and maintained by @computerlyrik and later @maresb: https://github.com/computerlyrik/dymoprint
- Migrated to
labelle-org
and maintained by @tomers, @maresb, and @tomek-szczesny: https://github.com/labelle-org/labelle
- Text printing
- QR code printing
- Barcode printing
- Image printing
- Combinations of the above
- GUI Application based on PyQt6
- Windows support by setting the driver to WinUSB using Zadig
- DYMO LabelManager PC
- DYMO LabelPoint 350
- DYMO LabelManager 280
- DYMO LabelManager 420P
- DYMO LabelManager Wireless PnP
Labelle is not affiliated with DYMO. Please see the disclaimer below.
For more information about experimental device support, see #4.
If you have a device or tape size that we do not yet support, the first step is to try and get it to print. In some cases this is as simple as adding the device id. Once you can print, you can help us determine the print head size and margins for your tape sizes by following these instructions.
It is recommended to install Labelle with pipx so that it runs in an isolated virtual environment:
pipx install labelle
In case pipx is not already installed, it can be installed on Ubuntu/Debian with
sudo apt-get install pipx
or on Arch with
sudo pacman -S python-pipx
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:
$ 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
...
To install a test branch, by GitHub user ghuser
for the branch branchname
, run
pipx install --force git+https://github.com/ghuser/labelle@branchname
To revert back to the release version, run
pipx install --force labelle
To install a particular release version, specify labelle==x.y.z
in place of
labelle
in the above command.
To install for development, fork and clone this repository, and run (ideally within a venv):
pip install --editable .
This project uses pre-commit to run some checks
before committing.
After installing the pre-commit
executable, please run
pre-commit install
Default fonts are managed via labelle.ini.
This should be placed in your config folder (normally ~/.config
).
An example file is provided here.
For my Arch-Linux System, fonts are located at e.g.
/usr/share/fonts/TTF/DejaVuSerif.ttf
It is also possible to Download a font from https://font.ubuntu.com/ and use it.
For font discovery, Labelle contains code excerpts from
matplotlib
.
See here for more information and
LICENSE for the license.
Labelle includes the Carlito font, licensed under the SIL Open Font License.
labelle MyText
Multilines will be generated on whitespace
labelle MyLine MySecondLine # Will print two Lines
If you want whitespaces just enclose in " "
labelle "prints a single line"
labelle --help
Just add a text after your qr or barcode text
labelle -qr "QR Content" "Cleartext printed"
Any picture with JPEG standard may be printed. Beware it will be downsized to tape.
labelle -p mypic.jpg ""
Take care of the trailing "" - you may enter text here which gets printed in front of the image
labelle-gui
- Live preview
- margin settings
- type size selector
- visualization of tape color schema
- the ability to freely arrange the content using the "Node" list
- Text Node:
- payload text - can be multi-line
- font selector
- font scaling - the percentage of line-height
- frame border width steering
- Qr Node:
- payload text
- BarCode Node:
- payload text
- codding selector
- Image Node:
- path to file
- Text Node:
Nodes can be freely arranged, simply drag&drop rows on the list. To add or delete the node from the label - right-click on the list and select the action from the context menu. To print - click the print button.
Example 1: multiple text + QR code
Example 2: two images + text with frame, white on red
Example 3: barcode with text, text, image
The name "Labelle" is a multilingual pun by @claui.
Language | Word/Interpretation | Meaning | Pronunciation (IPA) | Simplified Phonetic Spelling |
---|---|---|---|---|
English | Label | A printed sticker | /ˈleɪbəl/ | LAY-buhl |
French | La belle | The beautiful | /la bɛl/ | lah BEL |
German | Libelle (sounds like) | Dragonfly | /liˈbɛlə/ | lee-BELL-uh |
- This software is provided as-is, without any warranty. Please see LICENSE for details.
- Labelle is not affiliated, associated, authorized, endorsed by, or in any way officially connected with DYMO, or any of its subsidiaries or its affiliates. The official DYMO website can be found at www.dymo.com. The name DYMO®, as well as related names, marks, emblems, and images, are registered trademarks of their respective owners. Currently, Labelle software is designed to support certain devices manufactured by DYMO; however, no endorsement or partnership is implied.