MozillaZine

Uninstalling add-ons

From MozillaZine Knowledge Base

(Difference between revisions)
Revision as of 00:57, 10 February 2005
Hao2lian (Talk | contribs)
(user.js file)
<-- Previous diff
Revision as of 14:03, 14 February 2005
Asqueella (Talk | contribs)
(fix broken layout)
Next diff -->
Line 1: Line 1:
''You may be experiencing problems with uninstalling a theme rather than an extension. The principles described in this article apply to themes too, since these are treated as extensions by the new Extension Manager.'' ''You may be experiencing problems with uninstalling a theme rather than an extension. The principles described in this article apply to themes too, since these are treated as extensions by the new Extension Manager.''
-===The New Extension Manager===+==The New Extension Manager==
The Extension Manager in Firefox 0.9+ and Thunderbird 0.7+ is capable of uninstalling extensions (Tools | Extensions) and themes (Tools | Themes). The Extension Manager in Firefox 0.9+ and Thunderbird 0.7+ is capable of uninstalling extensions (Tools | Extensions) and themes (Tools | Themes).
Line 8: Line 8:
* The extension repeatedly shows "This item will be uninstalled after you restart Firefox" even after restarting. In this case, do not use the uninstaller extensions. Either [[Profile Folder | create a new profile]] or try uninstalling manually (see below). * The extension repeatedly shows "This item will be uninstalled after you restart Firefox" even after restarting. In this case, do not use the uninstaller extensions. Either [[Profile Folder | create a new profile]] or try uninstalling manually (see below).
-===Uninstaller Extensions===+==Uninstaller Extensions==
-These extensions are useful for Firefox (pre-0.9), Thunderbird (pre-0.7), and Mozilla Suite users.+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! Either [[Profile Folder | create a new profile]] or see the section below on performing a manual uninstall.'' ''Do not use these extensions if you have the "This item will be uninstalled after you restart Firefox" message in the extension manager! Either [[Profile Folder | create a new profile]] or see the section below on performing a manual uninstall.''
Line 16: Line 16:
*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.) *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 strongly recommended that you [[Profile Folder | create a new profile]] instead of uninstalling manually due to the risks and tedium involved in the manual procedure. It is strongly recommended that you [[Profile Folder | create a new profile]] instead of uninstalling manually due to the risks and tedium involved in the manual procedure.
It's a good idea to [[Profile backup | make backups of your profile folder]] before deleting or changing anything in case something 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.
-====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 <tt>chrome.rdf</tt> 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 <tt>chrome.rdf</tt> file (see below).
-# Exit Firefox or Thunderbird and make sure it is not listed in your process list (Ctrl-Alt-Delete on Windows).+<ol>
-# Browse to your [[Profile Folder | profile folder]].+<li>Exit Firefox or Thunderbird and make sure it is not listed in your process list (Ctrl-Alt-Delete on Windows).
-# '''Mozilla Suite users''': Remove the <tt>&lt;profile folder&gt/chrome/[shortname].jar</tt> file.<br>'''All other users''': Remove the <tt>&lt;profile folder&gt;/extensions/{extension-GUID}</tt> folder. You can find the GUID by looking in extensions.rdf file or by searching for <tt>[shortname].jar</tt> file in your <tt>extensions</tt> folder.+<li>Browse to your [[Profile Folder | profile folder]].
-# 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>'''Mozilla Suite users''': Remove the <tt>&lt;profile folder&gt/chrome/[shortname].jar</tt> file.<br>'''All other users''': Remove the <tt>&lt;profile folder&gt;/extensions/{extension-GUID}</tt> folder. You can find the GUID by looking in extensions.rdf file or by searching for <tt>[shortname].jar</tt> file in your <tt>extensions</tt> folder.
-# Edit files in <tt>&lt;profile folder&gt;/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>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.
-# Edit the <tt>&lt;profile folder&gt;/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]].+<li>Edit files in <tt>&lt;profile folder&gt;/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>
-# '''Firefox and Thunderbird users''': Edit <tt>&lt;profile folder&gt;/extensions/extensions.rdf</tt>. Remove the entry that looks like this:<br><pre><RDF:Description RDF:about="urn:mozilla:extension:{[GUID]}"+<li>Edit the <tt>&lt;profile folder&gt;/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]].
 +<li>'''Firefox and Thunderbird users''': Edit <tt>&lt;profile folder&gt;/extensions/extensions.rdf</tt>. Remove the entry that looks like this:<br><pre><RDF:Description RDF:about="urn:mozilla:extension:{[GUID]}"
