<!-- this is just an html file with extra steps --> <h1 align="center"> <img src="https://github.com/user-attachments/assets/bb23b9b4-0011-4ac8-acfe-3996006bb2de" alt="z(ap's) cool photon theme" title="who the hell is zap anyway"> </h1> <p align="center"> <img alt="cool" src="https://github.com/user-attachments/assets/7f67b471-e33a-4c2a-a9cb-94cbfd6ea5b2"> </p> <p align="center"> <a href="https://github.com/CosmoCreeper/Sine"><img src="https://github.com/user-attachments/assets/92a0aaf7-cc40-4f54-b061-27376b117c9b" alt="Available on Sine" title="Available for Fabr- I mean (the) Sine Mod Manager"></a> <br> <img alt="GitHub Release" src="https://img.shields.io/github/v/release/zapSNH/zapsCoolPhotonTheme?sort=semver&style=for-the-badge&color=%230A84FF"> <img alt="GitHub License" src="https://img.shields.io/github/license/zapSNH/zapsCoolPhotonTheme?style=for-the-badge"> <img alt="GitHub Issues" src="https://img.shields.io/github/issues/zapSNH/zapsCoolPhotonTheme?style=for-the-badge"> <br> A theme for modern Firefox-based browsers made to be <b>as faithful</b> to Firefox Photon as possible. <br> Designed based on later versions of Photon, specifically Firefox 87. </p> <p align="center"> Have an issue or want to share feedback? Feel free to <a href="https://github.com/zapSNH/zapsCoolPhotonTheme/issues/new/choose">open an issue</a> or <a href="https://github.com/zapSNH/zapsCoolPhotonTheme/discussions/new/choose">start a discussion</a>! <br> Contributions are greatly appreciated! </p> <h4 align="center"><a href="https://github.com/zapSNH/zapsCoolPhotonTheme/wiki/Showcase">&gt; (theme showcase) &lt;</a></h4>

---

<h4 align="center"> Compatibility </h4> <div align="center">

| | Windows | Linux (GNOME) | macOS | Notes | |-|:-:|:-:|:-:|:-:| | 115/128esr | ✔️ | ✔️ | ✔️ | No longer updated | | 140esr | ✔️ | ✔️ | ✔️ | | | 147 | ✔️ | ✔️ | ✔️ | | | 149 nightly | ✔️ | ✔️ | ? | |

Most Firefox-based forks that don't drastically modify the interface are supported.

See the Forks section for more information about Firefox forks.

</div>

Installation

There are four (4) ways of installing this theme.

• Manual Installation 🛠
• Sine Mod Manager🪐
• Extension 🧩
• Git :octocat:

---

Manual Installation 🛠

Classic userChrome installation for Firefox CSS themes.

• Installable on all editions of Firefox (and forks).
• Configuration is handled in about:config.
• No auto-updates; you'll have to manually update the theme.

Open about:config and set: | Pref | Value | Description | |:-:|:-:|:-:| | toolkit.legacyUserProfileCustomizations.stylesheets | true (boolean) | Enables userChrome customization. | | svg.context-properties.content.enabled | true (boolean) | Required for proper icon colors. | | browser.newtabpage.activity-stream.logowordmark.alwaysVisible | false (boolean) | Reverts the new tab Firefox logo behavior to what it was in Photon. | | browser.urlbar.scotchBonnet.enableOverride | false (boolean) | Disables the new dropdown-style searchmode picker. | | widget.windows.mica.popups | 0 (number) | (Windows only) Disables transparency effects on menus. |

<details> <summary>For Firefox 121 and below...</summary>

| Pref | Value | Description | |:-:|:-:|:-:| | layout.css.has-selector.enabled | true (boolean) | Only for Firefox 121 and below.<br>Required for some functionality to work. | | layout.css.nesting.enabled | true (boolean) | Only for Firefox 117 and below.<br>Required for theming and some other stuff to work. |

</details>

Optionally, you can set: | Pref | Value | Description | |:-:|:-:|:-:| | security.secure_connection_icon_color_gray | true (boolean) | Makes the connection icon gray instead of green.<br>Defaults to true in later versions of Photon. |

---

