Skip to content

Config Options

Zap edited this page May 29, 2024 · 14 revisions

An interactive configurator is available at https://zapsnh.github.io/zcpt-configurator/. To apply the settings, place the exported user.js file in your profile folder/directory (Profiles > XXXXXXXX.profile), launch Firefox, and then delete it afterwards.

For the WebExtension version, the configurator is can be found in the extension's option page. The settings apply after you click Apply.

Note

Make sure you're creating these configs as Boolean and not String

Context menus

In about:config, if you want native (Windows) context menus, you can create:

Config Name Result Image
uc.contextmenu.win-10 Windows 10 styled menu image
uc.contextmenu.win-11 Windows 11 styled menu, Also kinda looks the GNOME context menu image
uc.contextmenu.dark Makes the context menu dark image image
uc.contextmenu.light Makes the context menu light image image

If you don't set uc.contextmenu.light or uc.contextmenu.dark, then the context menu will take the colors from the theme:

Windows 11 style context menu with the dark Alpenglow theme

Megabar

In about:config, if you want to reduce the megabar or disable it, create:

Config Name Result Image
none Default Photon Megabar normal
uc.reduced-megabar Slightly smaller Proton-sized Megabar reducedmegabar
uc.no-megabar No megabar nomegabar

Themes

For themes where the tab color and navbar color are different (and for people who want them to be the same), go to about:config and create:

Config Name Result Image
none Default behavior

Top: Theme in Proton
Bottom: Theme with config
Normal
uc.theme.tab-color-same-as-navbar Tab color takes the navbar color

Top: Theme in Proton
Bottom: Theme with config
Navbar Color
uc.theme.navbar-color-same-as-tab Navbar color takes the tab color

Top: Theme in Proton
Bottom: Theme with config
Tab Color

Sidebery

There is basic support for Sidebery. You can turn it on with:

Config Name Result Image
uc.sidebery Vertical Tabs image

Notes

  • You will need to insert this into Sidebery's style editor.
  • To be able to switch between vertical tabs mode and normal mode, turn on Add preface to the browser window's title if Sidebery sidebar is active and set the preface value to [VT] (incl. space at the end).
  • Using uc.reduced-megabar or uc.no-megabar is recommended.
  • Set the font-size to XXS under the Appearance section. (where?)
  • Set the theme to plain under the Appearance section. (where?)
  • Set the density to relaxed under the Appearance section. (where?)

Bottom Tabs

In about:config, you can turn on bottom tabs with:

Config Name Result Image
uc.bottom-tabs Bottom Tabs bottombook
uc.bottom-tabs.bookmark-on-top Bottom Tabs with bookmarks on top topbook

Notes

  • Using uc.reduced-megabar or uc.no-megabar is recommended.

New Tab Background

In about:config, you can turn on a new tab background with:

Config Name Result Image
uc.newtab.background New tab background image

Notes

  • For Firefox 127 (nightly) and above, you can also enable this pref without an image in the chrome/resources folder alongside a new tab wallpaper.
  • Add background.png in the resources folder with your own PNG image.

Full Width Tabs

In about:config, you can turn on full width tabs with:

Config Name Result Image
uc.full-width-tabs Full width tabs
Can be coupled with uc.bottom-tabs if you want the 🤮Safari🤮 look.
image

Styled HTML Forms

In about:config, you can enable HTML Form styling with:

Config Name Result Image
uc.style-forms HTML Form styling uc style-forms

Notes

  • May break HTML Form styling on websites.

Revert the All Tabs Button Behavior

In about:config, you can revert the all tabs button behavior with:

Config Name Result Image
uc.revert-all-tabs-behavior Only show the all tabs button when the tab bar is overflowing just like pre-Photon/early-Proton uc revert-all-tabs-behavior

Always show tab close button

In about:config, you can always show the tab close button with:

Config Name Result Image
uc.always-show-close-button Always show the tab close button even when the tabs are small. image