Repository navigation
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