Troubleshooting/Local Files - Revision history

AngelHerraez: update and expand explanation of browser security restrictions and possible solutions

2025-02-08T17:06:39Z

update and expand explanation of browser security restrictions and possible solutions

AngelHerraez: update and expand explanation of browser security restrictions and possible solutions

2025-02-08T13:19:24Z

update and expand explanation of browser security restrictions and possible solutions

AngelHerraez: update and expand explanation of browser security restrictions and possible solutions

2025-02-08T12:44:07Z

update and expand explanation of browser security restrictions and possible solutions

AngelHerraez: using local files in browsers

2020-12-17T18:48:52Z

using local files in browsers

AngelHerraez: using local files in browsers

2020-12-17T18:32:02Z

using local files in browsers

AngelHerraez: MacOS Chrome automated local file access

2014-09-06T15:53:54Z

MacOS Chrome automated local file access

AngelHerraez: moving local file access tricks to Troubleshoot sction

2014-09-06T15:51:05Z

moving local file access tricks to Troubleshoot sction

AngelHerraez: /* Safari in MacOS */

2014-09-06T15:38:28Z

‎Safari in MacOS

AngelHerraez: Accessing J(S)mol-containing webpages in local disk

2014-09-06T15:32:03Z

Accessing J(S)mol-containing webpages in local disk

New page

= Accessing J(S)mol-containing webpages in local disk =

== Safari in MacOS ==

'''Symptom''': trying to load an html file with JSmol/Java in Safari. The applet tries to load but then fails.

'''Solution''': Safari > Preferences > Advanced > check the <code>Show Develop menu in menu bar</code> option.
In the resulting Develop toolbar drop-down, check the <code>Disable Local File Restrictions</code> option.

'''Caveat''': when models in binary-format files are to be loaded, Safari may fail in any case for local files.

@@ Line 1: / Line 1: @@
-= Accessing J(S)mol-containing webpages in local disk, or loading models from local files =
+= Accessing JSmol-containing webpages in local disk, or loading models from local files =
 == JSmol does not load when the web page is in a local disk ==
-Security policies of web browsers prevent some JavaScript being executed from local disk.
+Some solutions you may try if you need to do this:
-If you feel confident to override this security measures (e.g. for pages you have authored), read below.
+# Install a local web server and use it to access the pages via an http:// url.
+# If you feel confident to override the security measures (e.g. for pages you have authored), read below.
-Another solution is that the page is local, but the JSmol files are in a web server. Then, no security restrictions apply.
+# Another solution, in some cases is that the page is local, but the JSmol files are in a web server. Then, less security restrictions apply.
 === Symptoms ===
@@ Line 43: / Line 45: @@
 == JSmol loads, but cannot load files from a local disk ==
-Once we managed to authorise loading of JSmol, thare may still be additional restrictions for loading molecular files from local disk.
+Once we managed to authorise loading of JSmol, there may still be additional restrictions for loading molecular files from local disk. This may also depend on whether the files are plain text or binary formats.
 === MacOS ===
@@ Line 51: / Line 61: @@
 '''Caveat''': when models in binary-format files are to be loaded, Safari may fail in any case for local files.
-== Windows ==
+=== Windows ===
-=== Firefox ===
+==== Firefox ====
 If you have applied the security override described above, you will be able to read both binary and text files locally.
-=== Chrome ===
+==== Chrome ====
 If you have applied the security override described above,  ....

@@ Line 9: / Line 9: @@
 === Symptoms ===
-When trying to load a page, some of these error warnings are shown in an alert box:
+When trying to load a page, JSmol does not complete loading, or some of these error warnings are shown in an alert box:
 [[File:Local file error.png|border|center]]
@@ Line 20: / Line 20: @@
 ==== Chrome ====
-A command entered in the terminal allows to start up MacOS Chrome so that JSmol runs from local files:
+Close all instances of the browser. Then, a command entered in the terminal allows to start up MacOS Chrome so that JSmol runs from local files:
   open /Applications/Google\ Chrome.app --args --allow-file-access-from-files
 There is possibly a way to [[Troubleshooting/Local_Files/MacChromeAutomator|write an AppleScript]] to do this in one fell swoop.
@@ Line 43: / Line 42: @@
 == JSmol loads, but cannot load files from a local disk ==
 === MacOS ===
@@ Line 52: / Line 53: @@
 == Windows ==
 === Firefox ===
