Repository navigation
CatLabel 0.3.1 adapts selected TiMini Print 0.9.1 printer improvements to CatLabel's architecture. The editor and UI are unchanged.
- More reliable V5X and V5C print startup, status handling and completion tracking, with bounded waits and protection against replaying an uncertain print.
- Updated Phomemo, Tiny, Funny, V5G, ToPrint and HPRT command handling, including model-specific padding, density, feed and image bounds.
- Safer Bluetooth connection cleanup, coherent BLE characteristic selection and advertisement handling, plus persistent native Classic Bluetooth receive handling on Windows and macOS.
- Compatibility with newer upstream catalog data while preserving CatLabel's local overrides and model exclusions. The full upstream catalog is not activated automatically; entries requiring unsupported geometry remain deferred.
- Release metadata now consistently reports 0.3.1 to MCP clients.
- Refreshed vulnerable runtime and frontend dependencies, including Pillow and DOMPurify, and rebuilt the bundled frontend.
Linux x86_64: make the AppImage executable and run it. Windows x86_64: put the launcher in a short, writable folder, such as C:\CatLabel, and run it. macOS / Linux ARM64: extract the portable ZIP and run bash ./run.sh.
First setup needs internet access to install the locked runtime. Existing packaged installations can replace their launcher in the same folder and use --update-bundled --setup-only to select the new bundled release. Keep your existing data directory.
Automated checks and packaging validation do not establish physical printer behavior for every supported model. Windows and macOS Bluetooth changes still need validation on real printer hardware.
Linux qualification observed intermittent cold-preview timeouts on a host with heavy paging and I/O pressure. Retrying the saved design and three subsequent cold-start checks passed; this remains a known limitation under resource pressure. Installation, upgrade from v0.3, rollback and restoration preserved the saved design.
Two moderate advisories in Node globbing dependencies remain under version-specific review exceptions expiring December 1. Their affected developer-tool and Node CLI paths are excluded from the packaged application.
Checksums · Installation and recovery · MCP guide · Changes since v0.3