black7375 /Firefox-UI-Fix
🦊 I respect proton UI and aim to improve it.
★ 5,925⑂ 203👁 54⑃ 125● 950▤ 77
+1
日增长
5,925
stars
203
forks
54
watchers
125
prs
950
issues
77
releases
README
Lepton (old name: Proton Fix)
Table of Contents
- Lepton (old name: Proton Fix)
- Introduction
- Installation Guide
- WHY Proton?
- WHY Not Proton?
- Padding Comparisons
- Sponsors & Contributors
- Bug / Questions?
- FAQ
---
🔔🔔 Does the theme not work after installation?
You should copy user.js file before the theme works.
The option system depends on user configuration, and nothing applies without settings. \
Also, real-time changes are difficult because of technical limitations and require a restart.
Some settings can be conflicted and should be explicitly set to false.
---
🔔🔔 Is your Firefox version v102 or lower?
You have to set userChrome.compatibility.accent_color to true additionally.
---
Introduction
Proton is Firefox's new design, starting from Firefox 89. \
Photon is the old design of Firefox which was used until version 88.
Proton's overall feel is good, but there were a few things I didn't like and wanted to improve. \
That's why this project was born, and Lepton to denote light theme layer.
Disclaimer: It works on Firefox 89 and above!!
| Wiki | | | | | | |
| --- | --- | --- | --- | --- | --- | --- |
| Installation Guide | Screenshots | Tutorial | Options | Compatibility Issues Solution | Tips | Show Off Your Config |
!Lepton's design
(Lepton's design :arrow_up:)
Feature List (Click)
- Color
- Default light/dark theme contrast enhancement
- Colorful context menu
- More dark mode support
- Windows/Mac/Linux system theme support
- Windows 7 compatibility
- Icons
- Panel
- Context Menu
- Global Menu
- Library's open context
- Video Player
- Padding Narrower
- Tab
- Panel
- Menu
- Density
- Others…
- Tab Bar Layouts
- Tabs on Bottom
- One Liner
- Vertical Tab Support
- Tab Design
- General:
- Connect with toolbar (buttons like tabs)
- Selected:
- Box Shadow: Highlight the selected tab
- Bottom Rounding: Natural
- MultiSelected
- Adjust Color: Easily recognizable
- Unselect:
- Divide Line: React to hover like chrome
- Unloaded:
- Dimmed: Looks like inactive
- Clipped:
- Clearer Text: Adjusted clipped gradation
- Closed Button: Visible on hover
- Sound:
- Remove Second Label
- Show Favicon: Always show favicon
- PIP Icon
- Container Tab:
- Highlight line position: Displayed under tab
- Button Design
- New tab: Looks like tab
- Activity Stream Design
- Search Bar:
- Focused Shadow: Same as the accent color
- Hand off to Awesomebar
- Icons:
- Size: Fill (Changes dynamically to your size)
- Error Page Design
- Illustrations: Restore error page illustrations
- Video Player
- Background Style
- Size at fullscreen
- Fullscreen
- Overlap mode
- Others
- Animations
- Hidden & Auto Hide
- Activate calculator at address bar
- Mouse pointer for each context
Installation Guide
Installation script (experimental)
Linux/Mac users:
bash
bash -c "$(curl -fsSL https://raw.githubuseTop issues
#1075After upgrading to 136 stable, the audio playing icon has changed behavior and the tab expands/shrinks when it appears/disappears43 comments · 2025-03-05#551Feature request: Option to use moving text instead of three dots27 comments · 2022-12-28#1191The active tab is not highlighted20 comments · 2026-08-19#1169Release 151+ cause the theme to break in some areas.18 comments · 2026-04-26#457Add option for menubar overlay17 comments · 2022-08-24#1174Tab preview thumbnail is now transparent, making it difficult to read the preview text12 comments · 2026-05-23#1003Mute Tab button too big on Pinned Tabs12 comments · 2024-10-09#500Support Paxmod12 comments · 2022-11-02
Discussions
#1207Change the background color of the active tab1 comments · 2026-10-15#1195Which are the correct versions for what?0 comments · 2026-09-05#1189Lepton alternatives?2 comments · 2026-08-17#1164Firefox Nova interface was announced - Mozilla plans to end Proton3 comments · 2026-03-14#1161Way to Change Tab / URL bar color?0 comments · 2026-02-24#1157How to enable selected tab highlight in vertical tabs mode.0 comments · 2026-01-17#1149Need Help with the Tab Separator lines in firefox 1460 comments · 2025-12-13#1124Firefox CSS property list-style-image to change to --menuitem-icon in latest nightly builds0 comments · 2025-08-02
Latest release
v8.7.6 v8.7.6 2026-09-06Changed
Improved compatibility with the latest Firefox features, including Split View and toolbar variable changes.
Installation scripts now support more Firefox and LibreWolf environments across Linux and Windows.
Compatibility
- Tab: Support Split View 1bd41b7
- Toolbar: Color compatibility improvements 72be27c
- Toolbar: Support the latest Firefox and ESR padding variables 1182
- contribute by @stefanwimmer128
- Auto-hide: Restore page space when the navbar or toolbar is hidden 1180 1183
- contribute by @lucassilvas1
- Content: Fix rounded corners fo