MozillaZine

File types and download actions

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 13:02, 31 July 2010
Alice Wyman (Talk | contribs)
(added category)
<-- Previous diff
Current revision
Alice Wyman (Talk | contribs)
(Audio and video content - more outdated content removed)
Line 1: Line 1:
-This article describes how Mozilla browsers handle downloads for different types of files and how you can change that behavior. It applies to {{Firefox}}, [[Mozilla Suite|Mozilla Suite/SeaMonkey 1.x]] and [https://wiki.mozilla.org/SeaMonkey:New_for_2.0 SeaMonkey 2]. +This article describes how Mozilla browsers handle downloads for different file types and how to change that behavior. It applies to {{Firefox}}, [[Mozilla Suite|Mozilla Suite/SeaMonkey 1.x]] and [http://www.seamonkey-project.org/ SeaMonkey 2].
-*If you need help with embedded media on a web page or a "missing plugin" alert, see [[Video or audio does not play]]. +*For help with embedded media or a "missing plugin" alert, see [[Video or audio does not play]].
-*If you need help with Thunderbird mail attachments, see [[Actions for attachment file types]].+*For help with Thunderbird mail attachments, see [[Actions for attachment file types]].
-{{right-pic|Fx2openingM3U.png}}+[[Image:FxOpening-doc.png|opening .doc file|right]]
==Opening dialog== ==Opening dialog==
-When you click a link to download a file, the [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types MIME type] determines what action is taken. If you see an "Opening <''filename''>" dialog asking if you want to save the file or open it with a specified application, that normally means that no [[:Category:Plugins |plugin]] is installed and enabled that can handle that MIME type and you have not previously selected a download action or [https://developer.mozilla.org/en/Gecko_Plugin_API_Reference:Plug-in_Basics#Plug-ins_and_Helper_Applications helper application] to always use for that type of file. Starting in Firefox 3 and SeaMonkey 2, the "Opening <''filename''>" dialog will also appear if you have selected "Always ask" as the action for the file's content type in your (Helper) Applications options/preferences ([[#File handling in Firefox 3 and SeaMonkey 2|see below]]). +When you click a link to download a file, the [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types MIME type] determines what action is taken. If you see an "Opening <''filename''>" dialog asking if you want to save the file or open it with a specified application, that normally means that your Mozilla application cannot handle the MIME type internally, no [[:Category:Plugins |plugin]] is installed and enabled that can handle it and you have not previously selected a download action or [https://developer.mozilla.org/en/Gecko_Plugin_API_Reference:Plug-in_Basics#Plug-ins_and_Helper_Applications helper application] to always use for that type of file. Starting in Firefox 3 and SeaMonkey 2, the "Opening <''filename''>" dialog will also appear if you have selected "Always ask" as the action for the file's content type in your (Helper) Applications options/preferences ([[#File_handling_in_current_Firefox_and_SeaMonkey_versions|see below]]).
-The "Open with" option may already show a default application for the file type. You can choose to open the file with that application, or you can choose or browse to a different application. In Firefox, you can use the drop-down menu and click "Other" (shown [http://kb.mozillazine.org/images/Fx3OpenOther.png here]) on Windows to open a file picker or, in Firefox 3, a "Choose Helper Application" dialog, as shown [http://kb.mozillazine.org/images/Fx3ChooseHelper.png here].+The "Open with" option can show a "Choose" or "Browse" button, if no application is associated with the file type (shown [http://kb.mozillazine.org/images/FxOpening-Browse.png here on Windows]), or it may show a default application for the file type. You can choose to open the file with that application or you can choose or browse to a different application. You can use the "Browse" button or click the drop-down menu icon and then click on "Other" to open a "Choose Helper Application" dialog, as shown [http://kb.mozillazine.org/images/FxOpening-ChooseHelperApp.png here] on Windows.
===Setting an automatic action=== ===Setting an automatic action===
-{{Right-pic|Opening_dialog-SM.png}}+You can set an automatic action for opening a specific type of file by checking the "Opening" dialog option to "Always perform this action when handling files of this type" (Mozilla Suite/SeaMonkey 1.x) or "Do this automatically for files like this from now on" (SeaMonkey 2 and Firefox) . An entry will appear for that type of file in the Download Actions or (Helper) Applications listing.
-You can set an automatic action for opening a specific type of file by checking the option to "Always perform this action when handling files of this type" (Mozilla Suite/SeaMonkey) or "Do this automatically for files like this from now on" (Firefox) in the "Opening" dialog. An entry will appear for that type of file in the Download Actions or (Helper) Applications listing.+
-'''Warning!''' Don't choose your Mozilla application to automatically open a file type. This can result in an infinite loop as Firefox or Mozilla Suite/SeaMonkey passes the file to itself as the helper application ([https://bugzilla.mozilla.org/show_bug.cgi?id=215554 bug 215554], [https://bugzilla.mozilla.org/show_bug.cgi?id=218257 bug 218257]). [http://forums.mozillazine.org/viewtopic.php?p=3322023#p3322023] [http://forums.mozillazine.org/viewtopic.php?f=9&t=1419855] [http://support.mozilla.com/tiki-view_forum_thread.php?forumId=1&comments_parentId=443081] [http://support.mozilla.com/tiki-view_forum_thread.php?forumId=1&comments_parentId=453199] [http://www.dedoimedo.com/computers/mht-linux-firefox.html] If you experience this problem, either change the download action for that file type to another action in the Download Actions or (Helper) Applications listing +'''Warning!''' Don't choose your Mozilla application to automatically open a file type. This can result in an infinite loop as Firefox or Mozilla Suite/SeaMonkey passes the file to itself as the helper application ([https://bugzilla.mozilla.org/show_bug.cgi?id=215554 bug 215554], [https://bugzilla.mozilla.org/show_bug.cgi?id=218257 bug 218257]). [http://forums.mozillazine.org/viewtopic.php?p=3322023#p3322023] [http://forums.mozillazine.org/viewtopic.php?f=9&t=1419855] [http://www.dedoimedo.com/computers/mht-linux-firefox.html] If you experience this problem, either change the download action for that file type to another action (or to "Always ask") in the Download Actions or (Helper) Applications listing
or else [[#Resetting download actions|reset all download actions]] (see below). or else [[#Resetting download actions|reset all download actions]] (see below).
===Unable to set an automatic action=== ===Unable to set an automatic action===
-{{Right-pic|Opening_JPG.png}}+In some cases, you may not be able to set an automatic download action. This can occur when a [[Opening_files_using_plugins#Misconfigured_web_server |misconfigured web server]] assigns an incorrect [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types#What_are_MIME_types.3F MIME type], such as "application/octet-stream", shown [http://kb.mozillazine.org/images/Opening_dialog-SM.png here] in SeaMonkey 1.x or if the server assigns "Content-Disposition: attachment" to the file download, as shown [http://kb.mozillazine.org/Image:Opening_JPG.png here] in SeaMonkey 1.x ( the MIME type of a downloaded file, and whether it should be handled as an attachment, does not appear in Firefox or in SeaMonkey 2). [http://forums.mozillazine.org/viewtopic.php?t=356337&start=30] [https://bugzilla.mozilla.org/show_bug.cgi?id=285976] When this happens, the option to always perform the same action will either be "grayed-out" or, in Firefox, selecting the "Do this automatically" option will not seem to have an effect and you will again be asked what to do when you next encounter that file type (see below for [[#Related bug reports|related bug reports]]). There is little you can do in these cases because the problem is at the server end.
-In some cases, you may not be able to set an automatic download action. This can occur when a [[Opening_files_using_plugins#Misconfigured_web_server |misconfigured web server]] assigns an incorrect [http://developer.mozilla.org/en/docs/Properly_Configuring_Server_MIME_Types#What_are_MIME_types.3F MIME type], such as "application/octet-stream" (shown above in SeaMonkey 1.x) or if the server assigns "Content-Disposition: attachment" to the file download (shown at right in SeaMonkey 1.x). [http://forums.mozillazine.org/viewtopic.php?t=356337&start=30] [https://bugzilla.mozilla.org/show_bug.cgi?id=285976] When this happens, the option to always perform the same action will either be "grayed-out" (as shown here in SeaMonkey 1.x) or, in Firefox, selecting the "Do this automatically" option will not seem to have an effect and you will again be asked what to do when you next encounter that file type (see below for [[#Related bug reports|related bug reports]]). There is little you can do in these cases because the problem is at the server end.+
- +
-'''Note:''' the MIME type of a downloaded file, and whether it should be handled as an attachment, is only shown in the SeaMonkey 1.x "Opening" dialog. This information does not appear in Firefox or in SeaMonkey 2. +
==Resetting download actions== ==Resetting download actions==
-''This applies to all versions of Firefox and Mozilla Suite/SeaMonkey''+''This section applies to all versions of Firefox and Mozilla Suite/SeaMonkey''
If problems arise or if you want to restore the default set of file download actions, do the following [http://forums.mozillazine.org/viewtopic.php?p=2115557#2115557]: If problems arise or if you want to restore the default set of file download actions, do the following [http://forums.mozillazine.org/viewtopic.php?p=2115557#2115557]:
-#Type [[about:config]] into the address bar.+#Type [[About:config|about:config]] into the address bar.
#Find the preference '''browser.download.pluginOverrideTypes''' and, if it is present, right-click on it and select <u>reset</U>. #Find the preference '''browser.download.pluginOverrideTypes''' and, if it is present, right-click on it and select <u>reset</U>.
#Find the preference '''plugin.disable_full_page_plugin_for_types''' and, if it is present, right-click on it and select <u>reset</U>. #Find the preference '''plugin.disable_full_page_plugin_for_types''' and, if it is present, right-click on it and select <u>reset</U>.
-#[[Kill application | Exit the browser]], then open the [[profile folder]] (the profile folder is hidden by default in Windows 2000/XP/Vista and Linux; read [[Show hidden files and folders|this]] if you need help finding it). +#Open the [[Profile folder|profile folder]]. (The profile folder is hidden by default in Windows 7/Vista/XP/2000 and Linux; read [[Show hidden files and folders|this]] for help finding it).<br> Note: [[Profile_folder_-_Firefox#Using_the_Help_menu_-_Firefox_3.6_and_above|In Firefox 3.6 and above you can open the profile folder from the Firefox menu, via "Help -> Troubleshooting Information"]].
-#Delete (or rename) the file [[mimeTypes.rdf]]. '''Caution:''' There is also a mimeTypes.rdf file in the [[installation directory |program folder]]. Do not delete it by mistake.+#[[Kill application | Completely close your Mozilla browser]].
 +# Delete (or rename) the file [[MimeTypes.rdf|mimeTypes.rdf]].
-==File handling in Firefox 3 and SeaMonkey 2==+==File handling in current Firefox and SeaMonkey versions==
-{{right-pic|Fx3Applications.png}}+[[Image:Fx19Applications-PDF.png|right]]
-All versions of Firefox and SeaMonkey will use an installed and enabled plugin to open a downloaded file by default, based on its MIME type. Starting in Firefox 3 and SeaMonkey 2, you are able to disable plugins within your browser, via "Tools -> Add-ons (Add-on Manager) -> Plugins". See [[Issues related to plugins]] for more information. +
-In Firefox 3 and in SeaMonkey 2, you can manage what actions are taken for file content types (MIME types) via the Applications tab in Firefox 3, shown here, and in the Helper Applications panel in SeaMonkey 2, [[#Managing content types - SeaMonkey 2|shown below]]. You can also set "Always ask" as an action for a listed content type (but note that the [[#Opening dialog|Opening dialog]] does not allow you to select a plugin action; read [[Opening files using plugins#Always ask|Opening files using plugins]] for more information). [[Live Bookmarks - Firefox#Web_feeds|Web Feeds]]/Podcasts will also be listed as well as certain [[Register protocol| Internet protocols]] such as "mailto" or "rtsp". +''This section applies to all Firefox versions since Firefox 3 and SeaMonkey 2''
-The (Helper) Applications panel does not include file extensions (such as .PDF) and MIME types are not included for all "Content Type" entries. You may need to depend on the icon or content description to determine the type of file. Plugins are identified with "(in Firefox)" or "(in SeaMonkey)" after the handler name. You are able to change an action to "Always Ask" for a content type, but you cannot remove an entry. Also, the SeaMonkey 2 Helper Applications panel does not allow you to add a new file type, as you were able to do in SeaMonkey 1.x. [https://bugzilla.mozilla.org/show_bug.cgi?id=417590] [https://bugzilla.mozilla.org/show_bug.cgi?id=462629]+Firefox and SeaMonkey will use an installed and enabled plugin to open a downloaded file by default, based on its MIME type (see [[Issues related to plugins]] for more information). Other download actions can be set from the [[#Opening dialog|Opening file dialog box]] that opens when you first encounter a particlar file type (see above).
 + 
 +You can manage what download actions are taken for file content types (MIME types) via the Applications tab in Firefox, shown here, and in the Helper Applications panel in SeaMonkey 2, [[#Managing content types - SeaMonkey 2|shown below]]. (This applies to downloaded files only, not embedded content.) You can also set "Always ask" as an action for a listed content type (but note that the [[#Opening dialog|Opening dialog]] does not allow you to select a plugin action; read [[Opening files using plugins#Always ask|Opening files using plugins]] for more information). [[Live Bookmarks - Firefox#Web_feeds|Web Feeds]]/Podcasts will also be listed as well as certain [[Register protocol| Internet protocols]] such as "mailto" or "rtsp".
 + 
 +The (Helper) Applications panel shows the [http://en.wikipedia.org/wiki/Content_type Content Type] (also known as the MIME type) , for example, "Wave Sound (audio/wav)", not the file extension. You may need to depend on the icon or content description to determine the type of file. Plugins are identified with "(in Firefox)" or "(in SeaMonkey)" after the handler name. You are able to change an action to "Always Ask" for a content type, but you cannot remove an entry. Also, the SeaMonkey 2 Helper Applications panel does not allow you to add a new file type, as you were able to do in SeaMonkey 1.x. [https://bugzilla.mozilla.org/show_bug.cgi?id=417590] [https://bugzilla.mozilla.org/show_bug.cgi?id=462629]
 + 
 +'''Important:''' Certain file extensions may include multiple content type entries, one for each MIME type associated with that type of file.
-===Managing content types - Firefox 3=== +===Built-in support for certain media===
-{{right-pic|FF3-AppTab-Install.png}}+In addition to files such as plain text (TXT) and common images (JPG, JPEG, GIF, PNG) which Mozilla browsers can handle internally without needing a plugin or helper application, support for certain other files are built into the browser.
-This section provides information on the use of the Applications tab found in + 
 +====Portable Document Format (PDF)====
 +Support for PDF files is built in to current Firefox versions and downloaded PDF files are previewed in Firefox by default. You can select a different action for the "Portable Document Format (PDF)" content type in the Firefox Applications window. See the Firefox Support article, [https://support.mozilla.org/kb/disable-built-pdf-viewer-and-use-another-viewer How to disable the built-in PDF viewer and use another viewer] for details. Built-in PDF support is not currently available in SeaMonkey. [https://bugzilla.mozilla.org/show_bug.cgi?id=752676] [https://bugzilla.mozilla.org/show_bug.cgi?id=714712]
 + 
 +====Audio and video content====
 +Support for [https://support.mozilla.org/kb/viewing-html5-audio-and-video#w_open-media open media] (e.g., OGG and WebM container formats) is now built in to current versions of Firefox and SeaMonkey 2. Clicking on a download link to an "open media" file will open it automatically in the browser, although you can context-click (right-click) on the link and save the file. [https://bugzilla.mozilla.org/show_bug.cgi?id=185618] [https://developer.mozilla.org/en-US/docs/HTML/Supported_media_formats]. Starting in Firefox 21 on Windows 7 and above (Firefox 22 on Windows Vista), MP3 and M4A audio files, as well as MP4 video files with the H.264 video codec and either AAC audio or MP3 audio codec, are also automatically opened in the built-in player by default (see [https://bugzilla.mozilla.org/show_bug.cgi?id=799315 bug 799315] for the background).
 + 
 +Settings in "[[menu differences|Tools -> Options]] -> Applications" for audio and video content types with built-in support are ignored, unless you toggle the preference '''media.play-stand-alone''' to '''false''' in [[about:config]] ([https://bugzilla.mozilla.org/show_bug.cgi?id=861090#c57 bug 861090]). [https://hg.mozilla.org/mozilla-central/rev/b28968baf343]
 + 
 +Note: Windows Media components may be missing on N and KN editions of Windows (sold to the European market) but you may be able to download a Media Feature Pack from Microsoft to install it. See [https://support.mozilla.org/kb/fix-video-audio-problems-firefox-windows this Mozilla Support article] and [http://blog.bitcollectors.com/adam/2013/03/windows-vista-and-7-n-k-kn-special-editions/ this blog post] for details.
 + 
 +===Managing content types - Firefox 3 and above===
 +''This section applies to all Firefox versions since Firefox 3. The information in this section also applies, in general, to SeaMonkey 2.''
 +<br>
 +[[Image:FF3-AppTab-Install.png|right]]
 + 
 +This section provides information on the use of the Applications tab in Firefox, found in
 + 
* Tools-> Options [Windows] * Tools-> Options [Windows]
* Edit->Preferences [Linux] * Edit->Preferences [Linux]
* Preferences [Mac] * Preferences [Mac]
-for Firefox 3. The information applies generally although the pictures are what would appear on a Mac. 
-When Firefox 3 is first installed there are two possibilities. First is a clean install with no previous profile and the second is an install with a previous profile (likely from Firefox 2). In the first case the Applications tab will only contain a list of files handled by installed plug-ins plus a few other defaults such as mailto. In the case of a second install with an existing profile from Firefox 2, the Applications tab may contain file types added for Firefox 2 requiring external applications as show in the figure for PowerPoint.<br>{{right-pic|FF3-NewType.png}}+The information applies generally although the pictures shown below are what would appear on a Mac.
 + 
 +<br>
 +When Firefox 3 (or above) is first installed, there are two possibilities. First is a clean install with no previous profile and the second is an install with a previous profile (likely from Firefox 2). In the first case the Applications tab will only contain a list of files handled by installed plug-ins plus a few other defaults such as mailto.
 + 
 +In the case of a second install with an existing profile from Firefox 2, the Applications tab may contain file types added for Firefox 2 requiring external applications as show in the figure for PowerPoint.
 + 
<br> <br>
'''A New File Type''' '''A New File Type'''
-[[#Opening dialog | As noted above]] for file types not already in the Applications tab, the first time you attempt to download a new file type the window at the right pops up. For this example a Rich Text Format or rtf file is used called test.rtf. At this point you can either elect to "Save File" (initial default) or "Open with". If you select "Open with", you can then navigate after clicking the "Choose..." button to select an application. Once you have made a selection, checking the box "Do this automatically for files like this from now on." will cause the file type and action to be displayed in the Applications tab as shown below (in this example the selected application is TextEdit).+<br>[[Image:FF3-NewType.png|right]]
 + 
 +[[#Opening dialog | As noted above]] for file types not already in the Applications tab, the first time you attempt to download a new file type the window at the right pops up. For this example a Rich Text Format or rtf file is used called test.rtf. At this point you can either elect to "Save File" (initial default) or "Open with".
 + 
 +If you select "Open with", you can then navigate after clicking the "Choose..." button to select an application. Once you have made a selection, checking the box "Do this automatically for files like this from now on." will cause the file type and action to be displayed in the Applications tab as shown below (in this example the selected application is TextEdit).
 + 
 +<br>
[[Image:FF3-TextEdit.png]] [[Image:FF3-TextEdit.png]]
Line 134: Line 164:
===Managing content types - SeaMonkey 2=== ===Managing content types - SeaMonkey 2===
-Go to "[[Menu differences|Edit -> Preferences]] -> Browser -> Helper Applications". The new Helper Applications panel in SeaMonkey 2 will open. Here, you can change download actions in the same way as explained above for Firefox 3.<br><br>+Go to "[[Menu differences|Edit -> Preferences]] -> Browser -> Helper Applications". The Helper Applications panel in SeaMonkey 2 will open. Here, you can change download actions in the same way as explained above for Firefox 3.<br><br>
-[[Image:SM2HelperApp.png]]<br>+[[Image:SM2-HelperApps.png]]<br>
==File handling in Firefox 2 and SeaMonkey 1.x== ==File handling in Firefox 2 and SeaMonkey 1.x==
Line 146: Line 176:
'''Changing download actions''' '''Changing download actions'''
-{{Right-pic|Download_Actions.png}}+[[Image:Download_Actions.png|right]]
Go to "[[Menu_differences_in_Windows%2C_Linux%2C_and_Mac |Tools -> Options]] -> Content / File Types -> Manage...". The Download Actions window will open. (MIME types are not shown by default. Click the icon in the top right corner and select "MIME Type" to display them.) Go to "[[Menu_differences_in_Windows%2C_Linux%2C_and_Mac |Tools -> Options]] -> Content / File Types -> Manage...". The Download Actions window will open. (MIME types are not shown by default. Click the icon in the top right corner and select "MIME Type" to display them.)
Line 166: Line 196:
After a helper application or "save to disk" download action has been set, that action will be taken automatically for those types of files. To remove a download action, open the Download Actions dialog as described above, select the file type entry and click the "Remove action" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file. After a helper application or "save to disk" download action has been set, that action will be taken automatically for those types of files. To remove a download action, open the Download Actions dialog as described above, select the file type entry and click the "Remove action" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file.
-Removing a download action does not affect files that are handled by plugins. Firefox 2 will automatically use a plugin if it is available for the MIME type, as shown in the [[about:plugins]] list.+Removing a download action does not affect files that are handled by plugins. Firefox 2 will automatically use a plugin if it is available for the MIME type, as shown in the [[About:plugins|about:plugins]] list.
===Managing file types - SeaMonkey 1.x=== ===Managing file types - SeaMonkey 1.x===
''This applies to Mozilla Suite / SeaMonkey 1.x'' ''This applies to Mozilla Suite / SeaMonkey 1.x''
-{{Right-pic|Helper_Applications.png}}+[[Image:Helper_Applications.png|right]]
Go to "[[Menu_differences_in_Windows%2C_Linux%2C_and_Mac |Edit -> Preferences]] -> Navigator -> Helper Applications". The [http://www.mozilla.org/docs/end-user/helper-applications.html Helper Applications] preferences panel will open. '''Mozilla Suite and SeaMonkey 1.x list file type entries by MIME type, not file extension. ''' Go to "[[Menu_differences_in_Windows%2C_Linux%2C_and_Mac |Edit -> Preferences]] -> Navigator -> Helper Applications". The [http://www.mozilla.org/docs/end-user/helper-applications.html Helper Applications] preferences panel will open. '''Mozilla Suite and SeaMonkey 1.x list file type entries by MIME type, not file extension. '''
Line 183: Line 213:
*If you want the file to be saved instead of opened, select "Save it to disk". *If you want the file to be saved instead of opened, select "Save it to disk".
-Note: Mozilla Suite and SeaMonkey 1.x do not list plugin actions in the Helper Applications listing. You cannot disable a plugin for file downloads here. You can check in "[[about:plugins |Help -> About Plug-ins]]" to see which MIME types are automatically handled by plugins. +Note: Mozilla Suite and SeaMonkey 1.x do not list plugin actions in the Helper Applications listing. You cannot disable a plugin for file downloads here. You can check in "[[About:plugins |Help -> About Plug-ins]]" to see which MIME types are automatically handled by plugins.
Line 199: Line 229:
After a helper application or "save to disk" action has been set, that action will be taken automatically for those types of files. To remove an action for a file type, open the Helper Applications preference panel as described above, select the file type entry and click the "Remove" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file. After a helper application or "save to disk" action has been set, that action will be taken automatically for those types of files. To remove an action for a file type, open the Helper Applications preference panel as described above, select the file type entry and click the "Remove" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file.
-Removing a file type from the Helper Applications list does not affect files that are handled by plugins. Mozilla Suite/SeaMonkey 1.x will automatically use a plugin if it is available for the MIME type, as shown in the [[about:plugins]] list.+Removing a file type from the Helper Applications list does not affect files that are handled by plugins. Mozilla Suite/SeaMonkey 1.x will automatically use a plugin if it is available for the MIME type, as shown in the [[About:plugins|about:plugins]] list.
==See also== ==See also==
 +* [[Testing plugins]]
* [[Page displays as gibberish]] * [[Page displays as gibberish]]
* [[The associated helper application does not exist]] * [[The associated helper application does not exist]]
Line 211: Line 242:
==External links== ==External links==
-* [http://support.mozilla.com/kb/Managing+file+types Managing file types (Firefox Support)] +* [https://support.mozilla.org/kb/Managing+file+types Managing file types (Firefox Support)]
 +* [https://support.mozilla.org/kb/Firefox+keeps+opening+many+tabs+or+windows Firefox keeps opening many tabs or windows (Firefox Support)]
* [http://www.mozilla.org/docs/end-user/helper-applications.html Helper Applications] at mozilla.org (written for Mozilla Suite) * [http://www.mozilla.org/docs/end-user/helper-applications.html Helper Applications] at mozilla.org (written for Mozilla Suite)
-* [https://addons.mozilla.org/addon/8207 Open in Browser] - This extension allows you to open files within the browser for supported file types, instead of selecting an external "helper" application, until the fixes proposed in [https://bugzilla.mozilla.org/show_bug.cgi?id=57342 bug 57342] and [https://bugzilla.mozilla.org/show_bug.cgi?id=258012 bug 258012] are implemented. +* [https://addons.mozilla.org/firefox/addon/8207 Open in Browser] (Firefox) and [https://addons.mozilla.org/seamonkey/addon/8207/ Open in Browser] (SeaMonkey). This extension allows you to open files within the browser for supported file types, instead of selecting an external "helper" application, until the fixes proposed in [https://bugzilla.mozilla.org/show_bug.cgi?id=57342 bug 57342] and [https://bugzilla.mozilla.org/show_bug.cgi?id=258012 bug 258012] are implemented.
===Related bug reports=== ===Related bug reports===
Please do not comment in bug reports unless you are helping to fix the bug. Also note that some of the bugs listed below are fixed and others may be marked "invalid" or "wontfix"; these are included for informational purposes only. Please do not comment in bug reports unless you are helping to fix the bug. Also note that some of the bugs listed below are fixed and others may be marked "invalid" or "wontfix"; these are included for informational purposes only.
-*[https://bugzilla.mozilla.org/show_bug.cgi?id=57342 Bug 57342 - Add "View as Text/HTML/..." option for unknown mime content-type] +*[https://bugzilla.mozilla.org/show_bug.cgi?id=57342 Bug 57342 - Add "View as Text/HTML/..." option for unknown mime content-type]
-* [https://bugzilla.mozilla.org/show_bug.cgi?id=201546 Bug 201546 – Can't hide opening dialog if download filetype is application/octet-stream]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=185618 Bug 185618 - Offer choice to open natively with Content-Disposition: attachment (View/Show in browser)]
-*[https://bugzilla.mozilla.org/show_bug.cgi?id=215554 Bug 215554 - Infinite browser spawn & file creation loop via circular file associations (mozilla as default application, helper app set to "open with default")]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=201546 Bug 201546 – Can't hide opening dialog if download filetype is application/octet-stream]
 +*[https://bugzilla.mozilla.org/show_bug.cgi?id=215554 Bug 215554 - Infinite browser spawn & file creation loop via circular file associations (mozilla as default application, helper app set to "open with default")]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=218257 Bug 218257 - Should not be able to use Firefox for Open With] *[https://bugzilla.mozilla.org/show_bug.cgi?id=218257 Bug 218257 - Should not be able to use Firefox for Open With]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=229688 Bug 229688 - type description in "opening foo" dialog doesn't match mime type] *[https://bugzilla.mozilla.org/show_bug.cgi?id=229688 Bug 229688 - type description in "opening foo" dialog doesn't match mime type]
-* [https://bugzilla.mozilla.org/show_bug.cgi?id=236541 Bug 236541 – "do this automatically for files like this" doesn't work when Content-Disposition:attachment is used]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=236541 Bug 236541 – "do this automatically for files like this" doesn't work when Content-Disposition:attachment is used]
-* [https://bugzilla.mozilla.org/show_bug.cgi?id=250914 Bug 250914 – Clicking on WMV file opens What should Firefox do? dialog]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=250914 Bug 250914 – Clicking on WMV file opens What should Firefox do? dialog]
-*[https://bugzilla.mozilla.org/show_bug.cgi?id=258012 Bug 258012 - Add UI for "View as Text/HTML/..." option for unknown mime content-type]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=258012 Bug 258012 - Add UI for "View as Text/HTML/..." option for unknown mime content-type]
-* [https://bugzilla.mozilla.org/show_bug.cgi?id=264492 Bug 264492 – OK button in (open with/save to) window is greyed/grayed/disabled when certain mimeTypes.rdf entries exist]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=264492 Bug 264492 – OK button in (open with/save to) window is greyed/grayed/disabled when certain mimeTypes.rdf entries exist]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=285976 Bug 285976 – consider making use of aReason argument of nsIHelperAppLauncherDialog::show] *[https://bugzilla.mozilla.org/show_bug.cgi?id=285976 Bug 285976 – consider making use of aReason argument of nsIHelperAppLauncherDialog::show]
-* [https://bugzilla.mozilla.org/show_bug.cgi?id=315536 Bug 315536 – "do this automatically for files like this from now on" often grayed out] (note [https://bugzilla.mozilla.org/show_bug.cgi?id=315536#c48 comment #48])+*[https://bugzilla.mozilla.org/show_bug.cgi?id=315536 Bug 315536 – "do this automatically for files like this from now on" often grayed out] (note [https://bugzilla.mozilla.org/show_bug.cgi?id=315536#c48 comment #48])
*[https://bugzilla.mozilla.org/show_bug.cgi?id=331259 Bug 331259 – checking "do this automatically for files like this from now on" doesn't have any effect on future downloads of same file type] *[https://bugzilla.mozilla.org/show_bug.cgi?id=331259 Bug 331259 – checking "do this automatically for files like this from now on" doesn't have any effect on future downloads of same file type]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=369431 Bug 369431 - Firefox handling of preferred apps is broken] *[https://bugzilla.mozilla.org/show_bug.cgi?id=369431 Bug 369431 - Firefox handling of preferred apps is broken]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=377784 Bug 377784 – create an easy-to-use MIME-type configuration system] *[https://bugzilla.mozilla.org/show_bug.cgi?id=377784 Bug 377784 – create an easy-to-use MIME-type configuration system]
-*[https://bugzilla.mozilla.org/show_bug.cgi?id=417590 Bug 417590 - port Firefox application pane as new helper app pane in SeaMonkey]+*[https://bugzilla.mozilla.org/show_bug.cgi?id=417590 Bug 417590 - port Firefox application pane as new helper app pane in SeaMonkey]
-*[https://bugzilla.mozilla.org/show_bug.cgi?id=453455 Bug 453455 - Make "do this automatically for files like this from now on" work even with "content-disposition: attachment"] +*[https://bugzilla.mozilla.org/show_bug.cgi?id=451260 Bug 451260 - Add ability to remove a content type in Tools > Options > Applications]
 +*[https://bugzilla.mozilla.org/show_bug.cgi?id=453455 Bug 453455 - Make "do this automatically for files like this from now on" work even with "content-disposition: attachment"]
*[https://bugzilla.mozilla.org/show_bug.cgi?id=462629 Bug 462629 - Cannot access MIME-type and file associations in new Helper Applications pane] *[https://bugzilla.mozilla.org/show_bug.cgi?id=462629 Bug 462629 - Cannot access MIME-type and file associations in new Helper Applications pane]
 +*[https://bugzilla.mozilla.org/show_bug.cgi?id=799315 Bug 799315 - Windows Media Foundation backend for media playback]
 +*[https://bugzilla.mozilla.org/show_bug.cgi?id=861090 Bug 861090 - User should be able to opt to download instead of play MP3/MP4/M4A files in "Settings > Applications]
 +

Current revision

This article describes how Mozilla browsers handle downloads for different file types and how to change that behavior. It applies to Firefox, Mozilla Suite/SeaMonkey 1.x and SeaMonkey 2.

opening .doc file

Contents

Opening dialog

When you click a link to download a file, the MIME type determines what action is taken. If you see an "Opening <filename>" dialog asking if you want to save the file or open it with a specified application, that normally means that your Mozilla application cannot handle the MIME type internally, no plugin is installed and enabled that can handle it and you have not previously selected a download action or helper application to always use for that type of file. Starting in Firefox 3 and SeaMonkey 2, the "Opening <filename>" dialog will also appear if you have selected "Always ask" as the action for the file's content type in your (Helper) Applications options/preferences (see below).

The "Open with" option can show a "Choose" or "Browse" button, if no application is associated with the file type (shown here on Windows), or it may show a default application for the file type. You can choose to open the file with that application or you can choose or browse to a different application. You can use the "Browse" button or click the drop-down menu icon and then click on "Other" to open a "Choose Helper Application" dialog, as shown here on Windows.

Setting an automatic action

You can set an automatic action for opening a specific type of file by checking the "Opening" dialog option to "Always perform this action when handling files of this type" (Mozilla Suite/SeaMonkey 1.x) or "Do this automatically for files like this from now on" (SeaMonkey 2 and Firefox) . An entry will appear for that type of file in the Download Actions or (Helper) Applications listing.

Warning! Don't choose your Mozilla application to automatically open a file type. This can result in an infinite loop as Firefox or Mozilla Suite/SeaMonkey passes the file to itself as the helper application (bug 215554, bug 218257). [1] [2] [3] If you experience this problem, either change the download action for that file type to another action (or to "Always ask") in the Download Actions or (Helper) Applications listing or else reset all download actions (see below).

Unable to set an automatic action

In some cases, you may not be able to set an automatic download action. This can occur when a misconfigured web server assigns an incorrect MIME type, such as "application/octet-stream", shown here in SeaMonkey 1.x or if the server assigns "Content-Disposition: attachment" to the file download, as shown here in SeaMonkey 1.x ( the MIME type of a downloaded file, and whether it should be handled as an attachment, does not appear in Firefox or in SeaMonkey 2). [4] [5] When this happens, the option to always perform the same action will either be "grayed-out" or, in Firefox, selecting the "Do this automatically" option will not seem to have an effect and you will again be asked what to do when you next encounter that file type (see below for related bug reports). There is little you can do in these cases because the problem is at the server end.

Resetting download actions

This section applies to all versions of Firefox and Mozilla Suite/SeaMonkey

If problems arise or if you want to restore the default set of file download actions, do the following [6]:

  1. Type about:config into the address bar.
  2. Find the preference browser.download.pluginOverrideTypes and, if it is present, right-click on it and select reset.
  3. Find the preference plugin.disable_full_page_plugin_for_types and, if it is present, right-click on it and select reset.
  4. Open the profile folder. (The profile folder is hidden by default in Windows 7/Vista/XP/2000 and Linux; read this for help finding it).
    Note: In Firefox 3.6 and above you can open the profile folder from the Firefox menu, via "Help -> Troubleshooting Information".
  5. Completely close your Mozilla browser.
  6. Delete (or rename) the file mimeTypes.rdf.

File handling in current Firefox and SeaMonkey versions

This section applies to all Firefox versions since Firefox 3 and SeaMonkey 2

Firefox and SeaMonkey will use an installed and enabled plugin to open a downloaded file by default, based on its MIME type (see Issues related to plugins for more information). Other download actions can be set from the Opening file dialog box that opens when you first encounter a particlar file type (see above).

You can manage what download actions are taken for file content types (MIME types) via the Applications tab in Firefox, shown here, and in the Helper Applications panel in SeaMonkey 2, shown below. (This applies to downloaded files only, not embedded content.) You can also set "Always ask" as an action for a listed content type (but note that the Opening dialog does not allow you to select a plugin action; read Opening files using plugins for more information). Web Feeds/Podcasts will also be listed as well as certain Internet protocols such as "mailto" or "rtsp".

The (Helper) Applications panel shows the Content Type (also known as the MIME type) , for example, "Wave Sound (audio/wav)", not the file extension. You may need to depend on the icon or content description to determine the type of file. Plugins are identified with "(in Firefox)" or "(in SeaMonkey)" after the handler name. You are able to change an action to "Always Ask" for a content type, but you cannot remove an entry. Also, the SeaMonkey 2 Helper Applications panel does not allow you to add a new file type, as you were able to do in SeaMonkey 1.x. [7] [8]

Important: Certain file extensions may include multiple content type entries, one for each MIME type associated with that type of file.

Built-in support for certain media

In addition to files such as plain text (TXT) and common images (JPG, JPEG, GIF, PNG) which Mozilla browsers can handle internally without needing a plugin or helper application, support for certain other files are built into the browser.

Portable Document Format (PDF)

Support for PDF files is built in to current Firefox versions and downloaded PDF files are previewed in Firefox by default. You can select a different action for the "Portable Document Format (PDF)" content type in the Firefox Applications window. See the Firefox Support article, How to disable the built-in PDF viewer and use another viewer for details. Built-in PDF support is not currently available in SeaMonkey. [9] [10]

Audio and video content

Support for open media (e.g., OGG and WebM container formats) is now built in to current versions of Firefox and SeaMonkey 2. Clicking on a download link to an "open media" file will open it automatically in the browser, although you can context-click (right-click) on the link and save the file. [11] [12]. Starting in Firefox 21 on Windows 7 and above (Firefox 22 on Windows Vista), MP3 and M4A audio files, as well as MP4 video files with the H.264 video codec and either AAC audio or MP3 audio codec, are also automatically opened in the built-in player by default (see bug 799315 for the background).

Settings in "Tools -> Options -> Applications" for audio and video content types with built-in support are ignored, unless you toggle the preference media.play-stand-alone to false in about:config (bug 861090). [13]

Note: Windows Media components may be missing on N and KN editions of Windows (sold to the European market) but you may be able to download a Media Feature Pack from Microsoft to install it. See this Mozilla Support article and this blog post for details.

Managing content types - Firefox 3 and above

This section applies to all Firefox versions since Firefox 3. The information in this section also applies, in general, to SeaMonkey 2.

This section provides information on the use of the Applications tab in Firefox, found in

  • Tools-> Options [Windows]
  • Edit->Preferences [Linux]
  • Preferences [Mac]

The information applies generally although the pictures shown below are what would appear on a Mac.


When Firefox 3 (or above) is first installed, there are two possibilities. First is a clean install with no previous profile and the second is an install with a previous profile (likely from Firefox 2). In the first case the Applications tab will only contain a list of files handled by installed plug-ins plus a few other defaults such as mailto.

In the case of a second install with an existing profile from Firefox 2, the Applications tab may contain file types added for Firefox 2 requiring external applications as show in the figure for PowerPoint.



A New File Type


As noted above for file types not already in the Applications tab, the first time you attempt to download a new file type the window at the right pops up. For this example a Rich Text Format or rtf file is used called test.rtf. At this point you can either elect to "Save File" (initial default) or "Open with".

If you select "Open with", you can then navigate after clicking the "Choose..." button to select an application. Once you have made a selection, checking the box "Do this automatically for files like this from now on." will cause the file type and action to be displayed in the Applications tab as shown below (in this example the selected application is TextEdit).


Image:FF3-TextEdit.png


Changing a File Type

If at some point you decide to change the default action, you can open the action drop down and select "Use other..." and navigate to select a different application. In the example below Microsoft Word was added. At this point you can elect to view the "Applications Details..." window below at right and remove TextEdit or leave both applications in the list.

Image:FF3-MSWord.png Image:FF3-Remove.png



Firefox Displays Wrong - Browser ABC Displays Correctly

One of the more common issues that arise in the Mozillazine Firefox Support Forum usually has subjects like:

  • Firefox is displaying code while Browser ABC displays correctly
  • Firefox not handling file correctly - asks to download

Most of the time these issues are traced to an incorrect MIME in the HTTP Response Header. Without getting overly technical it is instructive to provide a description of the cause of this.

Most people, read humans, that use computers are familiar with and understand the meaning of various file suffixes.

  • .doc is a Word file
  • .xls is an Excel file
  • .pdf is a Portable Document Format file
  • .jpg is an image file

They are predisposed to the idea that this is "how files are processed" by everything. In the case of files transferred from a web server to a browser, that is not correct. The Internet Engineering Task Force (IETF) in RFC2616 (Hypertext Transfer Protocol -- HTTP/1.1), Section 7.2.1 Type, states:

Any HTTP/1.1 message containing an entity-body SHOULD include a Content-Type header field defining the media type of that body. If and only if the media type is not given by a Content-Type field, the recipient MAY attempt to guess the media type via inspection of its content and/or the name extension(s) of the URI used to identify the resource.

In other words, how a file is processed by a browser is determined by the Content-Type field in the http Response Header; the file suffix should be ignored when there is a Content-Type field.

So, what is the problem? Web servers are complicated software packages. If one were to look at all the MIME type/subtype possibilities, there are more than 1,000. They run from the quite common (e.g., text/html) to the obscure (e.g., chemical/x-chemdraw or a ChemDraw file). Thus the probability of mis-configuring the MIME type/subtype data base used by the server is not zero. This non zero is further increased when amateur web site developers use a shared web site that charges $4.95 a month to host a site. There is virtually no support so the developer had better know what they're doing; which, is often not the case.

To illustrate the point consider two examples. Above the download action for a RTF file was to be opened with TextEdit. If the MIME type/subtype were specified correctly the following would be the result


This is a test of a Rich Text Format File also known as RTF.
This is a red test of a Rich Text Format File also known as RTF.


displayed using the TextEdit Application. On the other hand, if the MIME type/subtype were specified as text/plain, the result would be

{\rtf1\mac\ansicpg10000\cocoartf824\cocoasubrtf480
{\fonttbl\f0\fswiss\fcharset77 Helvetica;}
{\colortbl;\red255\green255\blue255;\red234\green23\blue23;}
\margl1440\margr1440\vieww9000\viewh8400\viewkind0
\pard\tx720\tx1440\tx2160\tx2880\tx3600\tx4320\tx5040\tx5760\tx6480\tx7200\tx7920\tx8640\ql\qnatural\pardirnatural

\f0\fs24 \cf0 This is a test of a Rich Text Format File also known as RTF.\
\
\cf2 This is a red test of a Rich Text Format File also known as RTF.\cf0 \
}

even if the file suffix were rtf.

In the case of a html file with the content-type improperly specified as text/plain you would see this with Firefox

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01//EN" "http://www.w3.org/TR/html4/strict.dtd">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<TITLE>Test Page</TITLE>
<LINK REL="stylesheet" TYPE="text/css" HREF="test0.css">
</HEAD>

rest of code

With other browsers, particularly older versions the page may render "correctly".

So what can you do? Usually you should try to inform the site's webmaster of the incorrect configuration.

Managing content types - SeaMonkey 2

Go to "Edit -> Preferences -> Browser -> Helper Applications". The Helper Applications panel in SeaMonkey 2 will open. Here, you can change download actions in the same way as explained above for Firefox 3.

Image:SM2-HelperApps.png

File handling in Firefox 2 and SeaMonkey 1.x

This section describes file handling in older versions of Firefox and SeaMonkey.

Managing file types - Firefox 2

This will not affect media embedded in a web page - only links to the files themselves. Certain file extensions may include multiple entries, one for each MIME type associated with that type of file.


Changing download actions

Go to "Tools -> Options -> Content / File Types -> Manage...". The Download Actions window will open. (MIME types are not shown by default. Click the icon in the top right corner and select "MIME Type" to display them.)

Select a file type entry and click 'Change Action...'

  • If you want files of that type to open with the default application, select "Open them with the default application".
  • If you want a different application to handle that type, select "Open them with this application" and choose the application. Caution: Make sure that the application you choose can handle the file type. For example, to choose Windows Media Player, browse to the C:\Program Files\Windows Media Player folder in the "Select Helper Application" window and select "wmplayer.exe".
  • If you want the file to be saved instead of opened, select "Save them on my computer".
  • In some cases, the option "Use this Plugin" will be available. It is the default action if a plugin is found for the file type.


Adding a download action

MIME types that are not handled by plugins do not appear in the Download Actions listing unless you have previously encountered that type of file and checked the option in the "Opening" dialog box to "Do this automatically for files like this from now on", as described above. You cannot add new file types to the Download Actions listing in Firefox, as you can in Mozilla Suite/SeaMonkey 1.x. The Mimetype Editor/Download Actions extension provides the SeaMonkey 1.x "Helper Applications" interface, shown below, as a Firefox add-on.


Removing a download action

After a helper application or "save to disk" download action has been set, that action will be taken automatically for those types of files. To remove a download action, open the Download Actions dialog as described above, select the file type entry and click the "Remove action" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file.

Removing a download action does not affect files that are handled by plugins. Firefox 2 will automatically use a plugin if it is available for the MIME type, as shown in the about:plugins list.

Managing file types - SeaMonkey 1.x

This applies to Mozilla Suite / SeaMonkey 1.x

Go to "Edit -> Preferences -> Navigator -> Helper Applications". The Helper Applications preferences panel will open. Mozilla Suite and SeaMonkey 1.x list file type entries by MIME type, not file extension.


Changing actions for file types

This will not affect media embedded in a web page - only links to the files themselves.

In the Helper Applications panel, the entries will be listed as MIME types. Select the entry for the file type you wish to change and click the 'Edit' button to change the action.

  • If you want files of that type to open with the default application, select "Open it using the default application"
  • If you want a different application to handle that type, select "Open it with" and use the "Choose..." button to locate the program executable.
  • If you want the file to be saved instead of opened, select "Save it to disk".

Note: Mozilla Suite and SeaMonkey 1.x do not list plugin actions in the Helper Applications listing. You cannot disable a plugin for file downloads here. You can check in "Help -> About Plug-ins" to see which MIME types are automatically handled by plugins.


Adding a file type

The Helper Applications preference panel (shown above) allows you to add new download actions for MIME types. Clicking the "New Type..." button opens a dialog where you can add the MIME type (e.g. application/msword) description (e.g. Word Document) and file extension (e.g. doc). You can set the new download action to either open with a specified helper application or save to disk.

The actions you add will not affect MIME types that are handled internally, which include certain MIME types such as image/jpeg or text/plain [14] and all MIME types that are handled by plugins [15]. Before adding a new action for such MIME types, a Warning dialog similar to the following will be displayed:
Image:InternalMIMEtype.png


Removing a file type

After a helper application or "save to disk" action has been set, that action will be taken automatically for those types of files. To remove an action for a file type, open the Helper Applications preference panel as described above, select the file type entry and click the "Remove" button. The next time you encounter that type of file, an "Opening" dialog will appear, asking you to specify an application or save the file.

Removing a file type from the Helper Applications list does not affect files that are handled by plugins. Mozilla Suite/SeaMonkey 1.x will automatically use a plugin if it is available for the MIME type, as shown in the about:plugins list.

See also

External links

Related bug reports

Please do not comment in bug reports unless you are helping to fix the bug. Also note that some of the bugs listed below are fixed and others may be marked "invalid" or "wontfix"; these are included for informational purposes only.