ThermalTask Bridge

ThermalTask Bridge is a CLI utility that connects thermal printers to ThermalTask.com, enabling you to print your task list through a web interface.

Features

• 🖨️ Connect a TCP/IP thermal printer to ThermalTask.com
• 🌐 Print from anywhere through the web interface
• 🔐 Secure API authentication
• ⚙️ Easy printer configuration
• 🚀 Real-time print job processing

Prerequisites

• Node.js
• A ThermalTask account

Installation

You can run ThermalTask Bridge directly using npx:

npx thermaltask

Getting Started

1. Create a ThermalTask Account

1. Visit thermaltask.com
2. Sign up for a free account
3. Navigate to your settings to get your login token

2. Authenticate the Bridge

Once you have your authentication command from the ThermalTask settings, run it in your terminal:

npx thermaltask login <your-token>

This will authenticate your bridge with the ThermalTask API and save your credentials locally.

3. Configure Your Printer

Set up your thermal printer configuration:

npx thermaltask printer edit

This interactive command will guide you through:

• Setting printer manufacturer
• Configuring connection parameters (IP address, port)
• Setting printer options (character set)

4. Start the Bridge

Connect to ThermalTask and start listening for print jobs:

npx thermaltask connect

The bridge will now run continuously, processing print jobs sent from your ThermalTask dashboard.

Daemon Mode

ThermalTask Bridge supports running as a background daemon, allowing it to operate without keeping a terminal window open.

Running as a Daemon

To start the bridge in the background:

npx thermaltask connect -d

This will:

• Start the bridge as a detached background process
• Log all activity to a daemon log file
• Return control to your terminal immediately

Managing the Daemon

View real-time logs:

npx thermaltask attach

This command lets you monitor the daemon's activity in real-time. Press Ctrl+C to detach from the logs (the daemon continues running).

Stop the daemon:

npx thermaltask disconnect

This gracefully stops the background daemon process.