Task Manager

The Task Manager gives you a real‑time view of every background worker running in your browser, the tasks each worker is processing, and a way to cancel work that is stuck or no longer needed. Open it when a long import, transcription, or AI job seems slow, or when you want to confirm a job has actually finished.

Opening the Task Manager

The Task Manager lives at /task-manager in the web app.

• Click Task Manager in the sidebar, or
• Navigate directly to the route from the menu

You can keep the Task Manager open in another tab while you work — the panel updates in real time as workers and tasks change state.

What the Panel Shows

Workers

A worker is a background process that handles a specific kind of job, such as:

• Library sync — syncing media, recordings, and notes with the server
• Transcription — running speech‑to‑text on uploaded audio or video
• AI jobs — translations, dictionary lookups, and chat completions
• Local models — downloading and running on‑device AI models

Each worker card shows:

Field	Description
Worker name	Human‑readable label, e.g. Library Sync
Worker ID	Unique identifier used internally
Worker type	The kind of worker (sync, ASR, LLM, etc.)
Status	Current lifecycle state (see below)
Task counts	How many tasks are running, pending, and finished

Tasks

Each task inside a worker represents one unit of work, such as “transcribe this audio file” or “translate this sentence.” Tasks are grouped by status so you can scan the panel quickly:

• Active Tasks — running or pending; the panel sorts these so the most recent job is at the top
• Completed Tasks — finished, failed, or cancelled; scrollable history of recent work

Each task row shows its task ID, the worker that owns it, the time it started, and how long it has been running (or how long it took to finish).

Task Status

Tasks move through the following states:

Status	Meaning
pending	Queued, waiting for the worker to pick it up
running	The worker is actively processing this task
completed	Finished successfully
failed	The worker hit an error — see logs or retry
cancelled	You or the system stopped the task before completion

A status badge next to each task uses both color and an icon, so you can tell at a glance which jobs need attention.

Worker Status

Status	Meaning
initializing	The worker is starting up
ready	The worker is idle and accepting tasks
running	The worker has at least one active task
error	The worker crashed or hit a fatal error

Cancelling a Task

If a task is stuck, taking too long, or you no longer need the result, you can cancel it from the panel.

1. Find the task in the Active Tasks list
2. Click the Cancel button on the task row
3. The task moves to cancelled and the worker is freed up for the next job

Tip: Cancelling a long transcription is safe — the partial result is discarded and you can re‑import the file to start over.

When to Use the Task Manager

• An import feels stuck — open the panel and check whether the library sync worker is alive and what step it is on
• An AI request never returns — confirm the LLM worker is ready and the task is still running rather than dropped
• You want to free up resources — cancel queued tasks you no longer need so the worker can move on
• You are debugging a failure — find a failed task in the completed list to see how long it ran before it errored

Limitations

• The panel only reflects work performed in your current browser session. It does not show background work on other devices.
• Cancelling a task stops the in‑flight operation but does not undo any side effects the task already produced (for example, partial files written to the local database).
• Some system workers are protected and cannot be cancelled.