{"id":13474081,"url":"https://github.com/zapSNH/zapsCoolPhotonTheme","last_synced_at":"2025-03-26T20:31:52.079Z","repository":{"id":187124290,"uuid":"676352654","full_name":"zapSNH/zapsCoolPhotonTheme","owner":"zapSNH","description":"A faithful(ish) Firefox Photon theme.","archived":false,"fork":false,"pushed_at":"2024-10-29T22:57:41.000Z","size":3200,"stargazers_count":71,"open_issues_count":2,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-10-30T07:45:49.440Z","etag":null,"topics":["firefox","firefox-photon","firefox-theme","userchrome","usercontent"],"latest_commit_sha":null,"homepage":"","language":"CSS","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/zapSNH.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-08-09T02:38:11.000Z","updated_at":"2024-10-26T02:40:54.000Z","dependencies_parsed_at":"2023-10-24T09:31:48.191Z","dependency_job_id":"2ba955c0-0762-4fe9-9e66-9336e7d5585f","html_url":"https://github.com/zapSNH/zapsCoolPhotonTheme","commit_stats":null,"previous_names":["zapsnh/zapscoolphotontheme"],"tags_count":21,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapSNH%2FzapsCoolPhotonTheme","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapSNH%2FzapsCoolPhotonTheme/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapSNH%2FzapsCoolPhotonTheme/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/zapSNH%2FzapsCoolPhotonTheme/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/zapSNH","download_url":"https://codeload.github.com/zapSNH/zapsCoolPhotonTheme/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245731605,"owners_count":20663213,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["firefox","firefox-photon","firefox-theme","userchrome","usercontent"],"created_at":"2024-07-31T16:01:09.399Z","updated_at":"2025-03-26T20:31:52.073Z","avatar_url":"https://github.com/zapSNH.png","language":"CSS","funding_links":[],"categories":["CSS"],"sub_categories":[],"readme":"\u003ch1 align=\"center\"\u003e\n\t\u003cimg src=\"https://github.com/user-attachments/assets/56fb2e36-35cc-43e8-9ea1-ca804a75dc5e\" alt=\"oversized logowordmark\" title=\"oversized logowordmark\"\u003e\n\u003c/h1\u003e\n\u003cp align=\"center\"\u003e\n\tA Firefox userChrome theme designed to be as faithful to Firefox Photon (specifically Firefox 87) as possible.\n\u003c/p\u003e\n\n![okay](https://github.com/user-attachments/assets/7f67b471-e33a-4c2a-a9cb-94cbfd6ea5b2)\n\u003ch4 align=\"center\"\u003e\u003ca href=\"https://github.com/zapSNH/zapsCoolPhotonTheme/wiki/Showcase\"\u003e\u0026gt; (showcase) \u0026lt;\u003c/a\u003e\u003c/h4\u003e\n\n\u003chr\u003e\n\t\n\u003ch4 align=\"center\"\u003e\n\t Compatibility\n\u003c/h4\u003e\n\n\u003cdiv align=\"center\"\u003e\n\t\nIncludes forks of Firefox (Waterfox, Floorp, etc.).\n| | Windows | Linux (GNOME) | macOS | Notes |\n|-|:-:|:-:|:-:|:-:|\n| **115esr** | ✔️ | ✔️ | ✔️ | No longer updated |\n| **128esr** | ✔️ | ✔️ | ✔️ | |\n| **136** | ✔️ | ✔️ | ✔️ | |\n| **138 nightly** | ✔️ | ✔️ | ? | |\n\nSee the [Forks](#forks) section for more information about Firefox forks.\n\n\u003c/div\u003e\n\n\n## Installation\nThere are three (3) ways of installing this theme.\n* [Manual Installation 🛠](#manual-installation-)\n* [Extension 🧩](#extension-)\n* [Git :octocat:](#git-octocat)\n  \n____\n### Manual Installation 🛠\nInstallable on all editions of Firefox. Configuration is handled in `about:config`. There is no auto-updating.\n\nOpen `about:config` and set:\n| Pref | Value | Description |\n|:-:|:-:|:-:|\n| `toolkit.legacyUserProfileCustomizations.stylesheets` | `true` | Enables [userChrome](https://www.userchrome.org/) customization. |\n| `svg.context-properties.content.enabled` | `true` | Required for proper icon coloring. |\n| `browser.newtabpage.activity-stream.logowordmark.alwaysVisible` | `false` | Reverts the new tab Firefox logo behavior to what it was in Photon. |\n\u003cdetails\u003e\n\t\u003csummary\u003eFor Firefox 121 and below...\u003c/summary\u003e\n\t\n| Pref | Value | Description |\n|:-:|:-:|:-:|\n| `layout.css.has-selector.enabled` | `true` | **Only for Firefox 121 and below.**\u003cbr\u003eRequired for some functionality to work. |\n| `layout.css.nesting.enabled` | `true` | **Only for Firefox 117 and below.**\u003cbr\u003eRequired for theming and some other stuff to work. |\n\u003c/details\u003e\n\nOptionally, you can set:\n| Pref | Value | Description |\n|:-:|:-:|:-:|\n| `security.secure_connection_icon_color_gray` | `true` | Makes the connection icon gray instead of green.\u003cbr\u003eDefaults to `true` in later versions of Photon. |\n____\nToo 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.\n\n**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`.**\n____\n\nDownload the release for your browser version:\n\n| __🪨 Static Release (stability)__ | __🛞 Rolling Release (features and bugfixes)__ |\n|-|-|\n| [Firefox 136](https://github.com/zapSNH/zapsCoolPhotonTheme/releases/tag/v136) **(recommended)**             | [Firefox 136](https://github.com/zapSNH/zapsCoolPhotonTheme/archive/refs/heads/main.zip)             |\n| [Firefox 128esr](https://github.com/zapSNH/zapsCoolPhotonTheme/releases/tag/v136) (download the ESR version) | [Firefox 128esr](https://github.com/zapSNH/zapsCoolPhotonTheme/archive/refs/heads/128esr.zip)        |\n| [Firefox 115esr](https://github.com/zapSNH/zapsCoolPhotonTheme/releases/tag/v128) (download the ESR version) | [Firefox Beta/Nightly](https://github.com/zapSNH/zapsCoolPhotonTheme/archive/refs/heads/nightly.zip) |\n\n\u003cdetails\u003e\n\t\u003csummary\u003eOlder Versions\u003c/summary\u003e\n\n* [Firefox 99](https://github.com/zapSNH/zapsCoolPhotonTheme/archive/refs/heads/archive-v99.zip)\n* [Firefox 116 - 119](https://github.com/zapSNH/zapsCoolPhotonTheme/archive/refs/heads/119.zip)\n* [Other Versions (Firefox 120+)](https://github.com/zapSNH/zapsCoolPhotonTheme/releases)\n\u003c/details\u003e\n\n____\n\nExtract the zip and move `zapsCoolPhotonTheme-*` (where `*` is `main`, `128esr`, etc.) to your profile folder which you can find by going to `about:support` and opening your profile folder/directory.\n\nRename the `zapsCoolPhotonTheme-*` folder to `chrome`\n\nMake sure the directory is like this:\n* `Profiles` \u003e `XXXXXXXX.profile_name_here` \u003e `chrome` \u003e `userChrome.css` and others\n\nand **not** like this:\n* `Profiles` \u003e `XXXXXXXX.profile_name_here` \u003e `chrome` \u003e `zapsCoolPhotonTheme-*` \u003e `userChrome.css` and others\n\nRestart Firefox.\n\nYou're done! 🎉\n\n____\n\n### Extension 🧩\nOnly installable on Firefox Developer Edition, Firefox Nightly, and Firefox ESR (and forks based on these versions) since **you need to disable extension signing** (which may be insecure).\n\nHas auto-updating and a built-in configurator.\nThis version is based on [Paxmod](https://github.com/numirias/paxmod).\n\nOpen `about:config` and set:\n| Pref | Value | Description |\n|:-:|:-:|:-:|\n| `extensions.experiments.enabled`  | `true` | Enables extensions experiments which allows CSS theming in extensions. |\n| `xpinstall.signatures.required` | `false` | Disables extension signing which may be insecure. See [this](https://github.com/numirias/paxmod#why-cant-i-install-paxmod-as-a-verified-extension-through-mozilla) for the reason.  |\n  \nAll other preferences required to run the theme (see [the table above](#manual-installation-)) will be set automatically.\n\nDownload the release for your browser version:\n| Browser Version | Extension Version |\n|:-:|:-:|\n| 128+ | [Latest Version](https://github.com/zapSNH/zcpt-webextension/releases/latest) |\n| 115 - 127 | [v0.24.5](https://github.com/zapSNH/zcpt-webextension/releases/tag/v0.24.5) |\n\nMore info at: https://github.com/zapSNH/zcpt-webextension/blob/main/README.md\n\nYou're done! 🎉\n\n____\n\n### Git :octocat: \n\u003c!-- yes i know that the github != git just shut up --\u003e\nRecommended for people who know what they're doing.\n\nInstallable 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.\n\nOpen `about:config` and set the same prefs in the [Manual](#manually-) installation.\n\nDownload and install [Git](https://git-scm.com/) if you haven't already.\n\nOpen your profile folder which you can find by going to `about:support` and opening your profile folder/directory.\n\nIf you're in 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)](https://github.com/zapSNH/zapsCoolPhotonTheme/assets/134786889/c35ffc7d-0343-479a-9366-72d56833c4c3)\n\nCopy (or type) this command into the terminal `git clone https://github.com/zapSNH/zapsCoolPhotonTheme.git chrome` and press enter. **Make sure the terminal is in the profile folder (like `Profiles` \u003e `XXXXXXXX.profile_name_here`) and not in any of its subfolders.**\n\nIf you're using a version of Firefox that isn't the latest stable version then copy (or type) these commands into the terminal.\n```\ncd chrome\ngit checkout BRANCH_NAME\n```\nwhere `BRANCH_NAME` is [your Firefox version (i.e. `115esr` or `nightly`)](https://github.com/zapSNH/zapsCoolPhotonTheme/branches). (don't use the ones prefixed by `webextension`)\n\nYou're done! 🎉\n\n# Forks 🍴\nIf you're using a Firefox fork (e.g. Waterfox, Floorp, etc.), you can set these prefs in `about:config` for theme fixes and adjustments for your browser.\n| Pref | Value | Browser |\n|:-:|:-:|:-:|\n| `uc.waterfox` | `true` | Waterfox |\n| `uc.floorp` | `true` | Floorp |\n| `uc.librewolf` | `true` | LibreWolf |\n| `uc.tor` | `true` | Tor Browser |\n\n# Configuration\nConfig options are available at the [Wiki](https://github.com/zapSNH/zapsCoolPhotonTheme/wiki/Config-Options).\n\nAn interactive configurator is available at https://zapsnh.github.io/zcpt-configurator/. To apply the settings, place the exported `user.js` file in your profile folder/directory (`Profiles` \u003e `XXXXXXXX.profile`), launch Firefox, and then delete the `user.js` file afterwards.\n\nFor the WebExtension version, the configurator can be found in the extension's option page (`about:addons` \u003e zap's cool photon theme \u003e Preferences/Options). The settings will apply after you click `Apply` (unless you're 𝓯𝓻𝓮𝓪𝓴𝔂).\n\n## Miscellaneous\nFirefox Photon icons are primarily taken from Firefox 87 or Firefox 78esr.\nOther/newer icons not present in Firefox 87/78esr are primarily based on their Proton/Acorn counterparts.\n\nSpecial thanks to:\n- [black7375's Lepton](https://github.com/black7375/Firefox-UI-Fix)\n- [YukisCoffee's Phroton](https://web.archive.org/web/20231124205435/https://github.com/YukisCoffee/phroton/) (r.i.p.)\n- The folks over at r/FirefoxCSS\n- [Mozilla](https://www.mozilla.org/) since they made Firefox so customizable [and made Photon (but they also made Proton \u003e:()]\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FzapSNH%2FzapsCoolPhotonTheme","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FzapSNH%2FzapsCoolPhotonTheme","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FzapSNH%2FzapsCoolPhotonTheme/lists"}