Receipt Printer (Mac)

Receipt Printer (Mac Alternative)

This is an alternative printing mode for macOS to use when the standard “Receipt Printer” mode doesn’t work with your printer. Try the standard mode first—if it works, you don’t need this alternative.

How It Works

Instead of sending ESC/POS commands directly to the printer, this mode:

  1. Generates a PNG image of your task
  2. Sends the image to your operating system’s print system (CUPS on macOS/Linux)
  3. The print system handles the communication with your printer using its installed driver

This approach bypasses driver compatibility issues by letting the OS handle the printer communication.

Setup

1. Install Your Printer

First, make sure your printer is properly installed in macOS:

  1. Connect your printer via USB
  2. Open System Settings (or System Preferences on older macOS versions)
  3. Go to Printers & Scanners
  4. Click the + button to add your printer
  5. Select your printer from the list and follow the installation prompts
  6. Your printer should appear in the list with a status of “Idle”

2. Configure Colonnes

  1. Open Print Settings in Colonnes
  2. Select Receipt Printer (Mac Alternative) from the Mode dropdown
  3. Select your printer from the Printer dropdown

Settings

Prevent Trim

When enabled, adds a thin black line at the bottom of the printed image. This prevents macOS CUPS from automatically trimming blank margins, ensuring your configured padding is respected.

Image Settings

DPI (Dots Per Inch)

  • Resolution of the printed image
  • Default: 203 (standard for most thermal receipt printers)
  • Higher DPI = sharper text but slower printing

Width (mm)

  • Paper width in millimeters
  • Common values: 58mm (narrow) or 80mm (standard)
  • Match this to your actual paper roll width

Padding (Left, Right, Top, Bottom)

  • Margins around the content in millimeters
  • Account for your printer’s hardware margins (typically 2-4mm)
  • Adjust these to center your content on the paper

Font Sizes

Customize the text sizes for different elements:

  • Breadcrumb: Size for the navigation path (e.g., “Home > Project”)
  • Title: Size for the task title
  • Checklist: Size for checklist items

Live Preview

The right panel shows a real-time preview of how your task will look when printed. The preview updates automatically as you adjust settings, allowing you to fine-tune the layout before printing.

Troubleshooting

Printer not appearing in the list

  • Ensure the printer is installed in macOS System Preferences
  • Check that the printer shows as “Idle” or “Ready” (not offline)
  • Try removing and re-adding the printer in System Preferences
  • Adjust the Width setting to match your paper size exactly
  • Increase the padding values to account for hardware margins
  • Enable Prevent Trim if bottom padding is being ignored