ErrLookup › agalwood/Motrix
agalwood/Motrix
A full-featured download manager. · TypeScript · 822 source files
Analyzed at 1a708ee577 on 2026-08-12. 127 documented errors.
| Code / Message | Type | Severity | Tags |
|---|---|---|---|
activity_schema_missing The versioned database schema is incompatible with this build: expected… | exception | critical | database, sqlite, migration, activity, singleton, stale-schema, bigint |
| current exceeds the signed int64 range | validation | critical | validation, range-error, bigint, sqlite, data-integrity |
EngineProcessOwnershipUnverified A verified aria2 process is required for force termination | error_code | error | engine, supervisor, recovery, termination, ownership, safety |
unsupported-kind ffmpeg unavailable — mux pipeline not active | error_code | error | ffmpeg, bridge-receiver, mux, configuration |
plugin.command.not_declared_in_manifest command " " is not declared in plugin " " manifest.contributes.commands[] | exception | error | plugin, commands, manifest, api-contract, configuration |
| reserved gid must contain exactly 16 hexadecimal characters | validation | error | validation, type-error, aria2, gid, tests |
| exceeds the JavaScript safe integer range | validation | error | validation, range-error, numbers, inspector-activity |
plugin.lifecycle.activation_capability_violation effectful call . during activation | exception | critical | plugin, lifecycle, activation, fatal |
EngineProcessTerminationFailed aria2 process did not exit after force termination | error_code | critical | aria2, engine, process, termination, timeout, permissions |
PluginRuntimeFault plugin.command.access_denied | exception | error | plugin, commands, access-control, validation |
| is not a legal task status | validation | error | validation, range-error, state-machine, enums |
plugin.commands.access_denied cross-plugin command | exception | error | plugin, commands, cross-plugin, access-control, capabilities |
| must contain between 1 and characters | validation | error | validation, range-error, strings, inspector-activity |
| plugin locale commit and rollback both failed | exception | critical | plugin, registry, locale, transactions, aggregate-error |
| invalid Chrome extension ID | validation | error | validation, extension, chrome, registry, regex |
EngineStartFailed Unrecognized aria2 version output from | error_code | critical | aria2, engine, binary, version, startup |
canonical_task_columns_missing The versioned database schema is incompatible with this build: expected… | exception | critical | database, sqlite, migration, schema, tasks, stale-schema |
| registry responded | exception | error | plugin, registry, network, http |
| aria2 returned gid instead of reserved gid | exception | error | aria2, torrent, gid, assertion, concurrency |
| Database schema version | exception | critical | database, sqlite, migration, downgrade, version-mismatch |
| samples[ ].flags exceeds the SQLite bound | validation | error | validation, range-error, bitmask, sqlite |
| Update is not ready to install | exception | error | state-machine, electron-updater, auto-update, precondition, validation |
| aria2 addTorrent gid must contain exactly 16 hexadecimal… | validation | error | aria2, torrent, gid, type-safety, validation |
inherited_schema_missing The versioned database schema is incompatible with this build: expected… | exception | critical | database, sqlite, migration, schema, stale-schema |
plugin.lifecycle.secrets_decrypt_failed libsodium decryption failed: ciphertext may be tampered or key mismatch | error_code | critical | plugin, secrets, libsodium, crypto, key-mismatch, data-loss |
plugin.lifecycle.secrets_seed_missing plugin " " config key " " is secret but no decryptSecret function was injected | exception | error | plugin, config, secrets, lifecycle, capabilities |
TaskFinalizeRenameFailed Failed to rename file | exception | error | filesystem, finalize, rename, download, io |
legacy_table_present The versioned database schema is incompatible with this build: legacy table… | exception | critical | database, sqlite, migration, legacy, plan-a, stale-schema |
plugin.ffmpeg.destination_phase_disallowed ffmpeg output resolves outside saveDir and plugin storage | exception | error | plugin, ffmpeg, security, filesystem, hooks |
plugin.storage.quota_exceeded plugin.storage.quota_exceeded: projected usage | exception | error | storage, quota, plugin, limits |
PLUGIN_MANIFEST_INVALID plugin.update.builtin_no_package | error_code | error | plugin, update, builtin, registry, validation |
| is not an integer | validation | error | sqlite, type-coercion, data-integrity |
foreign_key_violation The versioned database schema is incompatible with this build: the canonical… | exception | critical | database, sqlite, migration, foreign-keys, data-integrity, stale-schema |
inspector_activity_schema_missing The versioned database schema is incompatible with this build: expected… | exception | critical | database, sqlite, migration, schema, v3, inspector-activity, stale-schema |
PLUGIN_ENGINE_VERSION_TOO_OLD Plugin requires host | error_code | error | manifest, engines, semver, host-compat, version-mismatch |
EngineProtocolError Engine returned non-numeric history count | error_code | error | aria2, rpc, protocol-error, history, engine |
PluginManifestInvalid plugin.command.schema_compile_failed | exception | error | plugin, schema, ajv, manifest |
PluginPermissionUnsupported plugin.grants.not_supported | exception | warning | plugin, grants, permissions, access-control |
plugin.fs.rename_target_exists plugin.fs.rename_target_exists | exception | warning | fs, task, rename, collision, idempotency |
invalid-url-scheme URL must be http: or https: | error_code | error | validation, url, bridge-receiver, scheme |
plugin.commands.not_found command " " is not registered | exception | error | plugin, commands, registration, dispatch |
TaskNotRetryable Task cannot be retried: required inputs are unavailable | exception | error | re-add, retry, state, validation, task-lifecycle |
GeoIPDownloadFailed network error | error_code | error | geoip, network, download, fetch, timeout |
plugin.fs.path_outside_sandbox plugin.fs.path_outside_sandbox: resolved path outside sandbox root | validation | critical | fs, sandbox, security, symlinks, path-traversal |
plugin.lifecycle.secrets_invalid_token secret token has invalid format: expected prefix | error_code | error | plugin, secrets, libsodium, validation |
| plugin locale prepare-commit and rollback both failed | exception | critical | plugin, registry, locale, transactions, aggregate-error |
transient-failure manifest fetch failed | error_code | error | network, hls, dash, manifest, transient |
plugin.http.scheme_not_allowed URL scheme ' ' is not allowed; use http: or https | validation | error | http, security, ssrf, url-validation, redirect |
plugin.metadata.value_not_serializable plugin.metadata.value_not_serializable: undefined is not JSON-serializable | validation | error | metadata, serialization, typescript, validation |
| Key must be 16 bytes, got | validation | error | media, encryption, network, hls, aes |
plugin.commands.id_out_of_namespace command " " is outside namespace " ." — commands must start with " . | validation | error | plugin, commands, namespacing, api-contract |
plugin.fs.task.not_available_outside_hook fs.task is only available inside a hook invocation; no hook context is active | exception | error | plugin, capability, fs, hook-context, lifecycle |
MagnetCleanupPending aria2 cleanup for a failed magnet swap is still pending for task | exception | error | magnet, swap, aria2, cleanup, retryable, concurrency |
plugin.fs.chunk_too_large plugin.fs.chunk_too_large: maxChunkSize | validation | error | fs, task, memory, limits, read |
| WebSocket is not connected | exception | error | websocket, aria2, transport, connection, rpc |
plugin.metadata.quota_exceeded plugin.metadata.quota_exceeded: projected usage | exception | error | metadata, quota, storage, limit |
IpcInvalidPayload Invalid Task Inspector Activity query params | error_code | error | ipc, validation, payload, typescript, boundary |
plugin.http.invalid_url Invalid URL | validation | error | http, url, validation, input-validation |
PluginActivationCapExceeded plugin.lifecycle.activation_cap_exceeded | exception | warning | plugin, activation, resource-limits, lifecycle |
| randomBytes: n out of range | validation | error | crypto, random, input-validation, ranges |
| must be a flat string record | validation | error | validation, range-error, objects, i18n |
plugin.lifecycle.deactivate_timeout plugin " " deactivate budget exhausted before all handlers ran | exception | error | lifecycle, plugin, timeout, cleanup, performance |
plugin.http.timeout Request timed out after | exception | error | http, timeout, network, performance |
plugin.capability.unavailable notify capability is not available in this runtime | exception | warning | notify, capability, runtime, headless |
MagnetResolveFailed saved torrent metadata is no longer available for task | exception | error | magnet, metadata, filesystem, io, bittorrent |
InvalidSelection task is not a MetadataReady magnet selection | exception | error | magnet, swap, validation, state, task-lifecycle |
unsupported-master master playlist has no variants | error_code | error | hls, media, streaming, validation |
plugin.http.response_too_large Response body exceeded | exception | error | http, memory, dos, safety, streaming |
| kind is not a legal history event kind | validation | error | validation, range-error, enums, state-machine |
| Paused must transition from active to paused | validation | error | validation, range-error, state-machine, events |
| plugin.manifest.role.requires_builtin | exception | error | plugin, manifest, role-band |
GeoIPSourceUnsupported MaxMind official source is not yet supported (Phase 2.1). | error_code | warning | geoip, config, unsupported-feature, maxmind |
| invalid Firefox extension ID | validation | error | validation, extension, firefox, registry, regex |
| Invalid Task Inspector Activity snapshot | exception | error | inspector, activity, parsing, schema, data-corruption |
plugin.http.network Network error | exception | error | http, network, dns, tls, connection |
plugin.storage.cas_mismatch plugin.storage.cas_mismatch: key already exists (expectedVersion=0) | exception | warning | storage, cas, concurrency, plugin |
unsupported-live live HLS is not supported | error_code | error | hls, media, streaming, live |
TaskRemoveNotAvailableDuringFinalize Cannot remove task while it is being finalized | exception | error | remove, finalize, concurrency, task-lifecycle, race |
| Completed must end in completed | validation | error | validation, range-error, state-machine, events |
plugin.http.redirect_not_allowed redirect: 'error' set; refusing to follow | exception | error | http, redirect, security, configuration |
TaskFinalizeMetaMissing Torrent metadata path not set | exception | error | bittorrent, finalize, state, metadata, data-integrity |
new_tables_missing The versioned database schema is incompatible with this build: expected tables… | exception | critical | database, sqlite, migration, tasks, stale-schema, partial-migration |
plugin.fs.too_many_readers plugin.fs.too_many_readers: max | exception | error | fs, task, concurrency, resource-limits, readers |
plugin.fs.not_found plugin.fs.not_found | exception | warning | fs, storage, not-found, enoent |
TorrentParseFailed Torrent file is too large | exception | error | torrent, validation, parser, size-limit, memory |
| toStatus is required | validation | error | validation, range-error, state-machine |
plugin.fs.invalid_basename not a valid basename | validation | error | fs, sandbox, filename-validation, security |
| JSON must not exceed characters | validation | error | validation, range-error, json, size-limits |
plugin.fs.path_too_long plugin.fs.path_too_long: path exceeds | validation | error | fs, sandbox, path-validation, limits |
plugin.http.aborted Request aborted by plugin | exception | error | http, abort, race-condition, cancellation |
| Started must enter an active status | validation | error | validation, range-error, state-machine, events |
plugin.metadata.not_available_outside_hook metadata is only available inside a hook invocation; no task context is active | exception | error | plugin, capability, metadata, hook-context, lifecycle |
plugin.storage.value_not_serializable plugin.storage.value_not_serializable: undefined is not JSON-serializable | exception | error | storage, serialization, typescript, validation |
| Key must be 16 bytes, got | validation | error | media, encryption, aes, validation, typescript |
| must be a positive safe integer | validation | error | validation, range-error, number, safe-integer |
plugin.fs.overwrite_required plugin.fs.overwrite_required | exception | warning | fs, storage, write, overwrite, idempotency |
TaskCreateDedupExhausted Too many files with name | exception | error | create, filesystem, naming, dedup, io |
| manifest fetch failed: HTTP | exception | error | network, http, media, streaming |
| manifest too large: > | exception | warning | network, http, security, dos-protection, media |
TaskNotFound task not found | exception | warning | magnet, task-lifecycle, state, ui-race |