Skip to content

Repository files navigation

phomo (phomemo macos driver)

A native macOS CUPS print queue for the Phomemo M02, a Bluetooth LE thermal printer, exposed via an app with a systray UI. Optionally starts at login.

Verified on macOS 26.5.2 (build 25F84), CUPS 2.3.4, Apple silicon.

Built with Claude 4.8 Opus.

Phomo's menu bar

Install

Download the DMG from the latest release and drag Phomo.app into /Applications dir.

Or build it yourself with ./install.sh. Uninstall with ./install.sh uninstall.

Released builds are signed with a Developer ID certificate and notarised by Apple, so they open normally — no right-click → Open, no quarantine stripping. A copy you build yourself is ad-hoc signed instead, which is fine on your own machine.

On first launch Phomo asks once for admin to create its CUPS queue, and macOS prompts for Bluetooth access on the first print.

Acknowledgements

The M02 ESC/POS command sequences were established by vivier/phomemo-tools, the best-attested public source for them. No code from that project is used here — this is an independent Swift implementation over BLE GATT rather than Bluetooth Classic RFCOMM — but the reverse-engineering work behind those byte sequences is theirs.

License

MIT. See LICENSE.

About

MacOS Phomemo printer driver systray app. Tested with PM02 Pro.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages