A free, browser-based label designer for Phomemo thermal printers. No drivers needed - connects via Bluetooth or USB.
Try it now: https://phomymo.affordablemagic.net
- Open https://phomymo.affordablemagic.net in Chrome (or any Chromium-based browser)
- Click Connect to pair with your printer via Bluetooth (or USB for PM-241)
- Design your label and click Print
To run locally (Web Bluetooth requires HTTPS or localhost):
cd src/web
python3 -m http.server 8080
# Open http://localhost:8080 in ChromeRequires: Chrome, Edge, or another Chromium-based browser. Web Bluetooth is not available in Firefox or Safari. Android Chrome is supported with full touch UI; iOS is not supported. PM-241 printers require USB (WebUSB).
Design Elements - Text (multiple fonts including local system fonts, sizes, styles, alignment, background colors), images with scale/aspect lock, barcodes (Code128, EAN-13, UPC-A, Code39), QR codes, and shapes (rectangle, ellipse, triangle, line) with solid, dithered grayscale, and stroke fills.
Editing - Drag to move, corner/edge resize handles, rotation. Multi-select (Shift+click), grouping (Ctrl/Cmd+G), undo/redo, keyboard nudge, layer ordering, clipboard image paste (Ctrl/Cmd+V).
Label Sizes - Preset sizes for each printer type, round labels, custom dimensions. Auto-switches based on connected printer. Multi-label rolls with clone or individual zone modes.
Templates & Batch Printing - Variable fields with {{FieldName}} syntax, CSV import, preview grid, and batch printing with progress tracking.
Instant Expressions - Dynamic values at print time using [[expression]] syntax: [[date]], [[time]], [[datetime]], or custom formats like [[date|MM/DD/YYYY]]. Works in text, barcodes, and QR codes.
Print Preview - Toggle dither preview to see exact thermal print output before printing.
Export - Save/load designs to browser storage, export/import as JSON, export to PDF or PNG.
Mobile - Full-featured touch UI with pinch-to-zoom, two-finger pan, slide-up property panels, and complete feature parity with desktop.
Printer Status - Live battery level, paper status, firmware version, and serial number with auto-query on connect.
| Model | Width | Notes |
|---|---|---|
| P12 / P12 Pro | 12mm | Continuous tape label maker |
| A30 | 12-15mm | Continuous tape, faster print speed |
| M02 / M02S / M02X | 48mm (384px) | Mini pocket printers, continuous paper |
| M02 Pro | 53mm (626px) | 300 DPI high-resolution mini printer |
| M03 | 53mm (432px) | Mini sticker printer |
| T02 | 48mm (384px) | Mini sticker printer |
| M04S / M04AS | 53/80/110mm | 300 DPI multi-width printer (select paper size in settings) |
| M110 / M120 | 48mm (384px) | Narrow label makers |
| M200 / M250 | 75mm (608px) | Mid-size labels |
| M220 / M221 | 72mm (576px) | Wide labels |
| M260 | 72mm (576px) | Wide label maker |
| D30 / D35 / D50 / D110 | 12-15mm | Smart mini label makers (rotated protocol) |
| Q30 / Q30S | 12-15mm | Similar to D30 |
| PM-241 / PM-241-BT | 102mm (4") | Shipping labels, USB only (TSPL protocol) |
The app auto-detects your printer model from the Bluetooth device name and configures the correct protocol, print width, DPI, and label presets. If auto-detection fails, you can manually select your model in Print Settings, or the app will prompt you on first connection.
D-series printers print labels rotated 90° - the app handles this automatically. PM-241 printers use Bluetooth Classic (not BLE), so use the USB connection instead.
You can add, edit, and override printer definitions through Print Settings > Manage Printers. This lets you:
- Add new printers not yet in the built-in list with your own protocol, width, DPI, and alignment settings
- Override built-in printers to adjust settings like alignment or width for your specific hardware
- Set auto-detect patterns so your custom definitions are recognized automatically by BLE device name
Custom definitions are saved in your browser's localStorage and take priority over built-ins. Modified built-in printers can be reset to defaults at any time.
Built-in definitions are loaded from printers.json at startup.
| Shortcut | Action |
|---|---|
Ctrl/Cmd + Z |
Undo |
Ctrl/Cmd + Shift + Z |
Redo |
Ctrl/Cmd + D |
Duplicate selected |
Ctrl/Cmd + G |
Group selected |
Ctrl/Cmd + Shift + G |
Ungroup |
Ctrl/Cmd + V |
Paste image from clipboard |
Delete / Backspace |
Delete selected |
Arrow keys |
Nudge by 1px |
Shift + Arrow keys |
Nudge by 10px |
Shift + Click |
Add to selection |
When the Bluetooth device picker appears, select the device showing a signal strength indicator. Devices listed without signal strength may be cached/ghost entries that won't connect properly.
phomymo/
├── src/
│ └── web/
│ ├── index.html # Main UI
│ ├── app.js # Application logic
│ ├── canvas.js # Canvas rendering & dithering
│ ├── elements.js # Element management
│ ├── handles.js # Selection handles
│ ├── storage.js # localStorage persistence
│ ├── templates.js # Variable substitution & CSV
│ ├── ble.js # Web Bluetooth transport
│ ├── usb.js # WebUSB transport
│ ├── printer.js # Print protocols
│ ├── printers.json # Built-in printer definitions
│ ├── constants.js # Shared constants
│ └── utils/
│ ├── bindings.js # Event binding helpers
│ ├── errors.js # Error handling
│ └── validation.js # Input validation
└── README.md
Protocol research and inspiration:
- vivier/phomemo-tools - CUPS driver with reverse-engineered protocol
- yaddran/thermal-print - Printer status query commands
- ooki1jp - M04AS/M04S protocol reverse-engineering
Libraries: JsBarcode, QRCode.js, jsPDF
If Phomymo is useful to you, consider making a donation to support ongoing development.
MIT License - see LICENSE file for details.