Bgbgone

bgbgone — the ultimate UNIX-style background remover for macOS.

AI-driven via Apple's on-device Vision framework (VNGenerateForegroundInstanceMaskRequest) and Image Playground (ImageCreator) for generative backgrounds. 100% on-device, no network, no API keys, single Homebrew-installable binary.

Highlights

• Zero-config default: bgbgone in.jpg > out.png emits a transparent PNG cutout
• Background replacement: --bg color:#hex | image:path | gen:"prompt"
• Output formats: PNG, JPG, WebP, HEIC, AVIF, TIFF with --quality knob
• Edge tuning: --feather, --crop, --mask-only
• Algorithm picker: --algo auto|vn-remove|vn-mask|person|sky|saliency
• Multi-instance via VNInstanceMaskObservation with {base}/{n}/{n:NN}/{ext} naming
• Batch via --out-dir, glob expansion, stdin/stdout pipes
• Structured --json / --ndjson output for shell pipelines
• Refuses binary writes to a TTY (curl-style)
• NetworkGuard URLProtocol shim hard-blocks http/https/ws/wss at runtime
• Pipe-composable with sibling tools apfel (LLM), auge (vision), kern (embeddings), ohr (STT)

Test pyramid

100% green at v0.1.0:

• 60 pure-Swift unit tests (no XCTest): argument parser, colour parser, instance-naming templates, network-scheme block list
• 44 e2e integration tests against 12 strict-PD Wikimedia fixtures (PD-NASA + PD-old — no Creative Commons), spawning the built binary and exercising every flag

Install

```bash
brew tap Arthur-Ficial/tap
brew install Arthur-Ficial/tap/bgbgone
```

Or from source: `git clone`, then `make install`. Requires macOS 26+ and Command Line Tools.

Asset

`bgbgone-0.1.0-arm64-macos.tar.gz` — single-binary release for Apple Silicon Macs.

`sha256: d4ca3cdec1e4c059afbf371afd774090af0587da7d51e53ff4e4b22acfc5f195`

🤖 Generated with Claude Code