A modern desktop application for printing images on mini thermal printers like the MXW01 (Cat Printer).
This project includes AI generated code!
- 🔗 Bluetooth Connection: Scan for and connect to compatible thermal printers
- 🖼️ Image Loading: Support for PNG, JPG, GIF, BMP, and WebP formats
- 🎨 Multiple Dithering Algorithms:
- 📐 Print Preview: Real-time preview with ruler showing actual print dimensions
- ⚙️ Intensity Control: Adjust print darkness with presets
- 📊 Progress Feedback: Real-time printing progress and status updates
- MXW01 (Cat Printer)
- Other BLE thermal printers using similar protocols (384px width)
- Windows 10/11 with Bluetooth LE support
- Bluetooth adapter capable of BLE
Download the latest release from the Releases page.
# Install Wails CLI
go install github.com/wailsapp/wails/v2/cmd/wails@latest
# Clone the repository
git clone https://github.com/yourusername/mini-print.git
cd mini-print
# Build the application
wails build- Go 1.21+ (for development)
- Node.js 18+ (for development)
# Run in development mode with hot reload
wails dev- Connect your printer: Turn on your thermal printer and make sure Bluetooth is enabled
- Scan or enter MAC address: Click "Scan for Devices" or manually enter the printer's MAC address
- Load an image: Click the drop zone or drag an image into the app
- Adjust settings: Choose a dithering algorithm and adjust intensity
- Print: Click the Print button to send the image to your printer
- Backend: Go with Wails framework
- Frontend: Vue 3 with Vite and Tailwind
- Bluetooth: tinygo-org/bluetooth
- Text mode for quick labels
- TLDraw canvas integration for badge design
- Linux and macOS support
- Print queue for batch printing
MIT License - see LICENSE for details.
- MXW01 Catprinter for protocol documentation
- Wails for the Go + Web framework
- Vue.js for the frontend framework