SingleFile help

SingleFile helps you to 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 displayed
    • click on the SingleFile icon in the chrome toobar
    • wait until the the shadow disappears then hit Ctrl-S or select "Save as" in the wrench menu and save the page
    • all images, style sheets and (almost all) frame contents are embedded into the ".htm" saved file
  2. Demo : SingleFile advantages over default file save
  3. Options description

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

    Details :

    • remove frames

      Remove all frames on the page

      You can enable this option if the file size is too large when disabled or to remove some ads.

      It is recommended to disable this option

    • remove scripts

      Remove all javascript scripts

      Most of the time, you don't need javascript into the saved page. If your want to save the page dynamic behavior, you may need to disable this option. Nevertheless, the dynamic behavior may not work or document can be altered when opening the saved file

      It is recommended to enable this option

    • remove objects

      Remove all objects

      Remove all non embeddable elements : flash, java applet ...

      It is recommended to enable this option if you want to read the saved page offline

    • remove hidden elements

      Remove all hidden elements

      Remove all the HTML unvisible elements on the page (with 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 disable this option unless the saved file size is too large

    • remove unused CSS rules

      Remove all unused CSS rules

      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 enable this option, it may introduce some incompatibilities issues in the saved page when opening it into another browser (i.e. not based on Webkit).

      It is recommended to disable this option unless the saved file size is too large or you do not want to open the saved page into another browser

    • Reset to default options

      Reset all the options to default state

    Note : All options are automatically saved

  4. Technical notes
    • it is technically not possible to add a "Save" button into chrome extensions or change "Save as" dialog box behavior into pure javascript chrome extensions
    • 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 8 (limited support : data URIs must be smaller than 32 KB)
    • SVG images are supported (SVG document is converted into utf-8 but is not processed)
  5. Known issues
  6. Unknown issues

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

    • test with only remove frames, remove scripts and remove objects enabled in options page
    • disable all other extensions to see if there is a conflict
    • if there is a conflict, try to determine against which extension(s)
    • report the issue here with a short description, URL(s), chrome version, OS version