-You will be able to read both binary and text files locally. Please enter <code>about:config</code> in the url address slot and then try setting as '''<code>false</code>''' one of these:
+If you have applied the security override described above, you will be able to read both binary and text files locally.
 === Chrome ===
-If you need to open local files, first close all instances of Chrome and then try starting Chrome (from a command line or a shortcut) with one of these options:
+If you have applied the security override described above,  ....
 It is '''not''' possible to load local '''binary''' files into JSmol/HTML5 from standard script commands. That is, no direct file reading with any of the following in their names:
    .bin .gz .jmol .jpg .map .mrc .omap .png .pse .smol .spartan .zip
 This does not apply to files drag-dropped onto the Jmol object or files loaded using "?", which use the HTML5 FileReader object. That method reads binary files without a problem.

@@ Line 1: / Line 1: @@
 = Accessing J(S)mol-containing webpages in local disk, or loading models from local files =
-== Symptoms ==
+== JSmol does not load when the web page is in a local disk ==
-[[File:Local file error.png|border|center]]
+Security policies of web browsers prevent some JavaScript being executed from local disk.
-== MacOS ==
+Another solution is that the page is local, but the JSmol files are in a web server. Then, no security restrictions apply.
-=== Safari ===
+=== Symptoms ===
-'''Symptom''': trying to load an html file with JSmol/Java in Safari. The applet tries to load but then fails.
+=== MacOS ===
 '''Solution''': Safari > Preferences > Advanced > check the <code>Show Develop menu in menu bar</code> option.
 <br>In the resulting Develop toolbar drop-down, check the <code>Disable Local File Restrictions</code> option.
-'''Caveat''': when models in binary-format files are to be loaded, Safari may fail in any case for local files.
+==== Chrome ====
 A command entered in the terminal allows to start up MacOS Chrome so that JSmol runs from local files:
   open /Applications/Google\ Chrome.app --args --allow-file-access-from-files
@@ Line 23: / Line 25: @@
 There is possibly a way to [[Troubleshooting/Local_Files/MacChromeAutomator|write an AppleScript]] to do this in one fell swoop.
 == Windows ==
 === Firefox ===
 You will be able to read both binary and text files locally. Please enter <code>about:config</code> in the url address slot and then try setting as '''<code>false</code>''' one of these:
@@ Line 40: / Line 65: @@
    .bin .gz .jmol .jpg .map .mrc .omap .png .pse .smol .spartan .zip
 This does not apply to files drag-dropped onto the Jmol object or files loaded using "?", which use the HTML5 FileReader object. That method reads binary files without a problem.

← Older revision		Revision as of 18:48, 17 December 2020
Line 1:		Line 1:
	= Accessing J(S)mol-containing webpages in local disk, or loading models from local files =		= Accessing J(S)mol-containing webpages in local disk, or loading models from local files =
		+
		+	== Symptoms ==
		+	When trying to load a page, some of these error warnings are shown in an alert box:
		+
		+	[[File:Local file error.png\|border\|center]]

	== MacOS ==		== MacOS ==

@@ Line 22: / Line 22: @@
 === Firefox ===
-You will be able to read both binary and text files locally. Please enter <code>about:config</code> in the url address slot and then set <code>security.fileuri.strict_origin_policy false</code>.
+You will be able to read both binary and text files locally. Please enter <code>about:config</code> in the url address slot and then try setting as '''<code>false</code>''' one of these:
 === Chrome ===
-If you need to open local files, start Chrome using the command-line flag <code>--allow-file-access-from-files</code>. Beyond that, same as for MSIE/Windows below.
+If you need to open local files, first close all instances of Chrome and then try starting Chrome (from a command line or a shortcut) with one of these options:
 It is '''not''' possible to load local '''binary''' files into JSmol/HTML5 from standard script commands. That is, no direct file reading with any of the following in their names:
-  .bin .gz .jmol .jpg .map .mrc .omap .png .pse .smol .spartan .zip
+=== MSIE ===
-This does not apply to files drag-dropped onto the Jmol object or files loaded using "?", which use the HTML5 FileReader object. That method reads binary files without a problem.
+The same limitations apply regarding local '''binary''' files as those explained above for Chrome.

@@ Line 17: / Line 17: @@
 (Make sure an instance of Chrome is not active when you issue that command.)
-There is possibly a way to write an AppleScript to do this in one fell swoop.
+There is possibly a way to [[Troubleshooting/Local_Files/MacChromeAutomator|write an AppleScript]] to do this in one fell swoop.
 == Windows ==