Unmanic/unmanic 0.4.0

[RELEASE] v0.4.0

on GitHub

• [NOTE] v0.4.0 is a pretty large platform update focused on extensibility, integrations, and operational stability.
  This release introduces significant groundwork for plugin developers, including new metadata and workflow capabilities that make it easier to build richer community plugins and reduce duplicated processing between plugins. It also
  expands API coverage to simplify linked-installation/remote flows and improve third-party app integrations with Unmanic.

  Logging and metrics handling have also been substantially improved, with better behavior for high-volume environments and stronger integration paths into Unmanic Central for cross-installation visibility.

  If you have not tried Unmanic Central yet, this is a great time to start:

  • https://central.unmanic.app/
  • https://docs.unmanic.app/#unmanic-central

  Documentation has also been significantly improved in this cycle, both for operating Unmanic and for writing plugins, with a strong focus on helping community contributors build, test, and ship community features more effectively.

  Supportership has been expanded and streamlined.
  Unmanic now supports GitHub Sponsors (including one-off and ongoing sponsorships), Patreon, and Discord role-based support access (via the new in-house Discord bot for contributors/testers/community helpers).
  Lifetime supportership is now available once a total of $36 USD has been contributed over time (including a one-off GitHub Sponsor payment), so users can unlock supporter features without needing permanent subscriptions. Patreon tiers now include $3, $7, and a one-time-friendly $36 path.

  A new Project Funding system is also available for ongoing supporters, allowing supporters to convert sponsorship into credits and prioritize optional feature proposals:

  • Project Funding System Docs

Service

• [NEW] Add bind-address configuration to limit listener exposure to specific interfaces (for example localhost-only setups). (contributed by AGSPhoenix)
• [NEW] Add SSL/TLS server options (certificate/key paths) and provide Docker Compose SSL examples for HTTPS deployments. (contributed by chrischapman/chappie)
• [NEW] Add the UnmanicFileMetadata helper and metadata API/models so file metadata persists across moves/renames and can be reused by plugins.
• [NEW] Add task/file fingerprinting (including faster hashing and xxhash support) to improve file-change detection and plugin data reuse.
• [NEW] Add pending/test endpoint to test candidate files before adding to pending tasks.
• [NEW] Add setting to compress historic tasks instead of deleting them, reducing DB growth while preserving history.
• [NEW] Add completed-task metric/data logging for Unmanic Central.
• [IMPR] Improve linked-installation behavior, including local copy-path handling (fallback away from HTTP transfer when shared storage is available), public-address config, and supporter auto-linking/discovery flow. (local-copy
  improvements contributed by yajrendrag)
• [IMPR] Improve log handling with larger UI tail windows, better buffering controls/retention behavior, and cache-path optimizations when no remote endpoint is configured.
• [FIX] Fix proxy/header and linked-installation API issues that could break remote instance communication.
• [FIX] Fix trial-session noise where non-supporter trial flows were still attempting supporter-only linked-installation fetches.
• [FIX] Fix websocket/system-log behavior so system logs are not sent after websocket close. (thanks kmarius)
• [FIX] Fix excessive temp JSON backup/log artifacts and related cleanup paths that could bloat disk usage.

Plugin executor

• [NEW] Expand plugin developer CLI tooling (reload, uninstall by ID, scripted plugin creation, sample/test data install, test-file targeting, dependency install helpers).
• [NEW] Add PluginChildProcess current-command reporting so active subprocess command detail is visible in UI/monitoring.
• [NEW] Add missing task_id fields in runner schemas/emitted data for better traceability.
• [IMPR] Improve plugin settings/config rendering robustness and plugin configuration UX.
• [IMPR] Strengthen plugin/task data-sharing foundations for cross-plugin reuse (for example shared probe results and metadata-backed workflows).
• [FIX] Fix worker regressions around plugin pass loops and command reporting.
• [FIX] Fix paused-worker PID stat monitoring and worker in-progress naming/status edge cases.
• [FIX] Fix library scan progress/reporting issues, including long-running test completion handling.

Docker

• [NEW] Rebase container base image to ubuntu:24.04, removing LSIO base-image dependency.
• [NEW] Add support for running as non-root user configurations (optional), with broader startup/permission hardening.
• [NEW] Add Vulkan packages/tools and ffprobe helper utilities for plugin and developer workflows.
• [IMPR] Update packaged runtime dependencies, including Node.js v22 and Jellyfin FFmpeg v7.
• [IMPR] Add sqlite maintenance on startup to mitigate long-term DB bloat.
• [FIX] Harden entrypoint/init scripts so permission/config/plugin-init errors do not prevent startup.
• [FIX] Fix startup regressions around /app//config creation, wrapper-script usage, missing group IDs, HOME handling, executable bits, and Docker run script reliability.
• [FIX] Improve NVIDIA patching behavior so patch-fetch/network issues no longer hard-fail container startup.

Front-end

• [NEW] Add linked-installation switching in UI (view/manage multiple linked instances from one installation).
• [NEW] Add support/funding proposal integration in Help/Support UI.
• [NEW] Add trial/supportership welcome dialog and improved supporter flow messaging.
• [NEW] Add library list search/filtering.
• [NEW] Add curated third-party plugin repository discovery from plugin installer UI.
• [IMPR] Overhaul plugin installer UX/layout (including mobile behavior) and modernize frontend packages/refactors.
• [IMPR] Improve pending/completed bulk actions and large-list handling performance.
• [IMPR] Increase worker log lines shown in worker details and move app logs into a dedicated Help/Support drawer.
• [FIX] Include multiple login/session and UI consistency fixes across the frontend syncs.
• [FIX] Correct Swagger base URL rendering to match the active host/port context.