Installation

Note

Since Firefox removed the internal component that loads legacy extension, in order to install Tab Mix Plus, or any other legacy extension, you have to install 3rd party helper scripts.
Visit @xiaoxiaoflood firefox-scripts repository for more details.

Tip

If you are using Waterfox browser, you don't need to install the firefox-scripts as it is already included in the browser.

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:

• Download configuration files
• Download utils

Install config script

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

Note

Application Binary folder Is Firefox root directory (the folder that contains firefox.exe). for clarity, this text uses the terms Firefox root directory
Profile Folder is where Firefox stores your bookmarks, passwords and other user data. You can find more information about it in this article

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.

IMPORTANT

Windows

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

Linux

Note:
The default path to Firefox on Linux is typically /usr/lib/firefox/.

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

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

• copy config.js to /usr/lib/firefox/config.js
• copy config-prefs.js to /usr/lib/firefox/browser/defaults/preferences/config-prefs.js

Linux with Snap

Compatibility Note:
Firefox snap for Linux versions prior to 108 are not supported.

Instructions for Firefox snap 108 or newer

Verify installation path:
If you're uncertain about the installation path of your Firefox snap, use the command snap list firefox in your terminal to check.

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

• copy config.js to /etc/firefox/config.js
• copy config-prefs.js to /etc/firefox/defaults/pref/config-prefs.js

You may have to create the sub folders /defaults/pref

macOS

Note:
The default path to Firefox on macOS is typically Firefox.app/Contents/Resources.

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

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

• copy config.js to Firefox.app/Contents/Resources/config.js
• copy config-prefs.js to Firefox.app/Contents/Resources/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.

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….

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.

   Note

   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.

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.

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.

Danger

Don't remove the profile in Root Directory, it will remove the profile and all your data.

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.

Browser Compatibility

Tab Mix Plus is fully compatible with the following browsers:

• Firefox 115 ESR - Firefox Nightly
• Waterfox G6 and beyond
• Floorp 11.9.0+
• LibreWolf 122+

For Pale Moon download Tab Mix Plus from here