'use client' export default function HowItWorksPage() { return (

How it works

How Magent works for users

Use Magent to find a request, watch it move through the pipeline, and know when it is ready without constantly refreshing the page.

What Magent is for

Track requests

Search by title, year, or request number to open the request page and see where an item is up to.

See live progress

Request status, timeline events, and download progress update live while you are viewing the page.

Know when it is ready

When the request is fully imported and available, Magent shows it as ready and links you through to Jellyfin.

The request pipeline

  1. You request a movie or show through Seerr.
  2. Magent picks up the request and shows its current state.
  3. The automation stack searches and downloads it if it can find a valid release.
  4. The file is imported into the library.
  5. Jellyfin serves it once it is ready to watch.

What the statuses usually mean

Pending

The request exists, but it is still waiting for approval or the next step.

Approved / Processing

The request has been accepted and the automation tools are working on it.

Downloading

Magent can show live progress while the content is still being downloaded.

Ready

The item has been imported and should now be available in Jellyfin.

Partial / Waiting

Part of the workflow completed, but the request is still waiting on another service or on content becoming available.

Declined

The request was rejected or cannot proceed in its current form.

Live updates you can expect

1

Recent requests refresh automatically

Your request list and landing-page activity update automatically while you are signed in.

2

Request pages update in real time

State changes, timeline steps, and downloader progress are pushed to the page live.

3

Ready state appears as soon as the import completes

Once the content is actually available, Magent updates the request page without a hard refresh.

User actions you may see

Open request

Jump into the full request page to inspect the current state and activity.

Open in Jellyfin

Appears when the request is ready and Magent can link you through for playback.

Search + auto-download

Only appears for accounts that have been granted self-service download access by the admin team.

My invites

If your account is allowed to invite others, you can create and manage invite links from your profile.

Invites and signup

  1. You receive an invite link by email or directly from the person who invited you.
  2. You sign up through Magent and your account is linked into the media stack.
  3. Your account defaults apply based on the invite or your assigned profile.
  4. You sign in and track requests from the landing page and your request pages.

If a request looks stuck

A waiting request usually means no usable release has been found yet, the download is still in progress, or the import has not completed. Magent will keep updating as the underlying services move forward.

) }