Uninstalling add-ons: Difference between revisions

From MozillaZine Knowledge Base
Jump to navigationJump to search
m (add info to todo items, tweak formatting a bit)
(Overhaul)
Line 1: Line 1:
===The New Extension Manager===
===The New Extension Manager===
Extension Manager in Firefox 0.9+ and Thunderbird 0.7+ is capable of uninstalling extensions. It is available as Tools -> Extensions menu item.
The Extension Manager in Firefox 0.9+ and Thunderbird 0.7+ is capable of uninstalling extensions (Tools -> Extensions).


If you can't uninstall an extension with the new EM, it means that:
If you can't uninstall an extension with the new extension manager, it means that:
*The extension in question is "locked" ''(the uninstall button/menu item is disabled)''. An example of such extension is DOM Inspector. You'll have to [[Unlocking an extension|unlock]] it before uninstalling.
* The extension in question is "locked" and the uninstall button/menu item is disabled'. An example of such an extension is the DOM Inspector. You'll have to [[Unlocking an extension|unlock]] it before uninstalling.
*The extension was not packaged for the new EM ''(it has a red "generic" icon or not listed in the EM at all)''. You'll have to uninstall it manually or using an extension uninstaller (see the sections below). The general recommendation is: create a new profile for Firefox 0.9 / Thunderbird 0.7 and only install repackaged extensions in it.
* The extension was not packaged for the new extensions manager (it has a red "generic" icon or not listed in the EM at all). You'll have to uninstall it manually or using an extension uninstaller (see below). The general recommendation is: [[Profile Folder | create a new profile for Firefox or Thunderbird]] and only install the repackaged extensions in it.
*Or you've got bitten by a bug in the Extension Manager ''("This item will be uninstalled after you restart Firefox" forever)'' and/or the extension in question was poorly packaged. Do '''not''' use uninstaller extensions in this case. Either start a new profile or try uninstalling manually (see section below).
* If the extension repeatedly shows "This item will be uninstalled after you restart Firefox" even after restarting, do not use the uninstaller extensions. Either [[Profile Folder | start a new profile]] or try uninstalling manually (see below).
 
===Uninstaller Extensions===
These extensions are useful for Firefox (pre-0.9), Thunderbird (pre-0.7), and Mozilla Suite users.
 
''Do not use these extensions if you have the "This item will be uninstalled after you restart Firefox" message in the extension manager''! [[Profile Folder | Start a new profile]] or follow the steps in "Uninstalling manually" section instead.
 
*[http://jgillick.nettripper.com/extuninstaller/ Extension Uninstaller] by [http://jgillick.nettripper.com/ Jeremy Gillick], an extension built from the ground up to uninstall extensions. [http://forums.mozillazine.org/viewtopic.php?t=78407 Discuss] this in the forums. [http://update.mozilla.org/ Mozilla Update] links: [http://update.mozilla.org/extensions/moreinfo.php?id=203&vid=451] [http://update.mozilla.org/extensions/moreinfo.php?id=202&vid=449]
*Uninstaller (''discontinued'') by [http://chrispederick.myacen.com/work/firefox/ Chris Pederick]. An extension which also automates this task. [http://forums.mozillazine.org/viewtopic.php?t=53890 Discuss] this in the forums.


===Uninstalling manually===
===Uninstalling manually===
It is highly recommended that you disable or ignore the profile or [[Profile Folder | create a new profile instead of uninstalling manually due to the risks and tediousness involved]].


'''It's a good idea to make backups of the files/directories before deleting/changing anything to be able to restore the status quo in case anything goes wrong.'''
It's a good idea to [[Profile backup | make backups of your profile folder]] before deleting or changing anything in case something goes wrong.
 
First, determine if the extension is installed in profile or in an appllication directory. For Firefox 0.9+/Thunderbird 0.7+ the default is profile installation.


====Removing profile-installed extensions====
====Removing profile-installed extensions====
You'll need to know the internal "short name" of the extension you're uninstalling. You can find it by searching for the full name in the chrome.rdf file (see below).
You'll need to know the internal "short name" of the extension you're uninstalling. You can find it by searching for the full name in the chrome.rdf file (see below).
"New EM" in the steps below refers to Mozilla Firefox 0.9 and above and Mozilla Thunderbird 0.7 and above.
# Exit Firefox or Thunderbird and make sure it is not listed in your process list (Ctrl-Alt-Delete on Windows).
# Browse to your [[Profile folder | profile folder]].
# '''Mozilla users''': Remove the <tt>[[Profile Folder | profile folder]]/chrome/[shortname].jar</tt> file.<br>'''All other users''': Remove the <tt>[[Profile Folder | profile folder]]/extensions/{extension-GUID}</tt> directory. You can find the GUID by looking in extensions.rdf file or by searching for <tt>[shortname].jar</tt> file in your Extensions directory.
# Delete <tt>compreg.dat</tt> and <tt>xul.mfl</tt> (it may be called slightly differently) files. They will be recreated on next browser start.


