SingleFile

Archive a complete page into a single HTML file

Instructions - Demo - Options description - Technical notes - Known issues - Unknown issues
  1. Instructions
    • wait until the page is fully loaded: you may need to scroll down the entire page and hover dynamic document elements (e.g. "rollover" images) to be sure all elements are loaded
    • click on the SingleFile icon in the toolbar (or press Ctrl Shift S) to launch page processing
    • wait until the save banner appears at the top the page
    • click on the link into the banner to save the page in default download folder

    Additional notes:

    • You can use the context menu to process the whole page ("process page"), the selected part of a page ("process selection") or a frame ("process frame")
  2. Demo
  3. Options description

    You can customize the way SingleFile process a document through the options page. Right-click on SingleFile icon in the browser toolbar and select "Options" in the context menu to open the options page.

    Details :

    • remove frames

      Check this option to remove all frames on the page. It may help to reduce the file size, to remove some ads and must be checked to view saved pages on IE.

      It is recommended to uncheck this option

    • remove objects

      Check this option to remove all non embeddable elements : flash objects, java applets ... Permission restrictions prevent them to be executed when they are embedded in the document.

      It is recommended to check this option

    • remove hidden elements

      Check this option to remove all hidden elements (visibility = "hidden" or display = "none" or opacity = "0" CSS property values). This option may alter the document but can considerably reduce the saved file size.

      It is recommended to uncheck this option

    • add entry in the context menu

      Check this option to launch processing on a page with page context menu. This option also helps to process only the selected area in the page.

      It is recommended to check this option

    • display save banner

      Check this option to display a banner with a download link at the top of the page when processing is finished. If this option is not checked then you must manually save the page through the "Save as" dialog (make sure that "Web page, Complete" type is selected) after it has been processed.

      It is recommended to check this option

    • remove scripts

      Check this option if you do not want to save scripts. Most of the time, you do not need scripts in the saved page. Thus they can alter it. Nevertheless if you want to save page dynamic behavior then uncheck this option. If you uncheck this option then you should also check process raw document option to keep page integrity.

      It is recommended to check this option

    • remove unused CSS rules

      Check this option to remove all CSS rules that do not match any element. This option may alter the document but can considerably reduce the saved file size. If you check this option, it may also introduce some incompatibilities issues in the saved page when opening it into another browser (i.e. not based on Webkit).

      It is recommended to uncheck this option

    • send saved page to PageArchiver

      Check this option to send the processed page to "PageArchiver" extension.

      It is recommended to uncheck this option

    • process raw document

      Check this option to process the raw downloaded document instead of the displayed document. The main difference is that scripts won't be parsed and executed. Frames won't be embedded too. This option should be checked when remove scripts is unchecked.

      It is recommended to uncheck this option

    • process in background

      Check this option to process the page in background. Processing in background is usually faster but can alter the page if there are critical issues with page validity.

      It is recommended to uncheck this option

    • max frame size

      Set the maximum size of embedded frames in MB.

      It is recommended to set this option to 2

    • Reset to default options

      Reset all the options to default state.

  4. Technical notes
    • all images are converted into base64
    • frame document contents are encoded with UTF-8 charset
    • encoded contents are injected in the document using data URI scheme
    • data URI scheme is supported by the following web browsers: Chrome, Firefox, Opera, Safari, Konqueror and Internet Explorer
    • SVG images are supported (SVG document is converted into UTF-8 but is not processed)
  5. Known issues
    • SVG images without src attribute or with empty src attribute are not embedded
    • If you are using "NotScripts" extension and have issues when using SingleFile then you must add this line in "CHANGE__PASSWORD__HERE.js" file as described here:
      const DO_NOT_MITIGATE_INLINE_SCRIPTS = true;
    • For security reasons these URIs cannot be processed:
      file:///*, chrome://* , https://chrome.google.com/* , https://addons.opera.com/*
  6. Unknown issues

    If you find an unknown issue (i.e. frozen process, extra saved files, blank or altered document, tab crash...):

    • reset SingleFile options
    • if option reseting did not work, try to display save banner and make sure that process in background is unchecked: you will have to use the "Save as" dialog to save the page (select "Webpage, Complete" type in "Save as" dialog).
    • 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 here with a short description describing how to reproduce the issue, Browser name and version, OS name and version.