Image2Tools v0.2.2

Experience and open-source presentation release on top of v0.2.1. Real
OpenAI (gpt-image-2) and Gemini (gemini-3.1-flash-image) API acceptance has
been re-run against a cost-approved OpenAI-compatible image aggregator endpoint
(see docs/release/evidence.json).

Experience

• Result viewer reworked into a dedicated image preview: mouse-wheel zoom that
  no longer scrolls the surrounding panel, double-click to open a full preview,
  and drag-to-pan when zoomed in. Zoom controls move into a canvas overlay.
• Provider info collapses to a compact inline chip beside the key status to
  save sidebar space.
• History gains newest/oldest sorting, and history result images can be dragged
  into the reference area.
• Drag-and-drop image files from the OS onto the reference area to import them.

Fixes

• External drag-drop upload now resolves dropped file paths through
  webUtils.getPathForFile instead of the non-standard File.path, which
  Electron 32+ removed — drag-drop import works again in packaged builds.
• Windows in-app updater timeout increased from 30s to 10 minutes for large installer downloads.
• Windows in-app updater now uses PowerShell-based process exit handling to prevent NSIS installer blocking.

Open-source presentation

• README showcase now uses real product screenshots instead of placeholders.
• Added a Download & Install section with macOS Gatekeeper quarantine bypass
  (xattr -dr com.apple.quarantine), Windows SmartScreen guidance, and SHA256
  verification instructions against docs/updates/latest.json.
• README header adds dynamic badges (release, CI, last commit, stars) alongside
  the license/platform/stack badges.
• GitHub About description and repository topics expanded for discoverability.

---

Install

Download the macOS dmg or Windows installer below. These are unsigned preview builds — your OS will warn on first launch (macOS Gatekeeper / Windows SmartScreen). This is expected for an unsigned open-source preview and does not mean the app is unsafe. See the Download & Install guide for one-time bypass steps. Signing & notarization are tracked in #116.

Verify your download (optional)

Platform	File	SHA256
macOS arm64	Image2Tools-0.2.2-mac-arm64.dmg	d4f8974ef14f86562aa7917888633cbe4dfd21f75b72d43e40469a3c159e23a0
Windows x64	Image2Tools-Setup.exe	e25e92b6c7dbd4da2621fffd1c8db9664232b054cbd79b6ca0b06d381043db61

Acceptance status

