wp9529-printer 0.1.0__tar.gz

wp9529_printer-0.1.0/LICENSE

@@ -0,0 +1,25 @@
+MIT License
+
+Copyright (c) 2026 Arttu Mahlakaarto
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+The bundled fonts in src/*/assets keep their own licenses: see MDI-LICENSE
+(Material Design Icons, Pictogrammers Free License) and, where present,
+DejaVu-LICENSE (DejaVu fonts, Bitstream Vera license).

wp9529_printer-0.1.0/PKG-INFO

@@ -0,0 +1,217 @@
+Metadata-Version: 2.4
+Name: wp9529-printer
+Version: 0.1.0
+Summary: Driver, label renderer and CLI for the VSON WP9529 Bluetooth LE label printer
+Author: Arttu Mahlakaarto
+License-Expression: MIT
+Project-URL: Homepage, https://github.com/amahlaka/WP9529
+Project-URL: Issues, https://github.com/amahlaka/WP9529/issues
+Project-URL: Protocol, https://github.com/amahlaka/WP9529/blob/main/PROTOCOL.md
+Keywords: label printer,bluetooth,ble,thermal printer,qr code,wp9529,vson
+Classifier: Development Status :: 4 - Beta
+Classifier: Environment :: Console
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Topic :: Printing
+Requires-Python: >=3.12
+Description-Content-Type: text/markdown
+License-File: LICENSE
+License-File: src/wp9529/assets/MDI-LICENSE
+Requires-Dist: bleak>=0.22
+Requires-Dist: Pillow>=10.1.0
+Requires-Dist: qrcode>=7.4.2
+Dynamic: license-file
+
+# WP9529 label printer
+
+Print labels on a VSON **WP9529** Bluetooth label printer from a PC, without
+the phone app: a Python package (`pip install wp9529-printer`) and a
+command-line tool.
+
+Labels can mix a QR code (URL, Wi-Fi details, any text), a large title, smaller
+text and a [Material Design Icon](https://pictogrammers.com/library/mdi/).
+
+The printer's Bluetooth protocol, reverse engineered from the iLabel app, is
+documented in [PROTOCOL.md](PROTOCOL.md).
+
+For Home Assistant, see [HA-WP9529](https://github.com/amahlaka/HA-WP9529), an
+integration built on this package's label renderer. For Homebox asset tags,
+see [Homebox-labeler](https://github.com/amahlaka/Homebox-labeler), which uses
+this package.
+
+## Requirements
+
+- Windows, macOS or Linux with Bluetooth LE
+- Python 3.12+
+- A WP9529 with 30 × 12 mm die-cut labels (other sizes work with `--length`/`--gap`)
+
+## Install
+
+```bash
+pip install wp9529-printer
+```
+
+This installs the `wp9529` module (`import wp9529`) and the `wp9529-label` command. To work on the code
+instead, clone this repository and install it editable in a virtual
+environment:
+
+```bash
+python -m venv .venv
+```
+```bash
+.venv\Scripts\python -m pip install -e .
+```
+
+On macOS/Linux use `.venv/bin/python` instead of `.venv\Scripts\python`.
+
+Turn the printer on and **close the phone app or disconnect it from the
+printer**, because the printer only accepts one connection at a time. It
+doesn't need pairing; the tool finds it automatically.
+
+```bash
+wp9529-label --info
+```
+
+```
+printer 95:29:12:C2:09:0C: firmware V50
+auto power-off after 96 minutes
+```
+
+## Printing labels
+
+Any mix of `--title` (large text), `--text`, `--qr` and `--icon`:
+
+```bash
+wp9529-label --title Router --text "admin password in the vault" --icon mdi:router-wireless
+```
+```bash
+wp9529-label --qr "WIFI:T:WPA;S:Home;P:secret;;" --text "Guest Wi-Fi"
+```
+```bash
+wp9529-label --title Spices --preview previews
+```
+
+Layout, along the label: QR code, then icon, then text. With no text, the QR
+code and icon are centred. On a 30 mm label, an icon next to both a QR code and
+text shrinks to about 6 mm, and long text gets shortened with "…". Use
+`--length 40` on longer labels for more room.
+
+Your own image works too. It must be exactly 96 px wide (the print head); for a
+30 mm label it should be 240 px tall, and the top prints first:
+
+```bash
+wp9529-label --image my_label.png
+```
+
+### Options
+
+| Option | Default | Meaning |
+|---|---|---|
+| `--title TEXT` | | large text |
+| `--text TEXT` | | smaller text, or the only text |
+| `--qr DATA` | | any text to encode as a QR code |
+| `--icon mdi:NAME` | | an MDI icon |
+| `--image PATH` | | print an image 96 px wide |
+| `--copies N` | 1 | copies of each label |
+| `--length MM` | 30 | label length |
+| `--gap MM` | 8.5 | gap between labels |
+| `--continuous` | | continuous tape instead of die-cut labels |
+| `--density` | normal | `light`, `normal` or `dark` |
+| `--rotate` | 90 | use `270` if the text comes out upside down |
+| `--feed N` | 0 | extra blank lines after each label |
+| `--preview DIR` | | save PNGs to DIR instead of printing |
+| `--address MAC` | scan | printer Bluetooth address (skips the scan) |
+| `--info` | | show the firmware and auto power-off time |
+| `--power-off MIN` | | set how many idle minutes before the printer switches itself off (10–180); the printer remembers it |
+| `-v` | | verbose: log every Bluetooth packet |
+
+`python -m wp9529` works the same as `wp9529-label`.
+
+## Using it from Python
+
+```python
+import asyncio
+from wp9529 import WP9529, asset_tag, render_label
+
+async def main():
+    img = render_label(title="Router", qr="https://example.com", icon="mdi:router-wireless")
+    async with WP9529() as printer:  # scans for the printer; or WP9529("95:29:12:C2:09:0C")
+        await printer.print_image(img, density="normal", label_mm=30, gap_mm=8.5)
+        print(await printer.firmware_version(), await printer.power_off_minutes())
+
+asyncio.run(main())
+```
+
+`asset_tag(asset_id, name, url, icon=...)` renders the ID + name + QR layout
+used for inventory tags.
+
+## Home Assistant
+
+The Home Assistant integration lives in its own repository,
+[HA-WP9529](https://github.com/amahlaka/HA-WP9529): sensors, settings, a print
+form with live preview, a `notify` entity and the `wp9529.print_label` action.
+
+## Development
+
+The label renderer and its icon font live in `src/wp9529/label.py` and
+`src/wp9529/assets/`. HA-WP9529 can't install this package inside Home
+Assistant, so it carries an identical copy; after changing the renderer, copy
+it there too. HA-WP9529's tests fail if the copies differ while both projects
+sit side by side.
+
+The tests cover the renderer and the CLI:
+
+```bash
+pip install -e . pytest
+```
+```bash
+pytest
+```
+
+### Releasing
+
+Releases go to [PyPI](https://pypi.org/project/wp9529-printer/) through the
+[Publish workflow](.github/workflows/publish.yml), with trusted publishing (no
+API tokens):
+
+1. Bump `version` in `pyproject.toml` and push.
+2. Optional: *Actions → Publish → Run workflow* uploads that build to
+   [TestPyPI](https://test.pypi.org/project/wp9529-printer/); try it with
+   `pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ wp9529-printer`.
+   TestPyPI refuses a version it already has, so bump again to re-test.
+3. Publish a GitHub release with the tag `v` + the version (e.g. `v0.1.1`).
+   The workflow checks the tag matches, builds, smoke-tests the wheel and
+   uploads it to PyPI.
+
+## Troubleshooting
+
+**"No WP9529 found"**: the printer is off, asleep, or connected to the phone
+app (or Home Assistant). Turn it on, close the app and try again.
+
+**Labels are shifted or run into the gap**: the printer has lost its place on
+the roll. Use the printer's own re-align (feed) button, then print again. This
+can happen after a job that is longer than the label. Don't change `--length`
+or `--gap` to compensate.
+
+**Text is upside down**: add `--rotate 270`.
+
+**Print is too faint or too dark**: use `--density dark` or `--density light`.
+
+**"unknown MDI icon"**: check the name at
+[pictogrammers.com](https://pictogrammers.com/library/mdi/). The bundled font
+is version 7.4.47, so icons added after it aren't available.
+
+## Files
+
+| Path | What it is |
+|---|---|
+| `src/wp9529/` | the Python package: `driver.py` (Bluetooth LE, `bleak`), `label.py` (renderer), `cli.py` (`wp9529-label`), `assets/` (MDI icon font 7.4.47, codepoints, license) |
+| `tests/` | renderer and CLI tests |
+| `tools/scan.py`, `tools/probe.py` | debugging helpers for finding the printer and sending raw commands |
+| `PROTOCOL.md` | the reverse-engineered printer protocol |
+| `.github/workflows/publish.yml` | build and publish to PyPI / TestPyPI |
+| `LICENSE` | MIT; the bundled fonts keep their own licenses |

wp9529_printer-0.1.0/README.md

@@ -0,0 +1,189 @@
+# WP9529 label printer
+
+Print labels on a VSON **WP9529** Bluetooth label printer from a PC, without
+the phone app: a Python package (`pip install wp9529-printer`) and a
+command-line tool.
+
+Labels can mix a QR code (URL, Wi-Fi details, any text), a large title, smaller
+text and a [Material Design Icon](https://pictogrammers.com/library/mdi/).
+
+The printer's Bluetooth protocol, reverse engineered from the iLabel app, is
+documented in [PROTOCOL.md](PROTOCOL.md).
+
+For Home Assistant, see [HA-WP9529](https://github.com/amahlaka/HA-WP9529), an
+integration built on this package's label renderer. For Homebox asset tags,
+see [Homebox-labeler](https://github.com/amahlaka/Homebox-labeler), which uses
+this package.
+
+## Requirements
+
+- Windows, macOS or Linux with Bluetooth LE
+- Python 3.12+
+- A WP9529 with 30 × 12 mm die-cut labels (other sizes work with `--length`/`--gap`)
+
+## Install
+
+```bash
+pip install wp9529-printer
+```
+
+This installs the `wp9529` module (`import wp9529`) and the `wp9529-label` command. To work on the code
+instead, clone this repository and install it editable in a virtual
+environment:
+
+```bash
+python -m venv .venv
+```
+```bash
+.venv\Scripts\python -m pip install -e .
+```
+
+On macOS/Linux use `.venv/bin/python` instead of `.venv\Scripts\python`.
+
+Turn the printer on and **close the phone app or disconnect it from the
+printer**, because the printer only accepts one connection at a time. It
+doesn't need pairing; the tool finds it automatically.
+
+```bash
+wp9529-label --info
+```
+
+```
+printer 95:29:12:C2:09:0C: firmware V50
+auto power-off after 96 minutes
+```
+
+## Printing labels
+
+Any mix of `--title` (large text), `--text`, `--qr` and `--icon`:
+
+```bash
+wp9529-label --title Router --text "admin password in the vault" --icon mdi:router-wireless
+```
+```bash
+wp9529-label --qr "WIFI:T:WPA;S:Home;P:secret;;" --text "Guest Wi-Fi"
+```
+```bash
+wp9529-label --title Spices --preview previews
+```
+
+Layout, along the label: QR code, then icon, then text. With no text, the QR
+code and icon are centred. On a 30 mm label, an icon next to both a QR code and
+text shrinks to about 6 mm, and long text gets shortened with "…". Use
+`--length 40` on longer labels for more room.
+
+Your own image works too. It must be exactly 96 px wide (the print head); for a
+30 mm label it should be 240 px tall, and the top prints first:
+
+```bash
+wp9529-label --image my_label.png
+```
+
+### Options
+
+| Option | Default | Meaning |
+|---|---|---|
+| `--title TEXT` | | large text |
+| `--text TEXT` | | smaller text, or the only text |
+| `--qr DATA` | | any text to encode as a QR code |
+| `--icon mdi:NAME` | | an MDI icon |
+| `--image PATH` | | print an image 96 px wide |
+| `--copies N` | 1 | copies of each label |
+| `--length MM` | 30 | label length |
+| `--gap MM` | 8.5 | gap between labels |
+| `--continuous` | | continuous tape instead of die-cut labels |
+| `--density` | normal | `light`, `normal` or `dark` |
+| `--rotate` | 90 | use `270` if the text comes out upside down |
+| `--feed N` | 0 | extra blank lines after each label |
+| `--preview DIR` | | save PNGs to DIR instead of printing |
+| `--address MAC` | scan | printer Bluetooth address (skips the scan) |
+| `--info` | | show the firmware and auto power-off time |
+| `--power-off MIN` | | set how many idle minutes before the printer switches itself off (10–180); the printer remembers it |
+| `-v` | | verbose: log every Bluetooth packet |
+
+`python -m wp9529` works the same as `wp9529-label`.
+
+## Using it from Python
+
+```python
+import asyncio
+from wp9529 import WP9529, asset_tag, render_label
+
+async def main():
+    img = render_label(title="Router", qr="https://example.com", icon="mdi:router-wireless")
+    async with WP9529() as printer:  # scans for the printer; or WP9529("95:29:12:C2:09:0C")
+        await printer.print_image(img, density="normal", label_mm=30, gap_mm=8.5)
+        print(await printer.firmware_version(), await printer.power_off_minutes())
+
+asyncio.run(main())
+```
+
+`asset_tag(asset_id, name, url, icon=...)` renders the ID + name + QR layout
+used for inventory tags.
+
+## Home Assistant
+
+The Home Assistant integration lives in its own repository,
+[HA-WP9529](https://github.com/amahlaka/HA-WP9529): sensors, settings, a print
+form with live preview, a `notify` entity and the `wp9529.print_label` action.
+
+## Development
+
+The label renderer and its icon font live in `src/wp9529/label.py` and
+`src/wp9529/assets/`. HA-WP9529 can't install this package inside Home
+Assistant, so it carries an identical copy; after changing the renderer, copy
+it there too. HA-WP9529's tests fail if the copies differ while both projects
+sit side by side.
+
+The tests cover the renderer and the CLI:
+
+```bash
+pip install -e . pytest
+```
+```bash
+pytest
+```
+
+### Releasing
+
+Releases go to [PyPI](https://pypi.org/project/wp9529-printer/) through the
+[Publish workflow](.github/workflows/publish.yml), with trusted publishing (no
+API tokens):
+
+1. Bump `version` in `pyproject.toml` and push.
+2. Optional: *Actions → Publish → Run workflow* uploads that build to
+   [TestPyPI](https://test.pypi.org/project/wp9529-printer/); try it with
+   `pip install -i https://test.pypi.org/simple/ --extra-index-url https://pypi.org/simple/ wp9529-printer`.
+   TestPyPI refuses a version it already has, so bump again to re-test.
+3. Publish a GitHub release with the tag `v` + the version (e.g. `v0.1.1`).
+   The workflow checks the tag matches, builds, smoke-tests the wheel and
+   uploads it to PyPI.
+
+## Troubleshooting
+
+**"No WP9529 found"**: the printer is off, asleep, or connected to the phone
+app (or Home Assistant). Turn it on, close the app and try again.
+
+**Labels are shifted or run into the gap**: the printer has lost its place on
+the roll. Use the printer's own re-align (feed) button, then print again. This
+can happen after a job that is longer than the label. Don't change `--length`
+or `--gap` to compensate.
+
+**Text is upside down**: add `--rotate 270`.
+
+**Print is too faint or too dark**: use `--density dark` or `--density light`.
+
+**"unknown MDI icon"**: check the name at
+[pictogrammers.com](https://pictogrammers.com/library/mdi/). The bundled font
+is version 7.4.47, so icons added after it aren't available.
+
+## Files
+
+| Path | What it is |
+|---|---|
+| `src/wp9529/` | the Python package: `driver.py` (Bluetooth LE, `bleak`), `label.py` (renderer), `cli.py` (`wp9529-label`), `assets/` (MDI icon font 7.4.47, codepoints, license) |
+| `tests/` | renderer and CLI tests |
+| `tools/scan.py`, `tools/probe.py` | debugging helpers for finding the printer and sending raw commands |
+| `PROTOCOL.md` | the reverse-engineered printer protocol |
+| `.github/workflows/publish.yml` | build and publish to PyPI / TestPyPI |
+| `LICENSE` | MIT; the bundled fonts keep their own licenses |

wp9529_printer-0.1.0/pyproject.toml

@@ -0,0 +1,44 @@
+[build-system]
+requires = ["setuptools>=77"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "wp9529-printer"
+version = "0.1.0"
+description = "Driver, label renderer and CLI for the VSON WP9529 Bluetooth LE label printer"
+readme = "README.md"
+requires-python = ">=3.12"
+license = "MIT"
+license-files = ["LICENSE", "src/wp9529/assets/*LICENSE"]
+authors = [{ name = "Arttu Mahlakaarto" }]
+keywords = ["label printer", "bluetooth", "ble", "thermal printer", "qr code", "wp9529", "vson"]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Environment :: Console",
+    "Intended Audience :: End Users/Desktop",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Programming Language :: Python :: 3.14",
+    "Topic :: Printing",
+]
+dependencies = [
+    "bleak>=0.22",
+    "Pillow>=10.1.0",
+    "qrcode>=7.4.2",
+]
+
+[project.urls]
+Homepage = "https://github.com/amahlaka/WP9529"
+Issues = "https://github.com/amahlaka/WP9529/issues"
+Protocol = "https://github.com/amahlaka/WP9529/blob/main/PROTOCOL.md"
+
+[project.scripts]
+wp9529-label = "wp9529.cli:main"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+wp9529 = ["assets/*"]

wp9529_printer-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

wp9529_printer-0.1.0/src/wp9529/__init__.py

@@ -0,0 +1,24 @@
+"""VSON WP9529 Bluetooth LE label printer: driver, label renderer and CLI."""
+from .driver import (
+    DENSITY,
+    POWER_OFF_MAX,
+    POWER_OFF_MIN,
+    WP9529,
+    Info,
+    PrinterError,
+    find_printer,
+)
+from .label import asset_tag, mdi_glyph, render_label
+
+__all__ = [
+    "DENSITY",
+    "POWER_OFF_MAX",
+    "POWER_OFF_MIN",
+    "WP9529",
+    "Info",
+    "PrinterError",
+    "asset_tag",
+    "find_printer",
+    "mdi_glyph",
+    "render_label",
+]

wp9529_printer-0.1.0/src/wp9529/__main__.py

@@ -0,0 +1,4 @@
+"""python -m wp9529: the label CLI."""
+from .cli import main
+
+main()

wp9529_printer-0.1.0/src/wp9529/assets/MDI-LICENSE

@@ -0,0 +1,20 @@
+Pictogrammers Free License
+--------------------------
+
+This icon collection is released as free, open source, and GPL friendly by
+the [Pictogrammers](http://pictogrammers.com/) icon group. You may use it
+for commercial projects, open source projects, or anything really.
+
+# Icons: Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0)
+Some of the icons are redistributed under the Apache 2.0 license. All other
+icons are either redistributed under their respective licenses or are
+distributed under the Apache 2.0 license.
+
+# Fonts: Apache 2.0 (https://www.apache.org/licenses/LICENSE-2.0)
+All web and desktop fonts are distributed under the Apache 2.0 license. Web
+and desktop fonts contain some icons that are redistributed under the Apache
+2.0 license. All other icons are either redistributed under their respective
+licenses or are distributed under the Apache 2.0 license.
+
+# Code: MIT (https://opensource.org/licenses/MIT)
+The MIT license applies to all non-font and non-icon files.