Too lazy to set all these prefs? You can visit https://zapsnh.github.io/zcpt-configurator/, enable Include preferences for theme installation (and maybe customize the theme a bit), and click Export Options to generate a user.js file that you can put in your profile folder.

Make sure to delete the user.js file after you start Firefox so that it doesn't override any changes you make in about:config.

---

Download the release for your browser version (for esr releases, download the files suffixed with -esr):

| 🪨 Static Release (stability) | 🛞 Rolling Release (features and bugfixes) | |-|-| | Firefox 147/140esr (recommended) | Firefox 147 | | Firefox 128esr | Firefox 140esr | | Firefox 115esr | Firefox Beta/Nightly |

<details> <summary>Older Versions</summary>

• Firefox 99
• Firefox 116 - 119
• Other Versions (Firefox 120 to previous release)

</details>

---

Extract the zip and move zapsCoolPhotonTheme-* (where * is main, 128esr, etc.) to your profile folder. You can find this by going to about:support and opening your profile folder/directory.

Rename the zapsCoolPhotonTheme-* folder to chrome

Your directory structure should look like this:

• Profiles > XXXXXXXX.profile_name_here > chrome > userChrome.css and others

and not like this:

• Profiles > XXXXXXXX.profile_name_here > chrome > zapsCoolPhotonTheme-* > userChrome.css and others

Restart Firefox.

You're done! 🎉

---

Sine Mod Manager 🪐

Uses the Sine Mod Manager to install the theme.

• Installable on all editions of Firefox (and forks).
• Has auto-updating (?) and a basic configurator.

Install the Sine theme manager for your browser. (follow this guide)

You can get this theme by searching for it (zap's cool photon theme) in Sine's marketplace and installing it.

If you want to specify a version of this theme to install, in the local installation text box, then type in this repo, and optionally the branch (e.g. zapSNH/zapsCoolPhotonTheme/tree/128esr for the version for FF 128), and install it there.

You're done! 🎉

---

Extension 🧩

Install the theme as an extension (like uBlock and the like).

• Only installable on Firefox Developer Edition, Firefox Nightly, and Firefox ESR (and forks based on these versions) since you need to disable extension signing (which is insecure).
• Has auto-updating and a built-in configurator.

This version is based on Paxmod.

Open about:config and set: | Pref | Value | Description | |:-:|:-:|:-:| | extensions.experiments.enabled | true (boolean) | Enables extensions experiments which allows CSS theming in extensions. | | xpinstall.signatures.required | false (boolean) | Disables extension signing which may be insecure. See this for the reason. |

All other preferences required to run the theme (see the table above) will be set automatically.

Download the release for your browser version: | Browser Version | Extension Version | |:-:|:-:| | 140+ | Latest Version | | 128 - 139 | v144.2.0 | | 115 - 127 | v0.24.5 |

More info at: https://github.com/zapSNH/zcpt-webextension/blob/main/README.md

You're done! 🎉

---

Git :octocat:

<!-- yes i know that the github != git shut hell up -->

Uses git . Recommended for people who know what they're doing.

• Installable on all editions of Firefox.
• Configuration is handled in about:config.
• There is no auto-updating (unless you make a script for that) but you can quickly update using git pull in your terminal.

Open about:config and set the same prefs in the Manual installation.

Download and install Git if you haven't already.

Open your profile folder which you can find by going to about:support and opening your profile folder/directory.

If you're using a file manager with a GUI (Explorer, Finder, etc.), open a terminal in the profile folder, usually by right clicking and clicking Open in Terminal (or similar). (example)

Copy (or type) this command into the terminal git clone https://github.com/zapSNH/zapsCoolPhotonTheme.git chrome and press enter. Make sure the terminal's directory is the profile folder (like Profiles > XXXXXXXX.profile_name_here) and not any of its subfolders.

If you're using a version of Firefox that isn't the latest stable version then copy (or type) these commands into the terminal.

cd chrome
git checkout BRANCH_NAME

where BRANCH_NAME is your Firefox version (i.e. 115esr or nightly). (don't use the ones prefixed by webextension)

You're done! 🎉

Forks 🍴

If you're using a Firefox fork (e.g. Waterfox, Floorp, etc.), you can se