Talos Label Printer

Overview

The Talos Label Printer is a cross-platform desktop application that connects to BLE, USB, and Bluetooth Classic label printers to print inventory QR codes for raw materials and products. It syncs label templates from Talos cloud and supports CPCL and ZPL print formats.

System Requirements

Installation

Windows

1. Download the Windows installer from the Downloads section
2. Run the .exe installer
3. Follow the installation wizard
4. Launch "Talos Label Printer" from the Start menu

macOS

1. Download the macOS .dmg file (Universal recommended)
2. Open the DMG and drag "Talos Label Printer" to Applications
3. On first launch, right-click the app and select "Open" to bypass Gatekeeper
4. Grant Bluetooth permission when prompted

Linux

1. Download the .AppImage file
2. Make it executable: chmod +x Talos*.AppImage
3. Run it: ./Talos*.AppImage
4. For BLE support, grant raw socket access:

   sudo setcap cap_net_raw+eip $(readlink -f $(which node))

5. Add your user to the dialout group for USB/serial:

   sudo usermod -a -G dialout $USER

First Login

1. Open the app — the login screen appears
2. Enter your Talos credentials (same email/password as the web dashboard)
3. Click "Login" — the app connects to your organization automatically

Printer Setup

BLE (Bluetooth Low Energy)

1. Go to "Printer Settings"
2. Select "BLE" as connection type
3. Click "Scan" — nearby BLE printers appear
4. Select your printer from the list
5. The app remembers your last connected printer

USB / Serial

1. Connect the printer via USB cable
2. Go to "Printer Settings"
3. Select "USB/Wire" as connection type
4. Pick the serial port from the dropdown

Supported Printers

• Honeywell mobile printers (CPCL format)
• Zebra mobile/desktop printers (ZPL format)
• Any BLE-capable label printer with serial profile

Printing Labels

Test Print

Use "Test Print" to verify connectivity. It prints a simple "Hello World" label.

Raw Material Labels

Enter material code, seller, manufacturer, lot number, and quantity. Optionally attach delivery note details (driver, plate, weight). The printed QR code contains a unique ID that links the physical label to the digital record in Talos.

Product Labels

Enter product ID, lot number, and quantity. Used for finished goods tracking.

Cloud Templates

If your organization has custom label templates configured in the Talos dashboard, they appear in the template selector. Templates define field layout, QR code position, font sizes, and additional fields.

Troubleshooting