Skip to content

Moodarr v0.1.0-beta.1

Pre-release
Pre-release

Choose a tag to compare

@jremick jremick released this 20 Jul 08:28
Immutable release. Only release title and notes can be modified.
08447e8

Moodarr v0.1.0-beta.1

Moodarr's first public beta is an early, self-hosted release of the web/server app for Linux amd64. It helps Plex users find something to watch with natural-language mood search, local MoodRank scoring, Plex availability, and explicitly confirmed Seerr/Jellyseerr request attempts.

This is a beta, not the stable v1.0 release. Configuration, internal APIs, packaging, recommendation behavior, and Admin flows may still change between beta prereleases. The experimental iOS client is outside this release's supported surface.

Highlights

  • Local-first Finder and MoodRank recommendation flows over Plex plus the optional pinned Wikidata catalog.
  • Plex sign-in, item links, posters, and signed-in-user Watchlist actions with Admin-controlled capability defaults.
  • Seerr/Jellyseerr request-state sync, non-writing previews, explicit confirmation, idempotent creation, and uncertain-outcome reconciliation.
  • Redesigned Finder side rail and Admin navigation using Moodarr's Screening Desk design system.
  • Exact-origin session protection with clearer recovery guidance for direct Unraid installs.
  • Non-root, read-only, capability-dropped container defaults with bounded CPU, memory, PID, and temporary-storage limits.
  • Hardened SQLite migrations, backup/restore guidance, catalog recovery, identity-conflict quarantine, and alpha.21 upgrade/cold-rollback validation.
  • Provider-locked official image: recommendation processing remains local, OpenAI cannot be enabled, and the container does not call TMDB or ingest Seerr/TMDB descriptive content.
  • Public supply-chain evidence: immutable OCI digest, SBOM, provenance, GitHub artifact attestation, anonymous pull proof, and exact-digest vulnerability scanning.

Install image

ghcr.io/jremick/moodarr:v0.1.0-beta.1
sha256:c1558d33b1e38c01d7d77171354464dd2b507fd6b84b353f2b0e11372ed73157

Record the resolved digest after pulling. For reproducible deployment and rollback, use the digest-qualified image shown above rather than a mutable reference.

Fresh Unraid installs must pre-create the private Appdata path as UID/GID 999:999 before selecting Apply. Set MOODARR_WEB_ORIGIN to the exact scheme, hostname or IP, and port browsers use.

Optional missing-title catalog

This prerelease includes the separate CC0 asset moodarr-wikidata-20260622-min5-v1.jsonl.gz:

SHA-256: dd25ba6602e1bdb8e6999b0442bc40165e6d4faadd02e91e74e1a24e2b55e85a
Records: 90,397
Request-attempt eligible: 82,865

Plex-only operation does not require this asset. Stop Moodarr and follow the networkless catalog import procedure; do not import while the server is running.

Important behavior and limitations

  • Run Moodarr on a trusted LAN or VPN. Direct public-internet exposure is not supported.
  • The official beta image is AI-off and provider-locked. Source/EXP OpenAI support is experimental and outside this release.
  • Catalog-only request attempts remain visibly unavailable with Availability not checked until Seerr handles an explicitly confirmed attempt.
  • The official image uses Seerr only for operational request state and confirmed writes. It does not use Seerr or TMDB as a descriptive catalog source.
  • Linux arm64, Windows containers, Kubernetes, multi-replica operation, and stable third-party API compatibility are not supported in beta.1.
  • Read Data and privacy before enabling Plex user sign-in or Watchlist writes.

Please report problems through the bug report form and omit tokens, private URLs, media-library details, and raw support bundles from public issues.

Verified identity

  • Source commit: 08447e87df2e1705aa9a79193a52a65fb00724c3
  • OCI digest: sha256:c1558d33b1e38c01d7d77171354464dd2b507fd6b84b353f2b0e11372ed73157
  • Catalog SHA-256: dd25ba6602e1bdb8e6999b0442bc40165e6d4faadd02e91e74e1a24e2b55e85a

See the full changelog for detailed implementation notes.