Projects/PyCatPrint - BLE Thermal Printer Control
backend
iot

PyCatPrint - BLE Thermal Printer Control

Python CLI for Bluetooth Thermal Printer Integration

Overview

A Python-based CLI tool for controlling BLE thermal printers via Bluetooth Low Energy. Converts images and PDFs into printer-compatible bitmaps with advanced dithering algorithms.

Key Features

  • Auto-discover and connect to BLE printers
  • Image processing with advanced dithering (Floyd-Steinberg, Atkinson, Halftone)
  • Multi-page PDF support with automatic page separation
  • Customizable print settings (darkness, speed, dithering)
  • Preview mode before printing
  • Support for GT01, GB02, MX11 printer models
  • Comprehensive debug tools
  • Cross-platform compatibility

Outcomes & Impact

  • Reliable BLE communication with thermal printers
  • Professional print quality with dithering
  • Easy-to-use CLI interface
  • Supports custom printer configurations

Tech Stack

Python

backend

Pillow

other

BLE

other

Click

other

Image Processing

other

Tags

Python
BLE
Image Processing
Dithering
CLI
Hardware Integration

Project Info

Categories

backend, iot

Status

Public