thermark 0.36.1

Local sticker printing for pocket thermal printers over BLE/USB — QR links, inventory tags, badges, photos; no vendor app
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118

# Label recipes

Eight useful labels you can render before buying or connecting a printer.
Install thermark using the [installation guide](installation.md). Commands below
work in a POSIX shell on macOS or Linux and use fictional, public demo data.

All previews use the B1 profile and 50×30 mm media. They are rendered PNGs,
not hardware photographs. Use your actual label size when printing.

```sh
mkdir -p local/prints
```

Choose a recipe, inspect the PNG, and scan QR previews with your phone.
For a physical print, first follow the [connection guide](../README.md#install-and-print-your-first-label),
then remove `--no-print`. B1 over BLE is the hardware-tested path.
Wi-Fi QR codes contain the password even when it is not printed as text; keep
real credentials and saved labels under ignored `local/`.

To reproduce the gallery from a source checkout:

```sh
sh examples/render-recipes.sh local/prints/recipes
```

This renders all eight previews without connecting to hardware. It requires an
installed `thermark`; set `THERMARK_BIN` to use a locally built binary.
The default is embedded DejaVu Sans. `THERMARK_FONT` selects a custom `.ttf` or
`.ttc` font. To refresh committed previews from current code, follow the
[documentation image workflow](development.md#documentation-images-and-screenshots).

## Guest Wi-Fi

Let visitors scan a network label. These credentials are fictional.

![Rendered guest wi-fi label](demo/recipes/guest-wifi.png)

```sh
thermark wifi --ssid "Demo-Guest" --password "demo-only-1234" \
  --model b1 --label 50x30 --save local/prints/guest-wifi.png --no-print
```

## Inventory bins

Link a storage bin to its contents.

![Rendered inventory bins label](demo/recipes/inventory.png)

```sh
thermark qr --url "https://example.com/bins/A3" --text "BIN A3\nCables" \
  --model b1 --label 50x30 --save local/prints/inventory.png --no-print
```

## Equipment manuals

Put the instructions beside the tool.

![Rendered equipment manuals label](demo/recipes/equipment.png)

```sh
thermark qr --url "https://example.com/manuals/drill" --text "DRILL 01\nManual" \
  --model b1 --label 50x30 --save local/prints/equipment.png --no-print
```

## Return instructions

Give a shared kit a return page without exposing personal contact details.

![Rendered return instructions label](demo/recipes/return.png)

```sh
thermark qr --url "https://example.com/return/42" --text "KIT 42\nReturn here" \
  --model b1 --label 50x30 --save local/prints/return.png --no-print
```

## Name badges

Make a simple badge for a meetup or workshop.

![Rendered name badges label](demo/recipes/badge.png)

```sh
thermark text --text "ALEX\nVolunteer" \
  --model b1 --label 50x30 --save local/prints/badge.png --no-print
```

## Storage labels

Mark small parts drawers with readable text.

![Rendered storage labels label](demo/recipes/storage.png)

```sh
thermark text --text "M3 BOLTS\nDrawer 04" \
  --model b1 --label 50x30 --save local/prints/storage.png --no-print
```

## Packing labels

Add a handling reminder to a parcel.

![Rendered packing labels label](demo/recipes/packing.png)

```sh
thermark text --text "FRAGILE\nThis way up" \
  --model b1 --label 50x30 --save local/prints/packing.png --no-print
```

## Batch identification

Identify a batch with an explicit date. Replace both values for your workflow.

![Rendered batch identification label](demo/recipes/batch.png)

```sh
thermark text --text "BATCH 024\n2026-09-30" \
  --model b1 --label 50x30 --save local/prints/batch.png --no-print
```