SingleFile

SingleFile

SingleFile is a WebExtension compatible with Chrome, Firefox (Desktop and Mobile), and Opera that helps you to save a complete web page into a single HTML file.

Table of Contents

• Demo
• Install
• Getting started
• Additional notes
• Statistics (Firefox)
• Command Line Interface
• Known issues
• Troubleshooting unknown issues
• Release notes
• Contributors
• Icons
• Code derived from third party projects
• License

Demo

https://www.youtube.com/watch?v=RdV8DBW5b0g

Install

SingleFile can be installed on:

• Firefox via the Firefox Add-ons website: https://addons.mozilla.org/en-US/firefox/addon/single-file,
• Chrome via the Chrome Web Store: https://chrome.google.com/extensions/detail/mpiodijhokgodhhofbcjdecpffjipkle,
• Opera and forks of Firefox/Chrome by downloading the zip file (https://github.com/gildas-lormeau/SingleFile/archive/master.zip) and installing it manually.

Getting started

• Wait until the page is fully loaded, you may need to scroll down the entire page to be sure all elements are loaded.
• Click on the SingleFile button in the extension toolbar to save the page.

Additional notes

• To save multiple tabs, select them first and click on the SingleFile button.
• Open the context menu by right-clicking the SingleFile button in the extension toolbar or on the webpage. It allows you to save:
  • the current tab,
  • or the selected content,
  • or the selected frame.
• You can also process multiple tabs in one click and save:
  • the selected tabs,
  • or the unpinned tabs,
  • or all the tabs.
• The context menu also allows you to activate the auto-save of:
  • the current tab,
  • or the unpinned tabs,
  • or all the tabs.
• With auto-save active, pages are automatically saved every time after being loaded (or before being unloaded if not).
• Right-click on the SingleFile button and select "Options"/"Manage extension" to open the options page.
• The default save folder is the download folder configured in your browser, cf. about:preferences in Firefox and chrome://settings in Chrome.
• You can use the shortcut Ctrl+Shift+Y to save the current tab or selected tabs. Go to chrome://extensions/shortcuts to change it in Chrome.
• See the extension help in the options page for more detailed information about the options and technical notes.

Statistics (Firefox)

See https://addons.mozilla.org/en-US/firefox/addon/single-file/statistics/?last=90

Command Line Interface

You can save web pages or convert MAFF files to HTML from the command line interface. See here for more info: https://github.com/gildas-lormeau/SingleFile/blob/master/cli/README.MD.

Known Issues

• All browsers:
  • For security reasons, you cannot save pages hosted on https://chrome.google.com or https://addons.mozilla.org.
  • The last saved path cannot be remembered by default. To circumvent this limitation, disable the option "Misc > Save pages in background".
  • The following characters are replaced with _ in filenames: ~, \, ?, %, *, :, |, ", <, >
  • If the filename of a saved page looks like "56833935-156b-4d8c-a00f-19599c6513", disable the option "Misc > Save pages in background".
• Chrome/Opera:
  • You must enable the option "Allow access to file URLs" in the extension page to display the infobar when viewing a saved page, or to save a page stored on the filesystem.

Troubleshooting unknown issues

Please follow these steps if you find an unknown issue:

• Save the page in incognito.
• If saving page in incognito did not fix the issue, reset SingleFile options.
• If resetting options did not fix the issue, restart the browser.
• If restarting the browser did not fix the issue, try to disable all other extensions to see if there is a conflict.
• If there is a conflict then try to determine against which extension(s).
• Please report the issue with a short description on how to reproduce it here: https://github.com/gildas-lormeau/SingleFile/issues.

Release notes

See https://addons.mozilla.org/en-US/firefox/addon/single-file/versions

Contributors

• Chinese translation done by yfdyh000 (https://github.com/yfdyh000), KrasnayaPloshchad (https://github.com/KrasnayaPloshchad)
• Japanese translation done by Shitennouji（四天王寺) (https://github.com/Shitennouji)
• Polish translation done by xesarni (https://github.com/xesarni)
• Russian translation done by rstp14 (https://github.com/rstp14)

Code derived from third party projects

• csstree: https://github.com/csstree/csstree
• postcss-media-query-parser: https://github.com/dryoma/postcss-media-query-parser
• UglifyCSS: https://github.com/fmarcia/UglifyCSS
• parse-srcset: https://github.com/albell/parse-srcset
• parse-css-font: https://github.com/jedmao/parse-css-font

Icons

• Icon made by Kiranshastry from Flaticon is licensed by CC 3.0 BY

License

SingleFile is licensed under AGPL and GPL. Code derived from third-party projects is licensed under MIT. Please contact me at gildas.lormeau <at> gmail.com if you are interested in licensing the SingleFile code for a commercial service or product.

Suggestions are welcome :)