A sleek, modern and elegant Firefox CSS theme
This repository has been archived on 2021-01-21. You can view files and clone it, but cannot push or open issues or pull requests.
Go to file
2021-01-21 13:51:13 +01:00
colors Merge branch 'master' of github.com:manilarome/blurredfox into master 2020-09-12 11:35:13 +02:00
parts Merge branch 'master' of github.com:manilarome/blurredfox into master 2020-09-12 11:35:13 +02:00
scrots add back in screenshot 2020-09-12 12:22:40 +02:00
.directory first commit 2020-05-20 13:34:10 +08:00
install.sh Merge branch 'master' of github.com:manilarome/blurredfox into master 2020-09-12 11:35:13 +02:00
LICENSE first commit 2020-05-20 13:34:10 +08:00
README.md Merge remote-tracking branch 'blurredfox/master' 2021-01-21 13:51:13 +01:00
user.js add user.js file 2020-08-15 15:41:05 +08:00
userChrome.css Modularized CSS and add Solid Color Scheme as alternative to transparent (#26) 2020-08-16 19:35:02 +08:00
userContent.css Minimal scrollbar + README.md update (#34) 2020-09-05 20:11:02 +08:00

Blurredfox Nord

A modern Firefox CSS Theme

Firefox with blurredfox
Firefox with blurredfox CSS theme

What changes compared to the original project?

The original blurredfox is developed and maintained by Gerome Matilla. The reason for the existence of this fork is for me to have basically the same thing, but with a customized color scheme. Turns out I am currently way too much into Nord, and I changed the default colors to Nord-friendly colors. I will try to stay up-to-date from time to time, but if you want something reliable, go take a look at the original project.


  • The latest Firefox
  • Compositor with blur support (optional)


  • 100% working on linux.
  • Untested on macOS.
  • Transparency is broken on Windows 10 (has graphical glitches like flickering). The solid color scheme may work.
  • No, the vertical titlebar is not included. Switch to Linux, then use AwesomeWM to achieve this gloriousness.

How to

Quick install for the linux lads

Notes before running the script:

  • If you have a multiple firefox builds, the script will still run without a problem. Just make sure to pass your target firefox build.
  • If you or your firefox build have a multiple profile, the script will return an error! Make sure you only have one!
  • It is advisible to check the script first before running it.
  • You need bash to run it.
  • If you have an existing chrome folder, the script will make a backup of it in your profile directory.
  • The script will move a file named user.js that contains all the preferences needed for blurredfox to work. The existing one will be backed up.
  • If the installation script is not working, feel free to submit an issue or a pull request.
  1. Run the script below. If you are using a different build like nightly, beta, etc., make sure to replace the 'stable' with the Firefox Build you are using. If leave empty, it will default to stable.

    # Available parameters:
    # stable - Firefox Stable Build
    # dev - Firefox Developer Edition
    # beta - Firefox Beta
    # nightly - Firefox Nightly
    # esr - Firefox Extended Support Release
    # Examples:
    # Stable build's profile
    $ curl -fsSL https://raw.githubusercontent.com/phundrak/blurredfox-nord/script/install.sh |
    bash -s -- stable
    # Nightly build's profile
    $ curl -fsSL https://raw.githubusercontent.com/phundrak/blurredfox-nord/script/install.sh |
    bash -s -- nightly
  2. After the confirmation message that the theme is successfully installed, open firefox. Change the colorscheme by Open Menu > Customize > Change colorscheme.

Manual Installation

  1. Open about:config page.

  2. A dialog will warn you, but ignore it, just do it press the I accept the risk! button.

  3. Search for these:

    • toolkit.legacyUserProfileCustomizations.stylesheets
    • layers.acceleration.force-enabled
    • gfx.webrender.all
    • gfx.webrender.enabled
    • layout.css.backdrop-filter.enabled
    • svg.context-properties.content.enabled

    Then make sure to enable them all!. Or you can just copy the user.js file to your profile.

  4. Go to your Firefox profile.

    • Linux - $HOME/.mozilla/firefox/XXXXXXX.default-XXXXXX/.
    • Windows 10 - C:\Users\<USERNAME>\AppData\Roaming\Mozilla\Firefox\Profiles\XXXXXXX.default-XXXXXX.
    • macOS - Users/<USERNAME>/Library/Application Support/Firefox/Profiles/XXXXXXX.default-XXXXXXX.
  5. Create a folder and name it chrome, then assuming that you already have cloned this repo, just copy its content to the chrome folder.

  6. Restart Firefox.

  7. Finally, you can now change whatever color mode you want in the Cusomization Window.

    • Default - Uses system colors, but uses the theme's layout.
    • Dark - Dark colorscheme. Good for the night.
    • Light - Bright colorscheme. Good for killing the eyes.

User Support

Some UIs are broken!

  1. Check if you're using the latest version of Firefox.
  2. It's broken because you're using Windows 10 and macOS or you're using an ancient version of Firefox.

If you're using Windows or macOS and something's wrong

  1. I only have Archlinux, macOS' untested while the theme is broken on Windows 10.
  2. If the transparency is broken, use the solid color scheme. Edit the userChrome.css to switch.

Liar! The theme's name is blurredfox, where is the blur?!

  1. Yeah, the name blurredfox is a lie, just like the cake. I named it blurredfox because it's designed to look gorgeous with a blur effect. You can, however, have the blur effect by:

    • Making sure you have a compositor and it supports blur.
    • If you're not using GNOME or KDE Plasma that has its own compositors, use picom. It includes the dual kawase blur shader.
    • GNOME's compositor, mutter, doesn't support blur. Hey, GNOME devs, it's already 2020. Just kidding!
    • If you're using KDE Plasma, read the next note below.

I'm using KDE Plasma, but there's no blur! How many other lies have I been told by the council?

  1. Enable the blur in your compositor. Go to System Settings > Desktop Effects > Enable Blur. Note that this will not enable the blur effect on all applications.
  2. Enable the blur effect on all applications by installing a KWin script called Force Blur. Make sure to read its manual. Don't you ever dare to create an issue about Force Blur! Just kidding! But yeah, I'm serious.
  3. Go to System Settings > KWin Scripts > Enable Force Blur.
  4. Change its settings. If there's no settings/settings icon, Logout. Re-login.

How can I set or change the colors for the Default color mode?

  1. The default mode are from Firefox and it uses the system colors. Although I only tried and tested it with GTK3, it should work with any platforms or environment as long as Firefox can detect your system colors.

How can I set or change the colors for the Default color mode?

  1. The default mode are from Firefox and it uses the system colors. Although I only tried and tested it with GTK3, it should work with any platforms or environment as long as Firefox can detect your system colors.

I hate the colors! Why is everything transparent?!

  1. Use the solid color scheme by editing the userChrome.css.
  2. You can change the colors yourself.
  3. The transparency is only applied to Dark and Light mode under the blurred color scheme. No transparency == No blur.
  4. You can read the next point.

Uninstall this now!

  1. Go to your profile directory.
  2. Delete the chrome folder.
  3. If you used the installation script or copied the user.js to your profile, delete it.
  4. Sayonara.

Got a problem?

If you have already read the README, free to open an issue here! But youll probably have more luck with the original project, link at the top of this README.

Got a patch?

You're absolutely welcome to submit a pull request here!


PR's are welcome! (Although Ill let it mostly up to the original author)

  • Render site content under the navbar like macOS
  • Fix UI inconsistencies
  • Better CSS