No description
  • C# 87.9%
  • PowerShell 6.3%
  • Inno Setup 5.8%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
TomTom 676ed6a599 PTouch Desk 1.0.0: label app for the Brother PT-P300BT
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]>
2026-10-02 09:36:34 +02:00
app/PTouchDesk PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
installer PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
release-notes PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
.gitignore PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
build.ps1 PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
README.md PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00
release.ps1 PTouch Desk 1.0.0: label app for the Brother PT-P300BT 2026-10-02 09:36:34 +02:00

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 .ptlabel files; the last label is restored at start-up
  • System / Light / Dark theme, built-in updater, About and Log tabs

Getting started

  1. Put batteries (6 x AAA) or the adapter in the printer and switch it on.
  2. 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.
  3. Start PTouch Desk. It finds the paired printer by itself (Settings tab if you have more than one).
  4. 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.