Firefox Safari theme

A Safari theme for Firefox 120+

Description

This is a bunch of CSS code to make Firefox look closer to MacOSX Tahoe Safari theme. Based on https://github.com/rafaelmardojai/firefox-gnome-theme

Installation

Quick Install

Run the installer script:

./install.sh -f

This will automatically install the default theme to all detected Firefox-based browsers (Firefox, Librewolf, Floorp).

Theme Variants

The theme supports multiple variants:

• Default: Standard Safari theme

  ./install.sh -f

• Adaptive: Adaptive color version (requires Adaptive Tab Bar Colour addon)

  ./install.sh -f adaptive

• Darker: Darker variant

  ./install.sh -f darker

• Nord: Nord color scheme

  ./install.sh -f nord

Other Options

• Edit mode: Show Firefox profile locations for manual editing

  ./install.sh -e

• Remove theme: Uninstall the theme

  ./install.sh -r

• Help: Show all available options

  ./install.sh -h

Supported Browsers

The installer automatically detects and installs the theme for:

• Firefox (regular, Flatpak, Snap)
• Librewolf (regular, Flatpak)
• Floorp (regular, Flatpak)

Post-Installation

After installation:

1. Restart Firefox to apply the theme
2. Customize your Firefox UI (recommended):
   • Go to Firefox menu > Customize
   • Enable Title bar option for CSD (Client-Side Decorations)
   • Move the New Tab button to the titlebar area

Note: Custom CSS (toolkit.legacyUserProfileCustomizations.stylesheets) is automatically enabled by the installer. You don't need to manually configure about:config.

Manual installation

If you prefer to install manually without using the script:

1. Go to about:support in Firefox.
2. Application Basics > Profile Directory > Open Directory.
3. Copy chrome folder to Firefox config folder.
4. Copy the appropriate CSS files:
   • userChrome.css (or variant: userChrome-adaptive.css, userChrome-darker.css, userChrome-nord.css)
   • userContent.css (or corresponding variant)
5. Enable custom CSS:
   1. Go to about:config in Firefox.
   2. Search for toolkit.legacyUserProfileCustomizations.stylesheets and set it to true.
6. Restart Firefox.
7. Open Firefox customization panel and:
   1. Use Title bar option to toggle CSD if is not set by default.
   2. Move the new tab button to headerbar.

Enabling optional features

Open userChrome.css with a text editor and follow instructions to enable extra features. Keep in mind this file might change in future versions and your configuration will be lost. You can copy the @imports you want to enable to a new file named customChrome directly in your chrome directory if you want it to survive updates. Remember all @imports must be at the top of the file, before other statements.

Known bugs

CSD have sharp corners

See upstream bug.

Wayland fix:

1. Go to the about:config page
2. Search for the layers.acceleration.force-enabled preference and set it to true.
3. Now restart Firefox, and it should look good!

X11 fix:

1. Go to the about:config page
2. Type mozilla.widget.use-argb-visuals
3. Set it as a boolean and click on the add button
4. Now restart Firefox, and it should look good!

Development

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.