Skip to content
Tab Mix Plus - Docs

Installation

Install Firefox Scripts

Please follow the instructions below step-by-step to install the scripts. The extension will not work if you install any files in the wrong location.

Download latest scripts

It is recommended to check periodically, or at least with every Firefox update, if new Firefox Scripts are available. Visit @xiaoxiaoflood firefox-scripts repository and look for updates, OR download the latest version:

Install config script

Open about:support and locate the path to your Application Binary and Profile Folder
about-support

Copy configuration files to your Firefox root directory.
fx-folder.zip files are packed with paths used by Firefox for Windows, Linux and macOS users should follow the instructions below. the zip file contain the following files:

  • config.js - This file should be copied to the directory that contains firefox.exe, referred to as PATH TO FIREFOX.EXE.
  • config-prefs.js - This file should be copied to [PATH TO FIREFOX.EXE]/defaults/pref.

Note:
The default path to Firefox on Windows is typically:

64-bit Firefox: C:\Program Files\Mozilla Firefox\
32-bit Firefox: C:\Program Files (x86)\Mozilla Firefox\

Verify the path:
Check the actual path to your Firefox root directory. If it differs from the default, replace the path accordingly in the following instructions.

Copy the configuration files extracted from fx-folder.zip:

  • copy the file config.js to [PATH TO FIREFOX.EXE]\config.js.
  • copy the file config-prefs.js to [PATH TO FIREFOX.EXE]\defaults\pref\config-prefs.js

Install utils

Remember, the utils script needs to be installed separately in each profile where you want to use Tab Mix Plus. This differs from the main config script, which only requires installation once in your Firefox root directory (containing firefox.exe). The reason for this distinction is that each profile maintains its own settings and data, and the utils script plays a vital role in ensuring Tab Mix Plus works seamlessly within each individual profile.

  1. Locate your Profile Folder as described in the previous step.

  2. Create chrome folder in your Profile Folder (if one does not exist).

  3. Extract utils folder inside the chrome folder, the result should be [PROFILE_NAME]/chrome/utils, all the files should be in the utils folder (see the screenshot below).
    Make sure all the files you see in the screenshot below are in the utils folder and that utils folder is inside chrome folder.

  4. Open about:support page and click Clear startup cache… to force Firefox to load the installed scripts on the next startup.

utils folder

Install Tab Mix Plus

Download XPI

Download xpi file from our download page to your local computer.
All Tab Mix Plus downloads are also located here and here

If you are using Firefox Beta, Developer Edition or Nightly we recommend using the latest Tab Mix Plus development build (tags with pre or test-build in the title)

Install XPI

To install the XPI file you have just downloaded:

  1. Open Add-ons Manager tab (about:addons) and select Extensions.
    or Click the menu button ☰, click Add-ons and Themes and select Extensions.

  2. In Add-ons Manager page click on the cog icon and select Install Add-on From File…. install-from-file

  3. Alternatively, drag and drop the XPI file into the Add-ons Manager page.

  4. The installation process should begin automatically, once it complete you should restart firefox.

Troubleshooting

Add-on appears corrupt

If you see this message when you try to install Tab Mix Plus, it means that you did not install Firefox Scripts properly. Repeat the installation steps above. appears_corrupt

Tab Mix Plus stops working

If Tab Mix Plus stops working after Firefox update was installed or after you installed update of Firefox Scripts , follow these instructions

  1. Uninstall Tab Mix Plus.
  2. Reinstall the latest versions of Firefox Scripts (see instructions above)
  3. Open about:support page and click Clear startup cache… to force Firefox to load the installed scripts on the next startup.
  4. Close Firefox again, wait 10 second, to make sure Firefox finished to clear the cache.
  5. Open Firefox and reinstall latest Tab Mix Plus again.

extensions.experiments.enabled

Some users report that their Firefox is not able to install or use Tab Mix Plus unless they set extensions.experiments.enabled to true in about:config.

Profile Cache Issues

Sometimes the profile cache is not cleared when you install new version of Firefox, or new version of these scripts, this can cause problems with Tab Mix Plus.

First step will be to use firefox command to clear the profile cache:
Open about:support page and click Clear startup cache… to force Firefox to load the installed scripts on the next startup.

You can try to clear your profile cache, go to 'about:config', find your profile, and follow the link to Local Directory where Firefox save your profile cache, and remove it. profile

Browser Compatibility

Tab Mix Plus is fully compatible with the following browsers:

  • Firefox 78 - Firefox Nightly
  • Waterfox G3 - G6 and beyond
  • Floorp 11.9.0
  • LibreWolf 122

For Pale Moon download Tab Mix Plus from here