203 lines
7.8 KiB
Markdown
203 lines
7.8 KiB
Markdown
## Blurredfox Nord
|
||
|
||
### A modern Firefox CSS Theme
|
||
|
||
<p align="center"><img alt="Firefox with blurredfox" src="scrots/blurred.png"/><br/><i>Firefox with blurredfox CSS theme</i></p>
|
||
|
||
## What changes compared to the original project?
|
||
The original [blurredfox](https://github.com/manilarome/blurredfox/pulls) is
|
||
developed and maintained by [Gerome
|
||
Matilla](https://github.com/manilarome/blurredfox/pulls). 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.
|
||
|
||
## Requirements
|
||
|
||
+ The latest Firefox
|
||
+ Compositor with blur support (optional)
|
||
|
||
## Notes
|
||
|
||
+ 100% working on linux.
|
||
+ Untested on macOS.
|
||
+ Transparency is broken on Windows 10 (has graphical glitches like flickering).
|
||
The [solid color
|
||
scheme](https://github.com/manilarome/blurredfox/blob/master/colors/solid.css)
|
||
*may* work.
|
||
|
||
## 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.
|
||
+ If the installation script is not working, feel free to submit an issue or a
|
||
pull request.
|
||
+ The script will move a file named `user.js` that contains all the preferences
|
||
needed for blurredfox to work. If you have a current one, make sure to create
|
||
a backup.
|
||
|
||
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/manilarome/blurredfox/script/install.sh |
|
||
bash -s -- stable
|
||
|
||
# Nightly build's profile
|
||
$ curl -fsSL https://raw.githubusercontent.com/manilarome/blurredfox/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
|
||
old 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](https://github.com/manilarome/blurredfox/blob/master/colors/solid.css).
|
||
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
|
||
tryone144's
|
||
[feature/dual_kawase](https://github.com/tryone144/picom/tree/feature/dual_kawase)
|
||
branch of picom, or ibaghwan’s [next](https://github.com/ibhagwan/picom)
|
||
branch. They both include the dual kawase shader, and the latter adds
|
||
rounded corners to windows.
|
||
+ 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](https://store.kde.org/p/1294604/). 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.
|
||
|
||
### Where is the scrollbar?
|
||
|
||
1. You can adjust the value of `scrollbar-width` in `userContent.css`.
|
||
2. Restart Firefox.
|
||
|
||
### 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](https://github.com/manilarome/blurredfox/blob/master/colors/solid.css)
|
||
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](https://github.com/phundrak/blurredfox/issues)! But you’ll 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](https://github.com/manilarome/phundrak/pulls)!
|
||
|
||
## TODO
|
||
|
||
PR's are welcome! (Although I’ll let it mostly up to the original author)
|
||
|
||
- [ ] Render site content under the navbar like macOS
|
||
- [ ] Fix UI inconsistencies
|
||
- [ ] Better CSS
|