<ol>
=====Optional steps=====
<li>Exit Mozilla/Firefox/Thunderbird (make sure it is not listed in Task Manager[win])</li>
Your extension will now be uninstalled, but there are a few (harmless) remnants left, so the following sections are optional.
<li>Browse to your [[Profile Folder]].</li>
 
# Edit files in <tt>[[Profile Folder]]\chrome\overlayinfo</tt>. Find those that contain [shortname] inside them and remove entries, that look like this: <pre><RDF:li>chrome://[shortname]/[path/to/file]</RDF:li></pre>
# Edit the <tt>[[Profile Folder | profile folder]]/chrome/chrome.rdf</tt> file. Remove all entries referencing the extension. See [[Uninstalling Extensions#The_list_of_possible_chrome.rdf_entries | the list of possible entries]].
# '''Firefox and Thunderbird users''': Edit <tt>[[Profile Folder | profile folder]]/extensions/extensions.rdf</tt>. Remove the entry that looks like this:<br><pre><RDF:Description RDF:about="urn:mozilla:extension:{[GUID]}"
                em:name="QuickNote"
                [more info]>
  [more info]
  <em:targetApplication RDF:resource="rdf:[junk]"/>
</RDF:Description></pre>
# '''Firefox and Thunderbird users''': Edit <tt>components.ini</tt> and <tt>defaults.ini</tt> and remove the lines that contain the GUID of the extension being uninstalled. They are located in the root of your profile folder.
# Remove extension-related preferencess from <tt>[[prefs.js]]</tt>.


<li>'''New EM:''' remove the <tt>[[Profile Folder]]\extensions\{extension-GUID}</tt> directory. You can find the GUID by looking in extensions.rdf file or by searching for <tt>[shortname].jar</tt> file in your Extensions directory.<br>
Some extensions also create extra files on your hard drive. For example, Menu Editor stores its data in a <tt>menuedit.rdf</tt> file in your profile folder and TBE uses <tt>tabextensions.js</tt>. You might want to remove those too.
'''Mozilla:''' remove the <tt>[[Profile Folder]]\chrome\[shortname].jar</tt> file.</li>


<li>Edit the <tt>[[Profile Folder]]\chrome\chrome.rdf</tt> file. Remove all entries referencing the extension being removed. The list of possible entries:
======The list of possible chrome.rdf entries======
<ul>
* <pre><RDF:li RDF:resource="urn:mozilla:package:[shortname]"/></pre>
<li><pre><RDF:li RDF:resource="urn:mozilla:package:[shortname]"/></pre></li>
* <pre><RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/></pre>
<li><pre><RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/></pre></li>
* <pre><RDF:li RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/></pre>
<li><pre><RDF:li RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/></pre></li>
* <pre><RDF:Description RDF:about="urn:mozilla:["locale"/"skin"]:[locale/skin]:[shortname]"
<li><pre><RDF:Description RDF:about="urn:mozilla:["locale"/"skin"]:[locale/skin]:[shortname]"
                 c:baseURL="[path]">
                 c:baseURL="[path]">
   <c:package RDF:resource="urn:mozilla:package:[shortname]"/>
   <c:package RDF:resource="urn:mozilla:package:[shortname]"/>
</RDF:Description></pre></li>
</RDF:Description></pre>
<li><pre><RDF:Description RDF:about="urn:mozilla:package:[shortname]"
* <pre><RDF:Description RDF:about="urn:mozilla:package:[shortname]"
                 c:baseURL="[path]"
                 c:baseURL="[path]"
                 [a lot more info]>
                 [a lot more info]>
   <c:selectedLocale RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/>
   <c:selectedLocale RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/>
   <c:selectedSkin RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>
   <c:selectedSkin RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>
</RDF:Description></pre></li>
</ul>
</li>
<li>Edit files in <tt>[[Profile Folder]]\chrome\overlayinfo</tt>. Find those that contain [shortname] inside them and remove entries, that look like this: <pre><RDF:li>chrome://[shortname]/[path/to/file]</RDF:li></pre>
</li>
<li>'''New EM only.''' Edit <tt>[[Profile Folder]]\extensions\extensions.rdf</tt>. Remove the entry that looks like this:
<pre><RDF:Description RDF:about="urn:mozilla:extension:{[GUID]}"
                em:name="QuickNote"
                [more info]>
  [more info]
  <em:targetApplication RDF:resource="rdf:[junk]"/>
