A GNOME theme for Firefox
This theme follows lastest GNOME Adwaita style.
This is a bunch of CSS code to make Firefox look closer to GNOME's native apps.
Matrix room: #firefox-gnome-theme:matrix.org
The master
branch of this repo supports the current Firefox stable release 100
.
Theme versions complatible with older Firefox releases are preserved as git tags. Use the v78.1
tag for Firefox 78 ESR support.
We also have the beta
branch for fixes only aplicable to the current Firefox beta version.
-
Clone this repo and enter folder:
git clone https://github.com/rafaelmardojai/firefox-gnome-theme && cd firefox-gnome-theme
-
Checkout a git branch or tag if needed, otherwise use
master
and ignore this step.git checkout beta # Set beta branch git checkout v78.1 # Set v78.1 tag
-
Run installation script
This script will lookup Firefox profiles location and enable a theme variant for your GTK theme if it exists.
./scripts/auto-install.sh
./scripts/install.sh # Standard ./scripts/install.sh -f ~/.var/app/org.mozilla.firefox/.mozilla/firefox # Flatpak
-
-f <firefox_folder_path>
optional- Set custom Firefox folder path, for example
~/.mozilla/icecat/
. - Default:
~/.mozilla/firefox/
- Set custom Firefox folder path, for example
-
-p <profile_name>
optional- Set custom profile name, for example
e0j6yb0p.default-nightly
. - Default: All the profiles found in the firefox folder
- Set custom profile name, for example
-
-t <theme_name>
optional- Set the colors used in the theme.
- Default: Adwaita.
- Options:
adwaita
,maia
,yaru
.
-
You can also install this theme with one command:
curl -s -o- https://raw.githubusercontent.com/rafaelmardojai/firefox-gnome-theme/master/scripts/install-by-curl.sh | bash
It will download the latest version of the theme and run the auto installation script for you.
-
Go to
about:support
in Firefox. -
Application Basics > Profile Directory > Open Directory.
-
Open directory in a terminal.
-
Create a
chrome
directory if it doesn't exist:mkdir -p chrome cd chrome
-
Clone this repo to a subdirectory:
git clone https://github.com/rafaelmardojai/firefox-gnome-theme.git
-
Create single-line user CSS files if non-existent or empty (at least one line is needed for
sed
):[[ -s userChrome.css ]] || echo >> userChrome.css
-
Import this theme at the beginning of the CSS files (all
@import
s must come before any existing@namespace
declarations):sed -i '1s/^/@import "firefox-gnome-theme\/userChrome.css";\n/' userChrome.css
-
Symlink preferences file:
cd .. # Go back to the profile directory ln -fs chrome/firefox-gnome-theme/configuration/user.js user.js
-
Restart Firefox.
-
Open Firefox customization panel and move the new tab button to headerbar.
-
Be happy with your new gnomish Firefox.
We provide a user.js configuration file in configuration/user.js
that enable some preferences required by this theme to work.
You should already have this file installed if you followed one of the installation methods, but in any case be sure this preferences are enabled under about:config
:
-
toolkit.legacyUserProfileCustomizations.stylesheets
This preference is required to load the custom CSS in Firefox, otherwise the theme wouldn't work.
-
svg.context-properties.content.enabled
This preference is required to recolor the icons, otherwise you will get black icons everywhere.
For other non essential preferences checkout
configuration/user.js
.
Also though is not obligatory, some weird issues might happen if you don't use the Firefox's default/system theme because the theme is never tested against the Firefox's light or dark theme.
You can follow the installation script steps again to update the theme.
- Go to your profile folder. (Go to
about:support
in Firefox > Application Basics > Profile Directory > Open Directory) - Remove
chrome
folder.
Optional features can be enabled by creating new boolean
preferences in about:config
.
- Go to the
about:config
page - Type the key of the feature you want to enable
- Set it as a
boolean
and click on the add button - Restart Firefox
-
Hide single tab
gnomeTheme.hideSingleTab
Hide the tab bar when only one tab is open.
Note: You should move the new tab button somewhere else for this to work, because by default it is on the tab bar too. See #54.
-
Normal width tabs
gnomeTheme.normalWidthTabs
Use normal width tabs as default Firefox.
-
Bookmarks toolbar under tabs
gnomeTheme.bookmarksToolbarUnderTabs
Move Bookmarks toolbar under tabs.
-
Active tab contrast
gnomeTheme.activeTabContrast
Add more contrast to the active tab.
-
System icons
gnomeTheme.systemIcons
Use system theme icons instead of Adwaita icons included by theme.
Note: This feature has a known color bug.
-
Symbolic tab icons
gnomeTheme.symbolicTabIcons
Make all tab icons look kinda like symbolic icons.
-
Hide WebRTC indicator
gnomeTheme.hideWebrtcIndicator
Hide redundant WebRTC indicator since GNOME provides their own privacy icons in the top right.
-
Drag window from headerbar buttons
gnomeTheme.dragWindowHeaderbarButtons
Allow draging the window from headerbar buttons.
Note: This feature is BUGGED. It can activate the button with unpleasant behavior.
See upstream bug.
- Go to the
about:config
page - Search for the
layers.acceleration.force-enabled
preference and set it to true. - Now restart Firefox, and it should look good!
- Go to the
about:config
page - Type
mozilla.widget.use-argb-visuals
- Set it as a
boolean
and click on the add button - Now restart Firefox, and it should look good!
Icons might appear black where they should be white on some systems. I have no idea why, but you can adjust them directly in the system-icons.css
file, look for --gnome-icons-hack-filter
& --gnome-window-icons-hack-filter
vars and play with css filters.
If you wanna mess around the styles and change something, you might find these things useful.
To use the Inspector to debug the UI, open the developer tools (F12) on any page, go to options, check both of those:
- Enable browser chrome and add-on debugging toolboxes
- Enable remote debugging
Now you can close those tools and press Ctrl+Alt+Shift+I to Inspect the browser UI.
Also you can inspect any GTK3 application, for example type this into a terminal and it will run Epiphany with the GTK Inspector, so you can check the CSS styles of its elements too.
GTK_DEBUG=interactive epiphany
Feel free to use any parts of my code to develop your own themes, I don't force any specific license on your code.
Developed by Rafael Mardojai CM and contributors. Based on Luna Kurame's original work.
If you want to support development, consider donating via PayPal. Also consider donating upstream, Firefox & GNOME.