Repository navigation
Releases
Releases · markoshaq/OpenBGR
v0.12.2
What's new in v0.12.2
Fixed
- Windows: the desktop app no longer crashes on launch when applying the window icon
Full Changelog: v0.12.1...v0.12.2
v0.12.1
What's new in v0.12.1
Added
- Much faster startup: the window opens almost instantly while the AI engine loads in the background
- First processing run after launch is up to 1.7s faster: the one-time engine warmup runs in the background
- Windows: OpenBGR now appears in the Open With dialog for images, GIF and WebP included; re-run the context-menu installer to get it
Fixed
- Processing an animated tab no longer ends in a false error, and frame cutouts survive setting changes
- Auto-Crop on animated tabs now matches the GIF export and follows trim changes
- The auto-crop guide follows aspect preset and canvas fit changes
- Exporting frames individually without a chosen folder no longer fails to build the ZIP
- Sending an animated tab to a batch no longer leaves the animation dock visible or writes PNG bytes into .gif files
- A failed batch run no longer leaves the busy overlay stuck
- The batch-complete summary puts the saved location on its own line
- Holding Space for pan no longer stays armed after the window loses focus
- Importing a model folder with a non-object config.json no longer errors
- Failed or cancelled inference no longer keeps a full-resolution image buffer in memory
- Cold Open With launches and right-click Quick Actions no longer waste up to 1.5s probing for a server that is not running
- Right-clicking images while the app is still launching now reuses the warming engine instead of cold-starting a second one
- The Settings storage summary no longer underreports the app size right after launch
- Model size lookups no longer retry every minute when the network cannot answer
- Closing a tab that is processing now dismisses its open confirmation dialog
- Double-clicking RUN BATCH can no longer open two destination pickers
OPENBGR_PORTis honored consistently by the server and its warm-instance probes- Malformed session token headers now get a clean rejection instead of a server error
Security
- The dev-only
*.localhostwildcard was removed from the Host allowlist - The session token file is created mode-0600 instead of being chmod'd after writing
Full Changelog: v0.12.0...v0.12.1
v0.12.0
What's new in v0.12.0
Added
- Animated GIF and WebP input with a frame filmstrip, playback controls, and a Start/End trim range with steppers
- Animated processing runs the trimmed frame range with live progress and cancel; refinement, backdrop, and export settings apply to every frame
- Animated GIF export honors crop, scale, dimensions, and backdrops; trimmed ranges get a
-f<start>-<end>filename tag - Individual frame export as PNG, WebP, JPG, or mask, to a folder or a ZIP
- CLI and Quick Action detect animated inputs and output animated cutouts
- Auto-crop to subject with adjustable padding and a live crop guide
- Edge Shift and Edge Feather sliders with instant preview refinement
- Blur and custom photo backdrops alongside grid and flat colors
- Aspect ratio presets and a Fit / Stretch canvas toggle
- Offline mode: Block Internet Access cuts all Hugging Face traffic, and checkpoints can be imported manually under Settings > Models
- Open Recent, Reopen Closed Tab (Shift+Cmd/Ctrl+T), and Copy Original Image in the File and Edit menus
- Retry Failed button re-runs only failed batch items
- Open action after export or batch opens the saved file or folder in the file manager
Changed
- Small images and animation frames skip upscaling to the model's full resolution: lower GPU memory and much faster frames
- Models load in FP16 at startup (~1.4 GB less RAM); machines under ~10 GB default to Lite
- Animation decoding caps frame count and pixel memory, warning when frames are dropped
- Lower memory usage after processing high-resolution images
- Native OS menu bar on macOS and Linux, with a macOS Window menu; Windows and the browser keep the in-app bar
- Faster repeat exports with an accurate file size readout, including the real encoded size for animations
- New tabs and newly loaded images start with fresh sidebar settings instead of inheriting the last image's
- Export folder picking works in a plain browser too
- Model dropdown hides the active model and shows its use case under the name
- Refine cache skips images over ~64 MP so very large jobs stop pinning hundreds of MB between jobs
- Model disk sizes behind /api/status are cached for 30 seconds instead of rescanning the Hugging Face cache per call
- The frontend entry point is now a thin boot file: menus, keyboard, file open and drop, paste, Open Recent, backdrop, model dropdown, tooltips, settings, workspace controls, stage input, and the
window.openBGRbridge live in side-effect-free modules understatic/, each with unit tests - The largest frontend modules are split by responsibility: export (pipeline, UI sync, IO actions, ZIP writer), tabs (lifecycle, segmentation), and batch (queue, panel, runner), with a small event bus for cross-module signals
- The frontend import graph is now acyclic and stays that way: an architecture test enforces acyclic imports, side-effect-free modules, and bounded file sizes
- Frontend checks now include a repeatable headless-browser smoke test (
npm run test:smoke) that exercises menus, paste, zoom, and settings in a real browser - Keyboard shortcut table, text-field gate, and platform label rewrites moved into
static/shortcuts.jswith unit tests - Release builds on pull requests now run only when the
build-releaselabel is attached; tags and manual dispatch are unchanged - Past release notes are kept in a collapsed section below; GitHub release notes still extract only the current section
Start Mac.commandrenamed tostart_mac.command
Fixed
- Desktop export no longer opens a white page with the raw file; it uses a native save dialog
- Auto-Crop on animations unions every trimmed frame so moving subjects aren't clipped
- Keyboard shortcuts and image paste no longer fire while typing in text fields
- Start/End frame entries clamp to the valid range
- The toast action no longer turns dark on hover
- Offline mode, session token persistence, and settings writes warn instead of failing silently
- The refine path raises a real 500 on a missing image instead of an assert that
-Ostrips - Download progress falls back to phase-only with a warning when Hugging Face internals change
- Unknown CLI flags fail with a usage error instead of being silently ignored
- Signal exits report 128 + signum so killed processes no longer report success
- Runtime dependencies now have upper bounds so unvetted majors can't auto-resolve into releases
- Shared UI constants (accents, tier aliases, tier keys) are drift-checked by the repo integrity test
- Test suite runs on Python 3.10 via a tomli fallback for tomllib
Security
- Reject non-loopback Host headers so the session token cannot leak through DNS rebinding
- /api/save only writes into folders picked through the app's folder dialog
- Upload bodies are capped at 256 MB before buffering
Full Changelog: v0.11.3...v0.12.0
v0.11.3
What's new in v0.11.3
- Mutating API endpoints now require a per-session token, blocking drive-by writes and deletes from other sites
- Edge refinement on 24MP photos: separable filters up to 67x faster; despill 4.0s down to 1.6s, defringe 2.1s down to 1.5s
- Batch ZIP streams files to disk (~2GB peak down to one at a time) and reports the 4 GiB limit instead of writing a corrupt archive
- FP16 model compaction streams per-tensor: ~1.3GB peak RAM down to ~424MB
- Native file dialogs use one-shot HTTP grants: no base64, no 48 MB limit, parallel multi-file fetches
- Fixed Restart exiting instead of restarting, and Quick Action batches duplicating files after a delegation timeout or misreporting a cancel as failures
- /api/refine calls serialize and coalesce instead of stacking ~1GB of composes per toggle click
- macOS clipboard probe reads the pasteboard counter instead of spawning osascript per focus (172ms down to microseconds); Finder-copied images now paste
- Fixed stuck pan/split drag after off-window mouse release and dead tabs from non-image drops
- Misc: cheaper preview/loupe/batch-panel updates, no runaway timers or .venv walk on /api/status, slower pending-file poll, bounded caches, batch saves off the event loop
Full Changelog: v0.11.2...v0.11.3
v0.11.2
What's new in v0.11.2
- Batch queue polish: plain background, no footer hint, header shows just the image count
- Batch rows get checkboxes (with a toggle-all) to pick which images run; skipped rows dim
- Right-click a tab to rename it; batch tabs keep their live "(N)" count
- Processing overlay shows a live elapsed timer; ELAPSED at the bottom only shows the finished total
- Settings reorganized: GENERAL is now the default tab and System info moved under About
Full Changelog: v0.11.1...v0.11.2
v0.11.1
What's new in v0.11.1
- Quitting, restarting, or closing the window no longer hangs while a model is still downloading; the app now exits immediately
- Cancelling a model download now actually stops the transfer instead of letting it finish in the background
- Installing or uninstalling a model while another is loading no longer freezes the app; it responds right away with a busy status
- More reliable memory cleanup during image processing and icon generation
- Version number now comes from a single source instead of being hardcoded in several places; dev checkouts report a dev version rather than a stale one
- Internal reorganization: Quick Action split into focused modules (runner, settings, native integration), icon renderer moved into the package, tests organized by area
Full Changelog: v0.11.0...v0.11.1
v0.11.0
What's new in v0.11.0
- Real progress for model downloads and processing, no more generic spinner
- Tab shortcuts (Cmd/Ctrl+1-9, Ctrl+Tab) and a Keyboard Shortcuts pane in Settings
- Opening files while already running adds tabs instead of failing on the port
- Restart OpenBGR menu item
- Windows: dark titlebar, app icon on OpenBGR.exe, hidden console
- Linux: kdialog dialogs, clipboard fixes, .desktop icon
- Context menus all say "Remove Background with OpenBGR"
Plus ~25 smaller bug fixes and adjustments across all platforms.
Full Changelog: v0.10.1...v0.11.0
v0.10.1
What's new in v0.10.1
- Quick Action notifications arrive reliably again; banner icon fixed
- Non-image files passed at launch are ignored instead of confusing the app
- Repo housekeeping: contributing guide, code of conduct, issue and PR templates
Full Changelog: v0.10...v0.10.1
v0.10
First release — OpenBGR 0.10
- Local background removal studio powered by BiRefNet: six model tiers, FP16 on CUDA and Apple Silicon, CPU works too
- Multi-tab workspace with a batch queue, per-tab settings, and dragging rows out to their own tabs
- Stage view with pinch/two-finger zoom and a Z-key 4x loupe for hair and edges
- Edge tools: defringe, color-spill suppression, alpha matting, and a shadow/reflection cutoff
- Export PNG, WEBP, JPG, or a mask at any scale or exact pixel size, previewed live
- Native window with OS menus, themes, and Save-As/folder dialogs
- One-command setup on macOS, Windows, and Linux
Full Changelog: https://github.com/markoshaq/OpenBGR/commits/v0.10