</RDF:Description></pre>
</RDF:Description></pre>
</li>
<li>'''New EM only''' Edit <tt>components.ini</tt> and <tt>defaults.ini</tt>: remove the lines that contain the GUID of the extension being uninstalled (''writeme'')</li>
<li>Delete <tt>compreg.dat</tt> and <tt>xul.mfl</tt> (it may be called slightly differently) files. They will be recreated on next browser start.</li>
<li>Optionally, remove extension-related prefs from <tt>[[prefs.js]]</tt></li>
<li>Also you might want to edit <tt>localstore.rdf</tt>, but it is unnecessary. Usually, UI options (windows position/size etc) are stored there.</li>
<li>Some extensions create extra files on your hard drive. For example, Menu Editor stores its data in <tt>menuedit.rdf</tt> file in your profile, and TBE uses <tt>tabextensions.js</tt>. You might want to remove those too.</li>
</ol>


====Removing a globally-installed extension====
====Removing a globally-installed extension====
''This section is outdated''
Firefox 0.9+ and Thunderbird 0.7+, by default, install their extensions into the profile folder, so this section will not apply to those users. Mozilla users are still able to install their extensions globally (that is, in their Mozilla application folder and not their profile folder).


# Exit Mozilla Firefox.
# Exit Mozilla.
# Browse to the "chrome" directory of your Mozilla Firefox application directory.
# Browse to the "chrome" directory of your Mozilla application directory (usually <tt>C:\Program Files\Mozilla Firefox\chrome</tt> for Windows users; for Mac users, Ctrl-Click the Mozilla Application folder package and select "Show Package Contents" and browse to <tt> /Applications/Mozilla.app/Contents/MacOS/chrome</tt>).
# Delete "chrome.rdf" and the "overlayinfo" directory (they will regenerated on next Firefox startup).
# Modify <tt>chrome.rdf</tt> and the files in your "overlay" folder as described above in the "Optional steps" section.
# Delete [extensionname].jar (or the [extensionname] directory, if it has one).
# Delete <tt>[extensionname].jar</tt> (or the [extensionname] directory if it has one).
# Remove every line with a reference to [extensionname] from "installed-chrome.txt". Usually there are two: one to the content and one to the locale.
# Remove every line with a reference to the extension's name from <tt>installed-chrome.txt</tt>. Usually there are two: one to the content and one to the locale.
# A few extensions might use additional files. TBE, for examplem has a "tabextensions.js" in "[/path/to/firefox]/defaults/pref/" to store its defaults in. Search through your application dir for such files and delete them.
# A few extensions might use additional files. TBE, for examplem has a "tabextensions.js" in <tt>application folder/defaults/pref/</tt> to store its defaults in. Search through your application dir for such files and delete them.
# Restart Mozilla Firefox.


