🍎 macOS

To install Phoenix on macOS, simply run the following command in your terminal:

bash -c "$(wget -O- https://gitlab.com/celenityy/Phoenix/-/raw/pages/installer_scripts/macos_install.sh 2>/dev/null)"

🔥Extended

After installing Phoenix, you can install Phoenix Extended on macOS with the following steps:

1. Find your Firefox profile's directory. This will vary, but an easy way to find it is by navigating to about:profiles, and it'll be the path listed beside Root Directory. For example's sake, we'll say our profile's directory is /Users/user/Library/Application Support/Firefox/Profiles/nqy3uu0l.default-release. Yours will be different, and you should replace this path on the next step with your actual profile directory's path.

1. Download phoenix.cfg from here. You can right click and select Save page as from your browser, or you can run the following command in the Windows Terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/configs/phoenix.cfg

2. Download phoenix.js from here. You can right click and select Save page as from your browser, or you can run the following command in the Windows Terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/windows/phoenix.js

3. Download policies.json from here. You can right click and select Save page as from your browser, or you can run the following command in the Windows Terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/policies.json

4. Locate your Firefox installation directory. For most Windows users, your installation directory should be located at C:\Program Files\Mozilla Firefox, but that might not always be the case. An easy way to find it is by navigating to about:support in Firefox & checking the directory next to Application Binary. For example, I see C:\Program Files\Mozilla Firefox/firefox.exe next to Application Binary, so this confirms that my installation directory is indeed C:\Program Files\Mozilla Firefox.

5. Move phoenix.cfg to the root of your installation directory. You can either drag and drop it manually, or run the following command, assuming C:\Program Files\Mozilla Firefox is your installation directory:

cp phoenix.cfg C:\'Program Files'\'Mozilla Firefox'\phoenix.cfg

6. If it does not already exist, in the root of your installation directory, create a directory named defaults, and inside this new defaults directory, create another directory titled pref. You can do this manually through your file explorer, or assuming C:\Program Files\Mozilla Firefox is your installation directory, you could run the following command:

mkdir -p C:\'Program Files'\'Mozilla Firefox'\defaults\pref

7. Move phoenix.js to the pref folder that you just created. Assuming your installation directory is C:\Program Files\Mozilla Firefox, you can run the following command:

cp phoenix-desktop.js C:\'Program Files'\'Mozilla Firefox'\defaults\pref\phoenix.js

8. If it does not already exist, in the root of your installation directory, create a distribution directory. You can do this manually through your file explorer, or assuming C:\Program Files\Mozilla Firefox is your installation directory, you can run the following command:

mkdir -p C:\'Program Files'\'Mozilla Firefox'\distribution

9. Finally, move policies.json to the distribution directory that you just created. Assuming your installation directory is C:\Program Files\Mozilla Firefox, you can run the following command:

cp policies.json C:\'Program Files'\'Mozilla Firefox'\distribution\policies.json

Congratulations, you're done. Enjoy Phoenix, and be sure to keep up with updates!

Extended/Specialized Configs

If you would like to use Phoenix Extended, or one of our specialized configs, you'll need to follow these steps.

1. Download the .cfg file of your choice from here. For this example, we'll use youtube.cfg. Simply replace mentions of youtube.cfg below with the configuration you would like to use. For Phoenix Extended, use hardened.cfg.

You can right click and select Save page as from your browser on the .cfg file, or you can run the following command in the Windows Terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/configs/youtube.cfg

2. Store the .cfg file you just downloaded somewhere safe that you can remember. For this example, we'll keep it simple and say I chose to save youtube.cfg at ~/youtube.cfg. Replace mentions of ~/youtube.cfg below with the actual location of your file.

You can either drag and drop the file manually, or run the command below:

cp youtube.cfg ~/youtube.cfg

3. Download the user.js file located here.

You can right click and select Save page as from your browser on the user.js file, or you can run the following command in your terminal:

wget https://gitlab.com/celenityy/Phoenix/-/raw/pages/user.js

4. Edit the user.js file you just downloaded, and replace file://put_your_cfg_file_location_here with the location of your .cfg file from Step 2.

Assuming our file is still located at ~/youtube.cfg and our username is user, we'll change the contents of the user.js file we downloaded to:

user_pref("autoadmin.global_config_url", "file:///C:\Users\User\youtube.cfg");

5. Find your Firefox profile's directory. This will vary, but an easy way to find it is by navigating to about:profiles, and it'll be the path listed beside Root Directory. For example's sake, we'll say our profile's directory is C:\Users\User\AppData\Roaming\Mozilla\Firefox\Profiles\bar3gctf.default-release. Yours will be different, and you should replace this path on the next step with your actual profile directory's path.

6: Simply copy & paste your user.js file to your profile's directory! You can either drag and drop it manually, or run the command below. For example's sake, we'll say our user.js is located at ~/Downloads/user.js. If this is not the path of your downloaded user.js file from Step 3, replace it with its actual location.

cp ~/Downloads/user.js C:\Users\User\AppData\Roaming\Mozilla\Firefox\Profiles\bar3gctf.default-release/user.js

Phoenix - A suite of configurations & advanced modifications for Mozilla Firefox, designed to put the user first.