https://github.com/akkva/gwfox

Bringing a refreshing macOS-inspired skin to Firefox
https://github.com/akkva/gwfox

firefox-theme

Last synced: 3 months ago
JSON representation

Bringing a refreshing macOS-inspired skin to Firefox

• Host: GitHub
• URL: https://github.com/akkva/gwfox
• Owner: akkva
• License: mpl-2.0
• Created: 2024-04-02T09:22:12.000Z (about 2 years ago)
• Default Branch: main
• Last Pushed: 2026-03-31T14:48:36.000Z (3 months ago)
• Last Synced: 2026-03-31T15:11:18.113Z (3 months ago)
• Topics: firefox-theme
• Language: CSS
• Homepage:
• Size: 516 KB
• Stars: 819
• Watchers: 6
• Forks: 33
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          














## 🛠️ Installation

1. Move the theme files into `[your-profile]/chrome/`.

2. Configure `about:config` with these preferences:

| Preference | Value | Platform / Notes |

| :--- | :--- | :--- |

| `toolkit.legacyUserProfileCustomizations.stylesheets` | **true** | **Required** |

| `svg.context-properties.content.enabled` | **true** | **Required** |

| `sidebar.animation.enabled` | **false** | **Required** |

| `widget.windows.mica` | **true** | **Windows**¹ |

| `widget.windows.mica.toplevel-backdrop` | **2** | **Windows** |

| `widget.gtk.rounded-bottom-corners.enabled` | **true** | **Linux** |

| `widget.macos.native-context-menus` | **false** | **macOS** |

> ¹ **Windows**: Requires enabling **"System theme — auto"** in Firefox Add-ons manager.

3. Restart Firefox to apply changes.

---

## 🎨 Customization

Create these preferences in `about:config` to modify the UI:

### **Boolean Toggle**

| Preference | Description | Notes |

| :--- | :--- | :--- |

| `gwfox.plus` | **Enable bundled layout** | macOS UI + Compact mode |

| `gwfox.plus_sc` | **Use native window controls** | Sub-option for `gwfox.plus` |

| `gwfox.icons` | **Enable menu icons** | |

| `gwfox.bms` | **Enable transparency** | **Linux** only |

| `gwfox.noborder` | **Remove window borders** | Borderless window mode |

| `gwfox.atbc` | **Enable ATBC compatibility** | For *Adaptive Tab Bar Colour* |

| `gwfox.blur` | **Enable UI blur effects** | ⚠️ Incompatible with **v150+** |

| `gwfox.ac` | **Enable accent color** | Edit `--bg0` in CSS to customize |

| `gwfox.tp` | **Enable New Tab transparency** | Requires `allow_transparent_browser` |

| `gwfox.db` | **Disable menu blur** | Turn off blur on panels/menus |

### **Numerical Settings**

| Preference | Description | Values |

| :--- | :--- | :--- |

| `gwfox.sidebar` | **Set sidebar width** | `1`, `2`, or `3` |