Skip to content

Options and features

Jump to bottom
Ng Guoyou edited this page Jul 10, 2026 · 21 revisions

Full list of options:

Downloads

📓 Variables list

❓Guide: Create menu items

image

  • Comments and Aliases: Allows for adding comments and aliases to menu items.
  • Submenus: Settings for creating submenus.
  • Saving outside the default download directory: Options to save files outside the default download location.

❓Guide: Saving outside the default download directory

The WebExtensions API does not allow files to be saved outside of the default download directory. A symlink inside the default download directory can be used to get around this limitation.

Invalid paths ( .. and /) are ignored. Files and directories with leading dots ( foo/.hidden) are considered invalid by Firefox and Chrome.

Windows: mklink /D C:\\path\\to\\symlink D:\\path\\to\\actual

macOS/Unix: ln -s /path/to/actual /path/to/symlink

Make sure the target directories actually exist, or the extension will silently fail to download.

  • Show Last Used Menu Item: Option to show the last used menu item.

Behavior

  • Enable Saving of Links: Prefer sources if available.
    • Always Prefer Links Over Sources: Option to always prefer links over sources.
    • Prefer Links for Pages Matching URL Filters: Regular expression for matching page URLs.
  • Enable Saving of Selected Text: Save selected text with a ".selection.txt" extension.
  • Enable Saving of the Current Page: Saves the current page without external resources.
  • Enable Saving from Tabstrip (Firefox only): Option to save from the tab strip. Close Tabs Marked for Saving: Automatically close tabs marked for saving.
  • Saves Tab, Tab Group, or Tabs to the Right: Save tabs, groups, or right-clicked tabs.
  • Open Save File Dialog: Options to open a file dialog during saving under different conditions:
    • When saving.
    • When filename has no extension.
    • When SHIFT is held down while clicking a menu item.
    • If download fails.
  • Uniquify Overwrite Prompt: Prompt when encountering a duplicate filename (Chrome).

Dynamic Downloads (Advanced)

📓 Variable List 📓 Clause List

❓Guide: Rename and route downloads (Templates)

image

  • Rename and Route Downloads: Automate file routing or renaming.
  • Test Current Rules: Test the current rules applied to the last downloaded file.
  • Open Save File Dialog if No Rules Match: Show a file dialog if no routing/renaming rules are matched.
  • Exclusively Use Routing and Renaming Rules: Disables submenu for two-click downloads, saves relative to default directory.

Notifications

  • Show notification on successful download
  • Show notification on failed download
  • Show notification on rule match: Notification when a rule matches.
  • Show notification When a link was downloaded instead of the source
  • Close notifications early after ms: Option to close notifications early (set time in milliseconds).

History

  • A log of saved downloads: time, status (with an open-folder button), type, whether a rule renamed/routed it, file, folder, and source. Sortable, filterable, paginated, and stored locally on this device.
  • Raw JSON stays available at the bottom for import/inspection.

Save As Shortcuts

  • Save Shortcuts as: Save as different shortcut types:
    • HTML Redirect
    • Mac .url
    • Windows .url
    • Freedesktop .desktop
  • Save Media/Links/Pages/Tabs as shortcuts: Save media, links, pages, or tabs as shortcuts instead of regular files.
  • Save Tabs as Shortcuts (right-click tab, Firefox only).

Keyboard Shortcuts

  • Context Menu: Set access keys for context menu items.
  • Save In Context Menu Item: Configure the "Save In" context menu item.
  • Last Used Context Submenu Item: Set last used submenu item as a shortcut.
  • Add Number Key Shortcuts: Add number key shortcuts to context submenu items.
  • Click To Save: Enable saving with mouse clicks by holding down the Alt key.
    • Hold down Alt (default) and click images or media to save them in the last used directory or default download directory. Injects a script into pages to listen for click events. Not all variables are available when using this.
    • Keycode + left, middle, or right click options for saving.
    • Modifier keycode for click-to-save. Requires page refresh to take effect keycode.info.

More Options

  • Truncate Path Components: Limit the number of characters in path components.

    • 0 = no truncation

  • Replace Invalid Characters: Set a replacement character for invalid characters in filenames.

    • Leave blank to delete. Invalid replacement characters are ignored.

  • Retry failed downloads in the background (on by default): When a download fails with a network or server error, retry it once by fetching in the background before reporting failure. Referer rules are applied to the retry.

  • Enable fetching via Fetch API: Download using the HTML Fetch API instead of the browser's Downloads API. Works on both Firefox and Chrome; some sites (eg. Instagram) are incompatible with the Downloads API. On Chrome, large downloads are buffered in memory first.

    • Do not enable this if you have no problems downloading.

  • Enable fetching via content script (Firefox only, deprecated): Under Manifest V3 content scripts can no longer make cross-origin requests, so this rarely works. Use Enable fetching via Fetch API instead.

  • Set the "Referer" header to page URL if it is missing: Modify the "Referer" header for certain downloads.

  • Set Referer Headers for the Following Sites: Whitelist match patterns for sites that should modify headers. Whitelist of match patterns to match against. One per line. Headers will only be modified for downloads (source URLs) that match this whitelist. MDN: Match patterns

    • Do not enable this if you have no problems downloading, and try using the content script option before this. Some sites (eg. pixiv.net) check HTTP Referer headers on the server. Enabling this will set the HTTP Referer header to the page URL if it does not already exist.

  • Counter: The current value of the :counter: variable, with a reset button.

  • External API: The extension ID, live API version/capabilities, and a copy-paste snippet — see Integrations.

  • AI agent tools (experimental): In a WebMCP-capable browser, tools an AI agent can call to configure Save in — see Integrations.

Settings

  • Import & Export settings: Import or export current settings for backup or sharing.
  • Enable debug logging: Enable detailed logging for debugging purposes.

Clone this wiki locally