- C# 87.9%
- PowerShell 6.3%
- Inno Setup 5.8%
| Filename | Latest commit message | Latest commit date |
|---|---|---|
Windows WPF app that designs and prints labels on a P-touch CUBE over Bluetooth (direct RFCOMM, Brother raster protocol): text, image, QR and barcode blocks, live preview, tape status, copies, cut marks, .ptlabel files, System/Light/Dark theme, updater, About and Log tabs, Inno Setup installer and Forgejo release script. Co-Authored-By: Claude Opus 5.5 <[email protected]> |
||
| app/PTouchDesk | ||
| installer | ||
| release-notes | ||
| .gitignore | ||
| build.ps1 | ||
| README.md | ||
| release.ps1 | ||
PTouch Desk
Design and print labels on a Brother P-touch CUBE (PT-P300BT) from a Windows PC over Bluetooth. Brother only supports this printer from phones; PTouch Desk talks to it directly, so no Brother software or driver is needed.
Features
- Labels built from blocks laid out along the tape: text (any installed font, bold/italic/underline, several lines, fit-to-height or fixed size), images (threshold or dithering), QR codes and Code 128 barcodes
- Live preview at the real dot resolution (180 dpi), in the colours of the loaded tape
- 3.5, 6, 9 and 12 mm tape; fixed or automatic length; frame; white-on-black; copies
- Reads the printer's status: loaded tape width, type and colours, and errors (cover open, no tape, ...)
- Optional cut marks, tape-saving "don't feed the last label" mode, adjustable end margins
- Labels are saved as
.ptlabelfiles; the last label is restored at start-up - System / Light / Dark theme, built-in updater, About and Log tabs
Getting started
- Put batteries (6 x AAA) or the adapter in the printer and switch it on.
- In Windows: Settings > Bluetooth & devices > Add device > Bluetooth and pick
PT-P300BTxxxx. Windows may then show "Driver is unavailable" for it. That is expected and harmless. - Start PTouch Desk. It finds the paired printer by itself (Settings tab if you have more than one).
- Click Check printer to read the loaded tape, design the label and press Print (Ctrl+P).
If printing says it can't connect: switch the printer on (it powers off when idle) and make sure the Brother app on your phone isn't connected to it. Only one device can be connected at a time.
How it works
The printer exposes a Bluetooth Serial Port (SPP) service and understands Brother's documented raster command set (the same one the USB P-touch models use). Windows' own "Standard Serial over Bluetooth" COM port does not reconnect to the printer after it has been switched off, so the app opens the printer's SPP service directly as an RFCOMM socket through the WinRT Bluetooth API and retries the first connection, which often fails while the printer wakes up.
A print job is: invalidate, ESC @, ESC i a 1 (raster mode), then per copy ESC i z (tape width,
line count), ESC i M (cut marks), ESC i K (chain printing), ESC i d (margin), M 2 (PackBits),
one G raster line per dot column (128 head dots, the tape centred on dot 64), and 0x0C/0x1A.
Printable height: 64 dots on 12 mm tape, 50 on 9 mm, 32 on 6 mm, 24 on 3.5 mm.
Building
Requires the .NET 8 SDK and, for the installer, Inno Setup 6.
.\build.ps1 # app\dist\PTouchDesk.exe and installer\output\PTouchDesk-Setup-<version>.exe
.\release.ps1 # tags, pushes and publishes a release on Forgejo (needs release-notes\v<version>.md)
Settings and the last label live in %APPDATA%\PTouchDesk.
Brother, P-touch and P-touch CUBE are trademarks of Brother Industries, Ltd. This project is not made by or affiliated with Brother.