save-in

Firefox Addons
Chrome Web Store
Releases

A web extension for Firefox and Chrome.

Adds a context menu to save media {image, video, audio, link, selection, page} in user-defined folders or directories relative to the default download location.

Save into dynamically named directories.

Flexible rules-based download renaming and routing.

Option to save as shortcuts {.url, .desktop, .html redirect}.

The WebExtension API only allows saving into directories relative to the default download directory. Symlinks can be used to get around this limitation:

Linux/Mac:

ln -s /path/to/actual /default_download_dir/symlink

Windows:

mklink /d \default_download_dir\symlink \path\to\actual

Make sure the actual directories exist, or downloads will silently fail.

• <all_urls> permission is used to get around CORS on HTTP HEAD requests (to check for Content-Disposition headers)
• tabs permission is used to get the active page's title.
• webRequest permissions are required to inject the Referer header on downloads (disabled by default)

Configure before use.

Development

1. Install dev dependencies yarn install
2. yarn d to start a dev Firefox instance using web-ext
3. Develop
4. yarn prettier and/or yarn prettier:write
5. yarn lint and/or yarn lint:fix
6. yarn test and/or yarn test:watch

Deployment

ZIP file

1. yarn build to create a zip in web-ext-artifacts directory

Firefox

1. Get API keys from here
2. Set environment variables WEB_EXT_API_KEY (JWT issuer) and WEB_EXT_API_SECRET
3. yarn build:firefox:submit to sign and upload to AMO (Firefox Addons), or manually upload at Firefox Addons
4. yarn build:firefox:submit also generates an XPI for manual distribution
5. Add https://github.com/yuku-t/textcomplete/releases in the comments when uploading.

Chrome

1. Go here
2. Upload built ZIP file

Notes for reviewers

Source code

The source code for this extension is available at https://github.com/gyng/save-in.

Third-party dependencies

Textcomplete

The archive containing this library can be downloaded from https://github.com/yuku-t/textcomplete/releases/download/v0.17.1/textcomplete-0.17.1.tgz

The vendored source for the minified Textcomplete library is obtained from within the archive located at package/dist/textcomplete.min.js

This link to the archive was retrieved from https://github.com/yuku-t/textcomplete/releases. The minified source is included with the source of this addon in src/options/vendor/textcomplete/textcomplete.min.js

yarn install installs the dependencies for the library yarn build:dist builds the distribution for the library

Contributors

Pull requests, bug reports, and issues are welcome.

Localisations kindly contributed by

• nl @80486dx
• sv @Sopor-