// OPENBOX DOCS
Activity Center & Durable Operations
Monitor running tasks, background operations, cancellations, and restart recovery.
OpenBox manages all background operations through the durable Operation Service (crates/openbox-store/src/operations.rs), backed by operations.json in your data directory.
Features
- Activity Drawer: Click the Activity button (
#activityButton) in the top bar to inspect running and historical operations. In 3.0 routine running-job badges are calm neutral pills (red is reserved for errors), filters are a 2-column row, internal job types are humanized, and redundant single-job "Grouped by run" duplicates are removed. - Real-Time Progress: Live Server-Sent Events (SSE) stream progress updates, byte counters, and status messages (
GET /api/v2/events). - Cancellation & Safety: In-flight operations can be cancelled cleanly without leaving corrupted or half-written states (
POST /api/v2/jobs/cancelwithjob_idin the JSON body). - Restart Recovery: If OpenBox is closed or restarted while an operation is running, the task is marked
interrupted. You can resume or retry it with one click.
Supported Operations
- Library Imports: Folder scanning, archive inspection, and storefront auto-imports (
storefront.auto_import). - Metadata Synchronization: LaunchBox Games Database downloads and batch matching (
metadata.db_sync,metadata.match_preview,metadata.apply). - Media Downloads: Artwork, screenshot, and video fetching (
media.bulk_download,media.cleanup,media.memories_import). The media queue is durable: it survives restarts, supports pause, resume, cancel, retry, and per-item errors, and reportsitems,queue, and per-statecounts. - Storefront scans and imports: Startup scans report per-source progress, skip sources with no library games, and stop after a 30-second budget while keeping partial results.
- ScreenScraper and SteamGridDB: hash scraping and artwork jobs (
screenscraper.match,screenscraper.apply,steamgrid.match,steamgrid.apply). - Library Export: JSON/CSV projections queued as durable jobs (
library.export). - Clips and Reels: local reel creation (
clips.reel). - Emulator Management: Flathub emulator installations and updates.
- Backups: Library backup creation and save state archiving.