em:name="QuickNote" em:name="QuickNote"
[more info]> [more info]>
Line 35: Line 36:
<em:targetApplication RDF:resource="rdf:[junk]"/> <em:targetApplication RDF:resource="rdf:[junk]"/>
</RDF:Description></pre> </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. The files are located in the root of your [[Profile Folder | profile folder]].+<li>'''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. The files are located in the root of your [[Profile Folder | profile folder]].
-# Remove extension-related preferences from the [[user.js file]].+<li>Remove extension-related preferences from the [[user.js file]] and prefs.js.
- +</ol>
Some extensions also create extra files on your hard drive. For example, [http://menueditor.mozdev.org/ Menu Editor] stores its data in a <tt>menuedit.rdf</tt> file in your [[Profile Folder|profile folder]] and [http://piro.sakura.ne.jp/xul/tabextensions/index.html.en TBE] uses <tt>tabextensions.js</tt>. You might want to remove those too. Some extensions also create extra files on your hard drive. For example, [http://menueditor.mozdev.org/ Menu Editor] stores its data in a <tt>menuedit.rdf</tt> file in your [[Profile Folder|profile folder]] and [http://piro.sakura.ne.jp/xul/tabextensions/index.html.en TBE] uses <tt>tabextensions.js</tt>. You might want to remove those too.
-======The list of possible chrome.rdf entries======+=====The list of possible chrome.rdf entries=====
-* <pre><RDF:li RDF:resource="urn:mozilla:package:[shortname]"/></pre>+<ul>
-* <pre><RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/></pre>+<li><pre><RDF:li RDF:resource="urn:mozilla:package:[shortname]"/></pre>
-* <pre><RDF:li RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/></pre>+<li><pre><RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/></pre>
-* <pre><RDF:Description RDF:about="urn:mozilla:["locale"/"skin"]:[locale/skin]:[shortname]"+<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]"
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> </RDF:Description></pre>
-* <pre><RDF:Description RDF:about="urn:mozilla:package:[shortname]"+<li><pre><RDF:Description RDF:about="urn:mozilla:package:[shortname]"
c:baseURL="[path]" c:baseURL="[path]"
[a lot more info]> [a lot more info]>
Line 55: Line 57:
<c:selectedSkin RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/> <c:selectedSkin RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>
</RDF:Description></pre> </RDF:Description></pre>
 +</ul>
-====Removing a globally-installed extension====+===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). 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).

Revision as of 14:03, 14 February 2005

You may be experiencing problems with uninstalling a theme rather than an extension. The principles described in this article apply to themes too, since these are treated as extensions by the new Extension Manager.

Contents

The New Extension Manager

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

If you can't uninstall an extension with the new extension manager, then one of the following has occured:

  • The uninstall button and menu item are disabled. This means that the extension is locked. (For example, the default theme is locked.) To uninstall a locked extension, you'll first have to unlock it.
  • The extension is listed with a red "generic" icon, or is not listed at all. This means that the extension was not packaged for the new Extension Manager. You'll have to uninstall it manually or use an extension uninstaller (see below). The general recommendation is to create a new profile for Firefox or Thunderbird and only install repackaged extensions in it.
  • The extension repeatedly shows "This item will be uninstalled after you restart Firefox" even after restarting. In this case, do not use the uninstaller extensions. Either create 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! Either create a new profile or see the section below on performing a manual uninstall.

Uninstalling manually

It is strongly recommended that you create a new profile instead of uninstalling manually due to the risks and tedium involved in the manual procedure.

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). <li>Browse to your profile folder. <li>Mozilla Suite users: Remove the <profile folder&gt/chrome/[shortname].jar file.
    All other users: Remove the <profile folder>/extensions/{extension-GUID} folder. You can find the GUID by looking in extensions.rdf file or by searching for [shortname].jar file in your extensions folder. <li>Delete compreg.dat and xul.mfl (it may be called slightly differently) files. They will be recreated on next browser start. <li>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>

    <li>Edit the <profile folder>/chrome/chrome.rdf file. Remove all entries referencing the extension. See the list of possible entries.

    <li>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>

    <li>Firefox and Thunderbird users: Edit components.ini and defaults.ini and remove the lines that contain the GUID of the extension being uninstalled. The files are located in the root of your profile folder. <li>Remove extension-related preferences from the user.js file and prefs.js. </ol>

    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
      <li>
      <RDF:li RDF:resource="urn:mozilla:package:[shortname]"/>
      <li>
      <RDF:li RDF:resource="urn:mozilla:locale:[locale]:[shortname]"/>
      <li>
      <RDF:li RDF:resource="urn:mozilla:skin:[skin]:[shortname]"/>
      <li>
      <RDF:Description RDF:about="urn:mozilla:["locale"/"skin"]:[locale/skin]:[shortname]"
                       c:baseURL="[path]">
        <c:package RDF:resource="urn:mozilla:package:[shortname]"/>
      </RDF:Description>
      <li>
      <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" subfolder of your Mozilla application folder (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 up to three such lines corresponding to content, locale and skin.
    6. A few extensions might use additional files. TBE, for example, creates the file tabextensions.js in <application folder>/defaults/pref/ in which to store its defaults. Search through your application folder for such files and delete them.