Docs / apps/print-agent/README.md

Chimti Print Agent

Local USB print bridge for Chimti garment/article tags.

What It Does

Production Install

Build the Mac and Windows installer packages:


npm run build:dist

Generated files:

Install only on the computer where the USB printer is connected.

Mac Install

1. Unzip `chimti-print-agent-mac.zip`.

2. Double-click `install-mac.command`.

3. If macOS blocks it, right-click and choose **Open**.

4. Setup opens at `http://127.0.0.1:47844`.

The installer copies the agent to `~/Applications/Chimti Print Agent` and adds a user LaunchAgent so it starts automatically after login.

Windows Install

1. Unzip `chimti-print-agent-windows.zip`.

2. Double-click `install-windows.bat`.

3. Setup opens at `http://127.0.0.1:47844`.

The installer copies the agent to `%LOCALAPPDATA%\ChimtiPrintAgent` and creates a scheduled task so it starts automatically after login.

Developer Start


npm start

Then open:


http://127.0.0.1:47844

Select the TSC printer, set label size, and run **Test Print**.

Printer Setup

Mac

1. Connect TSC TTP-244 Pro by USB.

2. Add it in macOS Printers & Scanners.

3. If macOS asks for driver, use the TSC driver or Generic Raw/ZPL style driver if available.

4. Start this agent and choose the printer in setup.

Windows

1. Install TSC Windows driver.

2. Connect TSC TTP-244 Pro by USB.

3. Confirm it appears in Windows Printers.

4. Start this agent and choose the printer in setup.

Default Label

These can be changed from the local setup page after the actual taffeta roll size is known.