Real gpt-image-2 and gemini-3.1-flash-image API acceptance passed; Windows/Linux native package gates passed; update manifest assets verified. macOS Developer ID signing/notarization is a tracked non-blocking enhancement (#116).

Important: v0.2.0 users must manually install once

The Windows in-app updater fix only applies to v0.2.2+. v0.2.0 users cannot auto-update due to the old timeout/launcher code in their installed client. Please manually download and install v0.2.2 once, then future in-app updates will work normally.

---

What's Changed

• Fix Windows in-app updater timeout and process blocking by @Bliveren in #114
• v0.2.2: image preview viewer, history sort + drag, drag-drop upload by @Bliveren in #115

Full Changelog: v0.2.1...v0.2.2

Image2Tools v0.2.1 (unsigned preview)

Image2Tools v0.2.1 (unsigned preview)

Bugfix and UX release based on post-0.2.0 user feedback.

Changes

• Reference-image editing and inpaint requests now run without SSE streaming, fixing aggregator/proxy failures such as provider returned non-SSE response for streaming request on /images/edits.
• The provider dropdown has been removed. The app preserves saved configuration and relies on model discovery to infer provider/model availability.
• The workspace mode tabs are simplified to Text to image and Image to image. Masks are now optional under Image to image while internal generate/edit/inpaint routing remains intact.
• Draft restore, history reuse, Gemini guided-region wording, and General fallback behavior remain compatible with the v0.2.0 multi-model workflow.

Validation

• PR #113 CI passed: build/mock verifier, macOS package, Windows package, Linux package.
• Local release validation passed on macOS arm64:
  • pnpm install --frozen-lockfile
  • pnpm build
  • pnpm verify:mock-api
  • pnpm verify:mock-gemini-api
  • pnpm verify:mock-model-discovery
  • pnpm verify:release-evidence
  • pnpm package:mac
  • pnpm verify:release:mac

Release Status

This is an unsigned/ad-hoc signed preview prerelease. macOS artifacts are not Apple-notarized, so Gatekeeper may warn on first launch. Real OpenAI/Gemini API acceptance and Developer ID signing/notarization remain pending in docs/release/evidence.json.

What's Changed

• v0.2.1: streaming-edit fix, provider auto-detect, two-tab workspace by @Bliveren in #113

Full Changelog: v0.2.0...v0.2.1

What's Changed

• v0.2.1: streaming-edit fix, provider auto-detect, two-tab workspace by @Bliveren in #113

Full Changelog: v0.2.0...v0.2.1

Image2Tools v0.2.0 (unsigned preview)

Image2Tools v0.2.0 Release Notes

Status: unsigned preview prerelease. macOS and Windows artifacts are published for evaluation. macOS builds are ad-hoc signed and not Apple-notarized, so Gatekeeper may warn on first launch (right-click > Open, or remove the quarantine attribute). Developer ID signed and notarized distribution is tracked for a future release.

Highlights

• Multi-model workspace for GPT Image 2, Nano Banana 3, and General launch flows.
• Refined left sidebar with separate model configuration, launch model, parameter configuration, draft, notice, and update areas.
• Model configuration now runs automatic connection checks on startup and after saved API config changes. The UI shows connection status beside the model configuration title and surfaces friendly failure guidance.
• Model discovery can infer provider/model availability from the configured API and enables launch families based on discovered models rather than only the selected provider label.
• OpenAI provider path keeps GPT Image 2 generation, editing, exact-mask inpainting, streaming partial previews, downloads, and history.
• GPT Image 2 multi-output generation now uses non-stream requests when count is greater than one, backfills providers that return fewer images than requested, and shows selectable final-result thumbnails in the canvas.
• Gemini provider path adds the app's Nano Banana 3 launch target for discovered Gemini image models such as gemini-3.1-flash-image and gemini-3-pro-image, with generateContent image generation, reference-image editing, guided-region editing, and Gemini-specific controls.
• Launch model buttons now include concrete discovered-model choices when multiple compatible models are available under the same launch family.
• General launch mode is a minimal fallback for discovered non-focused image models. Gemini General supports prompt and reference images; OpenAI and Custom General use a prompt-only OpenAI-compatible /images/generations contract.
• History entries now retain provider/model context so reused prompts restore the matching launch model and parameters.
• Clearing all recent-task history now requires explicit confirmation.
• Update checks now default to the raw GitHub manifest URL to avoid the previous GitHub Pages 404. The sidebar shows an automatic up-to-date status, saves the current draft before update launch, and starts the Windows NSIS installer in silent mode with app restart after installation.

Verification Gates

Before publishing v0.2.0, run:

pnpm build
pnpm verify:mock-api
pnpm verify:mock-gemini-api
pnpm verify:mock-model-discovery

OpenAI real API acceptance is cost-gated through:

IMAGE2TOOLS_API_KEY=sk-... IMAGE2TOOLS_REAL_API_ACCEPT_COST=1 pnpm verify:real-api

Gemini / Nano Banana 3 real API acceptance is cost-gated through:

IMAGE2TOOLS_GEMINI_API_KEY=... IMAGE2TOOLS_REAL_GEMINI_API_ACCEPT_COST=1 pnpm verify:real-gemini-api

The verifier covers discovery, generation, reference editing, and guided-region editing. Do not mark Gemini real acceptance complete until the verifier and app-level history/download checks pass with a real Gemini key.

Release package verification remains platform-specific:

pnpm verify:release:mac
pnpm verify:release:windows
pnpm verify:release:linux

Re-run the secret scan in SECURITY.md after every release-note or packaging metadata update.

The app package metadata is 0.2.0. For this unsigned preview, docs/updates/latest.json
publishes the darwin (arm64 dmg) and win32 (x64 installer) assets with verified URL,
sha256, and sizeBytes metadata generated from the exact uploaded artifacts. When
Developer ID signed and notarized macOS artifacts become available, regenerate the
manifest from the signed build and supersede this preview.

What's Changed

• Document multi-model v0.2 plan by @Bliveren in #71
• Stabilize Windows silent installer verification by @Bliveren in #75
• Add multi-model contracts and state migration by @Bliveren in #73
• Add Gemini image mock verifier by @Bliveren in #72
• Add expandable model-aware history panel by @Bliveren in #74
• Update multi-model progress checklist by @Bliveren in #76
• Extract OpenAI image provider adapter by @Bliveren in #77
• docs: update multi-model phase 3 progress by @Bliveren in #78
• Add Gemini image adapter runtime by @Bliveren in #80
• Add model discovery UI slice by @Bliveren in #79
• docs: update multi-model phase 2 and 4 progress by @Bliveren in #81
• Add Gemini renderer parameter controls by @Bliveren in #82
• docs: update Nano UI progress by @Bliveren in #83
• Add General fallback mode by @Bliveren in #84
• docs: update General fallback progress by @Bliveren in #85
• Add mock model discovery verifier by @Bliveren in #86
• docs: update multi-model release security docs by @Bliveren in #87
• Add renderer multi-model smoke tests by @Bliveren in #88
• Add provider-aware General fallback by @Bliveren in #89
• docs: sync multi-model smoke evidence by @Bliveren in #90
• docs: sync final General fallback status by @Bliveren in #91
• Add real Gemini API verifier by @Bliveren in #92
• Require explicit Gemini real API cost gate by @Bliveren in #93
• Add renderer UI acceptance smoke coverage by @Bliveren in #94
• Stage v0.2.0 release metadata by @Bliveren in #95
• Require update manifest asset sizes by @Bliveren in #96
• Add update manifest asset helper by @Bliveren in #97
• Add release evidence validation by @Bliveren in #98
• Guard release checklist evidence alignment by @Bliveren in #99
• Refresh completion audit for v0.2.0 by @Bliveren in #100
• Refresh multi-model plan status by @Bliveren in #101
• Link release evidence gates to trackers by @Bliveren in #104
• Clarify v0.2.0 release blockers by @Bliveren in #105
• Record Windows full-install evidence by @Bliveren in #106
• Record Windows native release completion by @Bliveren in #107
• Enable capability-based model launches by @Bliveren in #108
• Add model variants and robust Gemini image parsing by @Bliveren in #109
• Parse Gemini text data URL images by @Bliveren in #110
• Refine sidebar settings workflow by @Bliveren in #111
• Refresh README and release notes by @Bliveren in #112

Full Changelog: v0.1.0...v0.2.0

Image2Tools 0.1.0

Image2Tools 0.1.0 is the first MIT open-source release prepared from PR #70.

Highlights:

• Adds MIT license, security policy, and open-source audit notes.
• Refreshes the README with English and Simplified Chinese language sections, local project showcases, icon assets, and Nowo / Corgnitor company attribution.
• Updates the desktop app with bilingual UI support, safer update manifest handling, local asset preview handling, improved OpenAI image API behavior, and API-key redaction in error paths.
• Adds and hardens release verification for macOS, Linux, and Windows packaging.

Validation:

• Local pnpm package:mac passed on macOS arm64 from the v0.1.0 merge commit.
• pnpm verify:release:mac passed with two install/launch/remove cycles.
• Local pnpm build passed after merge: 5 test files, 38 tests.
• pnpm verify:mock-api passed.
• Production dependency licenses are MIT / ISC.
• GitHub CI passed: Build/mock verifier, macOS package, Linux package, and Windows package.

Attached assets:

• Image2Tools-0.1.0-mac-arm64.dmg
  SHA256: 410f53eb5598eab9f29b2853f38035c59a711665b884c6f20573ad5ebf23081f
• Image2Tools-0.1.0-mac-arm64.zip
  SHA256: c4addd8952377bca7ed60f3fd8d0cfc9fa26f2a2409adb08cb6d19d09c3c028d

Distribution note:

• The attached macOS arm64 binaries are unsigned/not notarized. Gatekeeper warnings are expected until signing and notarization are completed.
• The older v0.1.0-mac-unsigned release remains available only as a historical unsigned macOS arm64 preview and is not the current official 0.1 release.

Image2Tools 0.1.0 unsigned macOS preview (superseded)

Superseded by the official Image2Tools 0.1.0 release:
https://github.com/Bliveren/image2tools/releases/tag/v0.1.0

This release is kept for historical access to the original unsigned macOS arm64 preview build from May 2026.

Original scope:

• Unsigned macOS arm64 preview build for local testing.
• Assets were built from the older v0.1.0-mac-unsigned tag, not from the current official v0.1.0 tag.

Original verification before upload:

• pnpm package:mac passed on macOS arm64.
• pnpm verify:release:mac passed with two install/launch/remove cycles.

This is not a signed or notarized production distribution. Gatekeeper warnings are expected until signing and notarization are completed.