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.
blurredfox-nord/README.md

90 lines
3.1 KiB
Markdown

# Blurred fox
### A modern Firefox CSS Theme
| Default Color Scheme |
| --- |
| ![screenshot](scrot/default.webp) |
| Dark Color Scheme |
| --- |
| ![screenshot](scrot/dark.webp) |
| Light Color Scheme |
| --- |
| ![screenshot](scrot/light.webp) |
## Requirements
+ Latest stable Firefox
+ Compositor with blur shader (optional)
+ Linux machine - untested on macOS and Windows10
## How to
### Quick install for the linux lads
1. Run:
```bash
$ bash -c "$(curl -fsSL https://raw.githubusercontent.com/manilarome/blurredfox/master/install.sh)"
```
2. After the confirmation message that the theme is successfully installed, open firefox. Change colorscheme by **`Open Menu > Customize > Change Colorscheme`**.
#### Installation notes:
+ It is advisible to check the script first before running it.
+ You need `bash` to run it.
+ The script will fail if you have multiple profile directory! Make sure you only have one!
+ If you have a current chrome folder in your profile directory, the script will make a backup.
+ If the installation script is not working, a PR is welcome!
### 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!**
4. Go to your Firefox profile. Linux distributions has it in `$HOME/.mozilla/firefox/XXXXXXX.default-XXXXXX/`.
5. Create a folder and name it **`chrome`**, then assuming that you already have cloned this repo, just copy the theme to `chrome` folder.
6. Finally, you can now change whatever colorscheme you want in the Cusomization Window.
## Note
### If you're using Windows or macOS and something's wrong
1. **I only have Archlinux, so I cannot guarantee that it will work on Windows10 and macOS without a problem. A feedback and PR is absolutely welcome!**
### If there's no blur effect
1. **The theme does not provide the blur effect!** Make sure you have a compositor with blur support running! KDE Plasma, macOS, and Windows 10 have this by default, but you need to enable it! If you're using linux, use tryone144's [feature/dual_kawase](https://github.com/tryone144/picom/tree/feature/dual_kawase) branch of picom. It includes the dual kawase shader.
### If you're using Plasma and there's no blur effect,
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/).
3. Go to `System Settings > KWin Scripts > Enable Force Blur`.
### Scrollbar is missing
1. The scrollbar is hidden by default, you can enable/show it by changing the value of `scrollbar-width` in `userContent.css`.
## TODO
PR's are welcome!
- [ ] Hide `TabsToolbar` if tab bar is hidden
- [ ] Fix inconsistencies
- [ ] Better CSS