i9950 Printer Application 0.3.0

Version

Version	0.3.0
Git tag	v0.3.0
Scheme	Semantic Versioning (MAJOR.MINOR.PATCH)
Changelog	CHANGELOG.md

Changes

[0.3.0] - 2026-09-15

Added

• 325×360 mm paper size (om_325x360_325x360mm) in the driver, print dialog, and PAPPL media UI
• Printable-area gate for 325×360 (make fixtures-325, build/t-printable-325x360-600.pdf)
• Fixture ink-coverage check (scripts/check_fixture_ink.py) for sparse mono test assets
• T04/T07 hardware gate fixtures (make fixtures-photo) and scripts/run-hardware-gates.sh
• Developer guide moved out of the root README (docs/12-developer-guide.md)

Changed

• Root README is release/install focused (WIP notice, disclaimer, GitHub Releases install)
• Mono ink coverage abort removed from the production encoder; 8% policy applies to fixtures/tests only

Fixed

• Full-page CUPS rasters no longer shrink into the margin box; crop to printable area and place 1:1 (Job 69)
• 325×360 missing from the web media dropdown because PAPPL skips custom_* names; use PWG om_ form
• Dual menu bar icons on older installs (reinstall 0.2.1+ with I9950_CUSTOM_MENU_BAR)

Known limitations

• Hardware validation remains strongest for A4 plain @ 600 dpi; 325×360 geometry gate printed but not fully matrixed
• Color output uses draft 1-bit CMYK (lighter ink); full multilevel 8-ink modes break geometry on i9950
• PDF printing works via macOS CUPS (application/pdf → PWG raster); direct IPP application/pdf submit is not supported
• Package is unsigned; Gatekeeper may require an override until Developer ID signing and notarization are added

macOS package

Asset	i9950-printer-app-0.3.0-macos.pkg
Signing	Unsigned development package (Gatekeeper may warn)

Install

sudo installer -pkg i9950-printer-app-0.3.0-macos.pkg -target /
launchctl bootstrap gui/501 /Library/LaunchAgents/com.i9950.printer-app.plist

Production distribution still requires Developer ID signing and notarization. See packaging/macos/INSTALL.md and docs/10-release-process.md.

i9950 Printer Application 0.2.1

Version

Version	0.2.1
Git tag	v0.2.1
Scheme	Semantic Versioning (MAJOR.MINOR.PATCH)
Changelog	CHANGELOG.md

Changes

[0.2.1] - 2026-08-24

Added

• macOS menu bar status item with Lucide printer template icon (server mode)

Fixed

• Version string now uses Makefile VERSION instead of hardcoded 0.1.0
• Menu bar icon rendered as a white square (template PNG must be black on transparent)
• Duplicate menu bar icons (PAPPL default folder icon plus custom icon)

macOS package

Asset	i9950-printer-app-0.2.1-macos.pkg
Signing	Unsigned development package (Gatekeeper may warn)

Install

sudo installer -pkg i9950-printer-app-0.2.1-macos.pkg -target /
launchctl bootstrap gui/501 /Library/LaunchAgents/com.i9950.printer-app.plist

Production distribution still requires Developer ID signing and notarization. See packaging/macos/INSTALL.md and docs/10-release-process.md.

i9950 Printer Application 0.2.0

Version

Version	0.2.0
Git tag	v0.2.0
Scheme	Semantic Versioning (MAJOR.MINOR.PATCH)
Changelog	CHANGELOG.md

Changes

[0.2.0] - 2026-08-24

Added

• GitHub Actions workflow to build and publish the macOS .pkg on v* tags
• scripts/release.sh for end-to-end release (build, tag, push, notes + asset on GitHub)
• Document SemVer + version-history template for all docs/ files (docs/11-documentation-standards.md)
• Printable-area and color-swatch gate fixtures (scripts/generate_printable_gate.py, scripts/generate_color_swatches_gate.py)
• Color swatch PDF output for CUPS color PDF gate (t-color-swatches-a4-600.pdf)

Changed

• packaging/macos/build-pkg.sh honors VERSION from the environment (tag-driven releases)
• Locked mono path: 600x600dpi_draftmono + PrintingMode=BW + InputImageType=Grayscale (Job 38 PASS) — see docs/07-architecture-decision.md
• Locked color path: 600x600dpi_draft (1-bit CMYK / IP8500), not medium 600x600dpi 4-bit (Job 52 PASS)

Fixed

• Mono polarity: do not use Whitescale with Canon K (Job 37 invert); normalize 0=white → Grayscale
• Color geometry stretch / right-edge clip from multilevel medium mode; use draft 1-bit color mode
• LaunchAgent plist used invalid serve subcommand; corrected to server

Verified

• Multi-page mono printable gate: Jobs 55/56 (PAGE 1/2 + PAGE 2/2), last-page flush OK
• CUPS → IPP single page: Job 57 via lp -d i9950dev
• CUPS PDF → IPP 2-page: Job 58 via lp -d i9950dev + t-printable-a4-600.pdf
• CUPS 10-page PDF stress: Job 59, user confirmed all 10 pages (T14)
• CUPS color PDF: Job 60, user confirmed swatches (T15)
• Package + system install: T16 — sudo installer, LaunchAgent from /Library/LaunchAgents/

Known limitations

• Hardware validation is A4 plain @ 600 dpi only; higher DPI, borderless, photo media, and additional paper sizes are listed but not gated
• Color output uses draft 1-bit CMYK (lighter ink); full multilevel 8-ink modes break geometry on i9950
• PDF printing works via macOS CUPS (application/pdf → PWG raster); direct IPP application/pdf submit is not supported
• Package is unsigned; Gatekeeper may require an override until Developer ID signing and notarization are added

macOS package

Asset	i9950-printer-app-0.2.0-macos.pkg
Signing	Unsigned development package (Gatekeeper may warn)

Install

sudo installer -pkg i9950-printer-app-0.2.0-macos.pkg -target /
launchctl bootstrap gui/501 /Library/LaunchAgents/com.i9950.printer-app.plist

Production distribution still requires Developer ID signing and notarization. See packaging/macos/INSTALL.md and docs/10-release-process.md.