<!--
<!--
'''Note''': The procedure above applies only to extensions that are installed in the application directory.  To remove extensions from the profile, your safest course of action is to [[Profile Folder | create a new profile]] and [http://gemal.dk/mozilla/files.html transfer over files] from the previous one.
'''Note''': The procedure above applies only to extensions that are installed in the application directory.  To remove extensions from the profile, your safest course of action is to [[Profile Folder | create a new profile]] and [http://gemal.dk/mozilla/files.html transfer over files] from the previous one.
-->
-->
===Uninstaller Extensions===
These extensions are useful for Firefox (pre-0.9), Thunderbird (pre-0.7) and Mozilla Suite users.
''Do not use these extensions if you get the "This item will be uninstalled after you restart Firefox" message (after uninstalling and restarting Firefox) in extension manager!'' Start a new profile or follow the steps in "Uninstalling manually" section instead.
*[http://jgillick.nettripper.com/extuninstaller/ Extension Uninstaller] by [http://jgillick.nettripper.com/ Jeremy Gillick], an extension built from the ground up to uninstall extensions. [http://forums.mozillazine.org/viewtopic.php?t=78407 Discuss] this in the forums. Update.mozilla.org links: [http://update.mozilla.org/extensions/moreinfo.php?id=203&vid=451] [http://update.mozilla.org/extensions/moreinfo.php?id=202&vid=449]
*Uninstaller ''(discontinued)'' by [http://chrispederick.myacen.com/work/firefox/ Chris Pederick], an extension, automates this task. [http://forums.mozillazine.org/viewtopic.php?t=53890 Discuss] this in the forums.

Revision as of 15:27, 9 January 2005

The New Extension Manager

The Extension Manager in Firefox 0.9+ and Thunderbird 0.7+ is capable of uninstalling extensions (Tools -> Extensions).

If you can't uninstall an extension with the new extension manager, it means that:

  • The extension in question is "locked" and the uninstall button/menu item is disabled'. An example of such an extension is the DOM Inspector. You'll have to unlock it before uninstalling.
  • The extension was not packaged for the new extensions manager (it has a red "generic" icon or not listed in the EM at all). You'll have to uninstall it manually or using an extension uninstaller (see below). The general recommendation is: create a new profile for Firefox or Thunderbird and only install the repackaged extensions in it.
  • If the extension repeatedly shows "This item will be uninstalled after you restart Firefox" even after restarting, do not use the uninstaller extensions. Either start a new profile or try uninstalling manually (see below).

Uninstaller Extensions

These extensions are useful for Firefox (pre-0.9), Thunderbird (pre-0.7), and Mozilla Suite users.

Do not use these extensions if you have the "This item will be uninstalled after you restart Firefox" message in the extension manager! Start a new profile or follow the steps in "Uninstalling manually" section instead.

Uninstalling manually

It is highly recommended that you disable or ignore the profile or create a new profile instead of uninstalling manually due to the risks and tediousness involved.

It's a good idea to make backups of your profile folder before deleting or changing anything in case something goes wrong.

Removing profile-installed extensions

You'll need to know the internal "short name" of the extension you're uninstalling. You can find it by searching for the full name in the chrome.rdf file (see below).

  1. Exit Firefox or Thunderbird and make sure it is not listed in your process list (Ctrl-Alt-Delete on Windows).
  2. Browse to your profile folder.
  3. Mozilla users: Remove the profile folder/chrome/[shortname].jar file.
    All other users: Remove the profile folder/extensions/{extension-GUID} directory. You can find the GUID by looking in extensions.rdf file or by searching for [shortname].jar file in your Extensions directory.
  4. Delete compreg.dat and xul.mfl (it may be called slightly differently) files. They will be recreated on next browser start.
Optional steps

Your extension will now be uninstalled, but there are a few (harmless) remnants left, so the following sections are optional.

  1. Edit files in Profile Folder\chrome\overlayinfo. Find those that contain [shortname] inside them and remove entries, that look like this:
    <RDF:li>chrome://[shortname]/[path/to/file]</RDF:li>
  2. Edit the profile folder/chrome/chrome.rdf file. Remove all entries referencing the extension. See the list of possible entries.
  3. Firefox and Thunderbird users: Edit profile folder/extensions/extensions.rdf. Remove the entry that looks like this:
    <RDF:Description RDF:about="urn:mozilla:extension:{[GUID]}"

em:name="QuickNote" [more info]> [more info] <em:targetApplication RDF:resource="rdf:[junk]"/> </RDF:Description>

  1. Firefox and Thunderbird users: Edit components.ini and defaults.ini and remove the lines that contain the GUID of the extension being uninstalled. They are located in the root of your profile folder.
  2. Remove extension-related preferencess from prefs.js.

Some extensions also create extra files on your hard drive. For example, Menu Editor stores its data in a menuedit.rdf file in your profile folder and TBE uses tabextensions.js. You might want to remove those too.

The list of possible chrome.rdf entries
  • <RDF:li RDF:resource="urn:mozilla:package:[shortname]"/>
  • <RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/>
  • <RDF:li RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>
  • <RDF:Description RDF:about="urn:mozilla:["locale"/"skin"]:[locale/skin]:[shortname]"

c:baseURL="[path]"> <c:package RDF:resource="urn:mozilla:package:[shortname]"/> </RDF:Description>

  • <RDF:Description RDF:about="urn:mozilla:package:[shortname]"
                c:baseURL="[path]"
                [a lot more info]>
 <c:selectedLocale RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/>
 <c:selectedSkin RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>

</RDF:Description>

Removing a globally-installed extension

Firefox 0.9+ and Thunderbird 0.7+, by default, install their extensions into the profile folder, so this section will not apply to those users. Mozilla users are still able to install their extensions globally (that is, in their Mozilla application folder and not their profile folder).

  1. Exit Mozilla.
  2. Browse to the "chrome" directory of your Mozilla application directory (usually C:\Program Files\Mozilla Firefox\chrome for Windows users; for Mac users, Ctrl-Click the Mozilla Application folder package and select "Show Package Contents" and browse to /Applications/Mozilla.app/Contents/MacOS/chrome).
  3. Modify chrome.rdf and the files in your "overlay" folder as described above in the "Optional steps" section.
  4. Delete [extensionname].jar (or the [extensionname] directory if it has one).
  5. Remove every line with a reference to the extension's name from installed-chrome.txt. Usually there are two: one to the content and one to the locale.
  6. A few extensions might use additional files. TBE, for examplem has a "tabextensions.js" in application folder/defaults/pref/ to store its defaults in. Search through your application dir for such files and delete them.