Bgbgone

What's new

Removed --bg gen: (Apple Image Playground). Apple's ImageCreator throws backgroundCreationForbidden for any process not launched as a foreground .app. The only workaround — wrap bgbgone in a synthesized .app and open --args — steals the menu bar from your frontmost app on every invocation and is therefore incompatible with the 100%-scriptable goal. Stripped: GenerativeBg.swift, the --style flag, the gen line in --check, all gen syntax from --help. --bg gen: now errors with a clear explanation. Pre-generate the background in any tool and use --bg image:<path>.

Added 4 vintage public-domain product photos to the fixture set (now 16 total):

• Singer sewing machines poster (J. Ottmann Lith. Co., 1892)
• Underwood typewriter advertisement (Popular Science Monthly, 1909-06-12)
• Edison + phonograph (Levin C. Handy, c.1877)
• Winchester advertisement (Rod and Gun in Canada, 1909-11)

Each verified strict PD via Wikimedia metadata; full provenance in Tests/fixtures/LICENSES.md.

Expanded README with 11 worked example sections — every image is a real bgbgone invocation, all reproducible via bash scripts/make-readme-examples.sh:

• 16-subject cutout grid
• color / image / fit-mode showcases
• feather / crop / padding / shadow / mask-only progression
• 5-algorithm comparison across 3 subjects
• Mona Lisa world tour (6 verifiable PD backgrounds)
• Pipeline: bgbgone → auge --classify with real classify output
• Products: src → --mask-only → cutout → hilarious new context (typewriter on the Moon, Edison in the Hubble nebula, Singer surfing the Great Wave, Winchester hunting on Mars)

Tests: 60/60 unit + 48/48 integration green.

Install

Homebrew

brew tap Arthur-Ficial/tap
brew upgrade bgbgone   # or: brew install Arthur-Ficial/tap/bgbgone

From source

git clone https://github.com/Arthur-Ficial/bgbgone.git
cd bgbgone
make install

Direct binary

curl -L https://github.com/Arthur-Ficial/bgbgone/releases/download/v0.1.8/bgbgone-0.1.8-arm64-macos.tar.gz | tar xz
mv bgbgone /usr/local/bin/

SHA-256: 0bc59fccf2433d244d073ce3ff91f0e281cebe02cf4e422806f8b6abb163e36b

Migration from v0.1.x

If you were using --bg gen:<prompt>:

# v0.1.1 (no longer works):
bgbgone in.jpg --bg gen:"sunset beach" -o out.png

# v0.1.8 — pre-generate with Apple Image Playground (or any other tool), then:
bgbgone in.jpg --bg image:./generated-sunset-beach.png -o out.png