-
Notifications
You must be signed in to change notification settings - Fork 27
Options and features
rudolphos edited this page Dec 25, 2024
·
8 revisions
Full list of options:
- 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.
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.
-
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).
❓Guide: Rename and route downloads (Templates)
- 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.
- 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).
-
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).
- 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.
-
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.
-
Enable fetching via content script (Firefox only): Fetch files using a content script (useful for bypassing server-side protections).
- Do not enable this if you have no problems downloading. Download from the content page and not the extension, sending headers from the page itself. Some sites (eg. pixiv.net) require this to bypass server-side protections. Slower and prone to failure. Success/failure notifications do not work in this mode. Requires page refresh to take effect.
-
Enable fetching via Fetch API (Firefox only): Use the HTML Fetch API for downloading (useful for sites incompatible with the browser's Downloads API).
- Do not enable this if you have no problems downloading. Download using HTML Fetch API instead of the browser’s Downloads API for extensions. Some sites (eg. Instagram) are incompatiable with Firefox’s Downloads API.
- 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.
- Import & Export settings: Import or export current settings for backup or sharing.
- Enable debug logging: Enable detailed logging for debugging purposes.