Skip to content

Options and features

Ng Guoyou edited this page Jul 13, 2026 · 21 revisions

Options and features

The options page is searchable: use the search box in the top bar to jump to a setting. Settings are stored locally and synchronized through the extension's settings pipeline where supported.

Downloads menu

Define directories relative to the browser's default download directory. Use the visual editor for structured editing or switch to text mode for direct syntax.

  • Drag rows vertically to reorder.
  • Drop on the middle zone of a row to nest beneath it.
  • Add --- for a separator and >name for a submenu.
  • Add // comment for rule metadata or // (alias: Label) for display text.
  • Use the live variable list to insert path variables.

WebExtensions cannot normally save outside the default download directory. A symlink inside that directory can point elsewhere, provided the target already exists.

Save behavior

Save media, links, selections, pages, and supported tab-strip targets. Configure link preference, save-dialog conditions, duplicate handling, shortcut-file formats, notifications, context-menu access keys, and the click-to-save gesture.

Tab-strip context menus work in Firefox and Chrome 150+. Older supported Chrome versions omit them.

Routing and renaming

Dynamic rules can rename files or route them based on page, source, filename, media, menu, and initiation context. Use the rule builder and template library for common cases, or edit text directly. The last-download panel shows current test data and live variables.

See Clause and Variable list.

Browser downloads

Ordinary browser-owned downloads can be recorded in Save In History. Chrome can also route matching downloads natively; Firefox offers an explicitly experimental cancel-and-replace path with important limitations.

See Browser downloads.

Page Sources

The Page Sources panel discovers page media, images, documents, and links. It supports filtering, type facets, sorting, previews, URL copying, direct saving, and Save In context-menu actions.

See Page Sources.

History

History records saves locally with status, path, source, initiation context, mechanism, menu/rule metadata, and useful variables. Filter, sort, select a date range, choose columns, paginate, open completed files, or export comprehensive JSON/CSV/TSV data.

See History.

Advanced and integrations

Advanced settings include filename sanitization, fallback fetching, Firefox Referer rules, the persistent counter, backup/reset, and diagnostics. External extensions can use the Download API only after their exact caller ID is added to Allowed extension IDs; the empty default blocks all external downloads while leaving API discovery available. Rejected non-private callers appear below the allowlist with an Add button, attempt count, request kind, and last-seen time. The rejected URL is never stored. The options page can also expose experimental WebMCP tools to compatible in-browser agents.

See Integrations, Firefox vs Chrome, Authenticated downloads and request context, and Troubleshooting and diagnostics.

Clone this wiki locally