Firefox/Tweaks
This page contains advanced Firefox configuration options and performance tweaks.
Contents
- 1 Performance
- 1.1 Change Performance settings
- 1.2 Enable OpenGL Off-Main-Thread Compositing (OMTC)
- 1.3 Enable Accelerated Azure Canvas
- 1.4 Stop urlclassifier3.sqlite from being created again
- 1.5 Turn off the disk cache
- 1.6 Longer interval between session information record
- 1.7 Referrer header control
- 1.8 Defragment the profile's SQLite databases
- 1.9 Cache the entire profile into RAM via tmpfs
- 1.10 Turn off sponsored content and tiles
- 1.11 Enable Electrolysis
- 1.12 Disable Pocket
- 2 Appearance
- 2.1 Fonts
- 2.2 General user interface CSS settings
- 2.2.1 Change the interface font
- 2.2.2 Hide button icons
- 2.2.3 Hiding various tab buttons
- 2.2.4 Horizontal tabs
- 2.2.5 Hide window border and title bar
- 2.2.6 Auto-hide Bookmarks Toolbar
- 2.2.7 Remove sidebar width restrictions
- 2.2.8 Unreadable input fields with KDE Breeze Dark theme
- 2.2.9 Unreadable input fields with dark GTK+ themes
- 2.3 Web content CSS settings
- 3 Mouse and keyboard
- 4 Miscellaneous
- 4.1 Enable additional media codecs
- 4.2 Remove full screen warning
- 4.3 Change the order of search engines in the Firefox Search Bar
- 4.4 "I'm Feeling Lucky" mode
- 4.5 Secure DNS with DNSSEC validator
- 4.6 Adding magnet protocol association
- 4.7 Prevent accidental closing
- 4.8 Plugins do not work with latest version
- 4.9 Jerky or choppy scrolling
- 4.10 Run Firefox inside an nspawn container
- 4.11 Show search matches position in scroll bar
- 4.12 Disable WebRTC audio post processing
- 4.13 Fido U2F authentication
- 5 See also
Performance
Improving Firefox's performance is divided into parameters that can be inputted while running Firefox or otherwise modifying its configuration as intended by the developers, and advanced procedures that involve foreign programs or scripts.
This section contains advanced Firefox options for performance tweaking. For additional information see these MozillaZine articles.
Change Performance settings
Firefox 56 automatically uses settings based on the computer's hardware specifications [1].
Adjusting these settings can be done in Preferences or by changing the dom.ipc.processCount
value to 1-7
and browser.preferences.defaultPerformanceSettings.enabled
to false
manually in about:config
.
However you may want to manually adjust this setting to increase performance even further or decrease memory usage on low-end devices.
In this case the Content process limit for the current user has been increased to 4:
$ ps -e | grep 'Web Content'
13991 tty1 00:00:04 Web Content 14027 tty1 00:00:09 Web Content 14031 tty1 00:00:20 Web Content 14040 tty1 00:00:26 Web Content
Enable OpenGL Off-Main-Thread Compositing (OMTC)
Basic software OMTC is enabled by default.
To check if OpenGL OMTC is enabled, go to about:support
and under the "Graphics" section look for "Compositing". If it reports "Basic", OpenGL OMTC is disabled; if it reports "OpenGL" it is enabled.
If OpenGL OMTC is disabled, you can force-enable it by going to about:config
and enabling layers.acceleration.force-enabled
. Restart Firefox for changes to take effect.
For more information on OMTC in Firefox read here: https://wiki.mozilla.org/Platform/GFX/OffMainThreadCompositing
Enable Accelerated Azure Canvas
Go to about:config
, accept the warning, right click and create a new boolean value. Set the name as gfx.canvas.azure.accelerated
and set it to true
.
To verify restart Firefox then go to about:support
and search for AzureCanvasAccelerated
which should be set to 1.
The acceleration efficiency can be tested by comparing the speed of a javascript demo with and without the setting.
Stop urlclassifier3.sqlite from being created again
Removing all urlclassifier*
files can prevent the use of megabytes of storage in your firefox profile. If you remove all the urlclassifier*
files, you may find out that urlclassifier3.sqlite
keeps growing again after a certain time. Here is a simple solution to avoid it for now and ever.
$ cd ~/.mozilla/firefox/<profile_dir> $ echo "" > urlclassifier3.sqlite $ chmod 400 urlclassifier3.sqlite
This effectively makes the file empty and then read-only so Firefox cannot write to it anymore.
Turn off the disk cache
Every object loaded (html page, jpeg image, css stylesheet, gif banner) is saved in the Firefox cache for future use without the need to download it again. It is estimated that only a fraction of these objects will be reused, usually about 30%. This because of very short object expiration time, updates or simply user behavior (loading new pages instead of returning to the ones already visited). The Firefox cache is divided into memory and disk cache and the latter results in frequent disk writes: newly loaded objects are written to memory and older objects are removed.
The disk cache can be turned off by enabling Preferences > Privacy & Security > Cached Web Content - Override automatic cache management and setting to 0
Limit cache to ... MB of space.
An alternative approach is to use about:config
settings:
- Set
browser.cache.disk.enable
tofalse
- Verify that
browser.cache.memory.enable
is set totrue
, more information about this option can be found in the browser.cache.memory Mozilla article - Add the entry (right click > new > integer)
browser.cache.memory.capacity
and set it to the amount of KB you want to spare, or to-1
for automatic cache size selection (skipping this step has the same effect as setting the value to-1
)
This method has some drawbacks:
- The content of currently browsed webpages is lost if the browser crashes or after a reboot, this can be avoided using anything-sync-daemon or any similar periodically-syncing script so that cache gets copied over to the drive on a regular basis
- The settings need to be configured for each user individually
Longer interval between session information record
Firefox stores the current session status (opened urls, cookies, history and form data) to the disk on a regular basis. It is used to recover a previous session in case of crash. The default setting is to save the session every 15 seconds, resulting in frequent disk access.
To increase the save interval to 10 minutes for example, change in about:config
the setting of browser.sessionstore.interval
to 600000
To disable completely this feature, change browser.sessionstore.resume_from_crash
to false
Referrer header control
The HTTP Referer
header can be extensively configured via about:config
. See Security/Referrer on the Mozilla wiki for the available preferences.
Defragment the profile's SQLite databases
Firefox keeps bookmarks, history, passwords in SQLite databases. SQLite databases become fragmented over time and empty spaces appear all around. But, since there are no managing processes checking and optimizing the database, these factors eventually result in a performance hit. A good way to improve start-up and some other bookmarks and history related tasks is to defragment and trim unused space from these databases.
You can use profile-cleanerAUR to do this, while Firefox is not running:
SQLite database | Size Before | Size After | % change |
---|---|---|---|
urlclassifier3.sqlite | 37 M | 30 M | 19 % |
places.sqlite | 16 M | 2.4 M | 85 % |
Firefox provides a tool to defragment and optimize the places database, which is the source of most slowdowns and profile corruptions. To access this tool, open the about:support
page, search for Places Database
and click the Verify Integrity
button.
Cache the entire profile into RAM via tmpfs
If the system has memory to spare, tmpfs
can be used to cache the entire profile directory, which might result in increased Firefox responsiveness.
Turn off sponsored content and tiles
In about:config
, set the string value to a blank for both of these: browser.newtabpage.directory.source
and browser.newtabpage.directory.ping
. Consider also disabling the tile feature from the tools on a new tab page. A Wireshark session demonstrates the level of chatter created by these features.
Enable Electrolysis
Electrolysis (multi-process) may be enabled to improve performance and security by setting browser.tabs.remote.autostart
to true in about:config
. It may be needed to force-enable Electrolysis [2], although this is generally not recommended and may cause issues.
To check if Electrolysis is enabled, go to about:support
and under the "Application Basics" section look for "Multiprocess Windows". If it reports "0/1 (Disabled)", Electrolysis is disabled; if it reports "1/1 (Enabled by user)" it is enabled. Note that the given numbers */* indicate the number of open Firefox windows, e.g. 0/2 meaning non of the two Firefox-windows are using Electrolysis, and 2/2 means it is enabled for both windows.
Disable Pocket
If you don't use the Pocket-service, you may want to disable it by setting extensions.pocket.enabled
to false in about:config
.
Appearance
Fonts
See the main article: Font configuration
Configure the DPI value
Modifying the following value can help improve the way fonts looks in Firefox if the system's DPI is below 96. Firefox, by default, uses 96 and only uses the system's DPI if it is a higher value. To force the system's DPI regardless of its value, type about:config
into the address bar and set layout.css.dpi
to 0.
Note that the above method only affects the Firefox user interface's DPI settings. Web page contents still use a DPI value of 96, which may look ugly or, in the case of high-resolution displays, may be rendered too small to read. A solution is to change layout.css.devPixelsPerPx
to system's DPI divided by 96. For example, if your system's DPI is 144, then the value to add is 144/96 = 1.5. Changing layout.css.devPixelsPerPx
to 1.5 makes web page contents use a DPI of 144, which looks much better.
See also HiDPI#Firefox for information about HiDPI displays and [3] for calculating the DPI.
Default font settings from Microsoft Windows
Below are the default font preferences when Firefox is installed in Microsoft Windows. Many web sites use the Microsoft fonts.
Proportional: Serif Size (pixels): 16 Serif: Times New Roman Sans-serif: Arial Monospace: Courier New Size (pixels): 13
General user interface CSS settings
Firefox's user interface can be modified by editing the userChrome.css
and userContent.css
files in ~/.mozilla/firefox/<profile_dir>/chrome/
(profile_dir is of the form hash.name, where the hash is an 8 character, seemingly random string and the profile name is usually default).
chrome/
folder and userChrome.css
/userContent.css
files may not necessarily exist, so they may need to be created.This section only deals with the userChrome.css
file which modifies Firefox's user interface, and not web pages.
Change the interface font
The setting effectively overrides the global GTK+ font preferences, and does not affect webpages, only the user interface itself:
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
* { font-family: "FONT_NAME"; }
Hide button icons
Enables text-only buttons:
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
.button-box .button-icon { display: none; }
Hiding various tab buttons
These settings hide the arrows that appear to the horizontal edges of the tab bar, the button that toggles the "all tabs" drop-down list, and the plus sign button that creates a new tab.
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
/* Tab bar */ .tabbrowser-strip *[class^="scrollbutton"] { /* Hide tab scroll buttons */ display: none; } .tabbrowser-strip *[class^="tabs-alltabs"] { /* Hide tab drop-down list */ display: none; } .tabbrowser-strip *[class^="tabs-newtab-button"] { /* Hide new-tab button */ display: none; }
Horizontal tabs
To place the tab bar horizontally stacked along the sides of the browser window:
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
/* Display the tabbar on the left */ #content > tabbox { -moz-box-orient: horizontal; } .tabbrowser-strip { -moz-box-orient: vertical; /* * You can set this to -moz-scrollbars-vertical instead, * but then the scrollbar will *always* be visible. this way * there is never a scrollbar, so it behaves like the tab bar * normally does */ overflow: -moz-scrollbars-none; } .tabbrowser-tabs { -moz-box-orient: horizontal; min-width: 20ex; /* You may want to increase this value */ -mox-box-pack: start; -moz-box-align: start; } .tabbrowser-tabs > hbox { -moz-box-orient: vertical; -moz-box-align: stretch; -moz-box-pack: start; } .tabbrowser-tabs > hbox > tab { -moz-box-align: start; -moz-box-orient: horizontal; }
Hide window border and title bar
Install the Hide Caption Titlebar Plus extension and set the following settings (leaving other settings to default):
Option | Value |
---|---|
Show Custom Caption/TitleBar | Never |
Activate custom borders and corner resizers | Deactivate |
Enable Customizable Buttons (min,max,close) | Using a Glass-like window background |
Custom Minimize, Max, Close Buttons | Auto. Current theme's skin (fixed position) |
Drag Fx window using Tab-bar background | Enable |
Alternative hide-titlebar feature | Use |
The extension Classic Theme Restorer provides more tweaking options to get the best result (e.g. set tab height to 28px, enable/disable toolbars/buttons, etc.).
Auto-hide Bookmarks Toolbar
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
#PersonalToolbar { visibility: collapse !important; } #navigator-toolbox:hover > #PersonalToolbar { visibility: visible !important; }
Remove sidebar width restrictions
~/.mozilla/firefox/<profile_dir>/chrome/userChrome.css
/* remove maximum/minimum width restriction of sidebar */ #sidebar { max-width: none !important; min-width: 0px !important; }
Unreadable input fields with KDE Breeze Dark theme
If you are using KDE desktop in conjunction with Breeze Dark theme, you might find that some input fields have dark background, which makes text unreadable. A solution to this issue is to use a non-dark GTK theme along with a dark Firefox theme. Similarly, by using a dark Firefox theme your browser will look the way you want (requires Firefox 56 or later).
Unreadable input fields with dark GTK+ themes
When using a dark GTK+ theme, one might encounter Internet pages with unreadable input and text fields (e.g. text input field with white text on white background). This can happen because the site only sets either background or text color, and Firefox takes the other one from the theme.
To prevent Firefox from using theme's colors in web pages one can set browser.display.use_system_colors
to false
in about:config
.
The extension Text Contrast for Dark Themes sets the other color as needed to maintain contrast.
Another workaround is to explicitly set standard colors for all web pages in userContent.css
or using the stylus add-on.
The following sets input fields to standard black text / white background; both can be overridden by the displayed site, so that colors are seen as intended:
urlbar
and searchbar
to be white
remove the two first :not
css selectors.input:not(.urlbar-input):not(.textbox-input):not(.form-control):not([type='checkbox']):not([type='radio']), textarea, select { -moz-appearance: none !important; background-color: white; color: black; } #downloads-indicator-counter { color: white; }
Alternatively, force Firefox to use a light theme (e.g. "Adwaita:light"):
- Copy
/usr/share/applications/firefox.desktop
to~/.local/share/applications/firefox.desktop
and replace all occurrences ofExec=firefox
withExec=env GTK_THEME=Adwaita:light firefox
. - Close all running instances of Firefox and restart your window manager/desktop environment.
Another way to change gtk theme for content process only, which keeps dark UI theming, but enforces light theme for rendering webpage itself:
- Open
about:config
in the address bar - Create a new string type preference (right mouse button > New > String) named
widget.content.gtk-theme-override
- Set the value to the light theme to use for rendering purposes (e.g.
Adwaita
) - Restart Firefox
Web content CSS settings
This section deals with the userContent.css
file in which you can add custom CSS rules for web content. Changes to this file will take effect once the browser is restarted.
This file can be used for making small fixes or to apply personal styles to frequently visited websites. Custom stylesheets for popular websites are available from sources such as userstyles.org. You can install an add-on such as superUserContent to manage themes. This add-on creates the directory chrome/userContent.css.d
and applies changes to the CSS files therein when the page is refreshed.
Import other CSS files
~/.mozilla/firefox/<profile_dir>/chrome/userContent.css
@import url("./imports/some_file.css");
Block certain parts of a domain
~/.mozilla/firefox/<profile_dir>/chrome/userContent.css
@-moz-document domain(example.com) { div#header { background-image: none !important; } }
Add [pdf] after links to PDF files
~/.mozilla/firefox/<profile_dir>/chrome/userContent.css
/* add '[pdf]' next to links to PDF files */ a[href$=".pdf"]:after { font-size: smaller; content: " [pdf]"; }
Block ads
See floppymoose.com for an example of how to use userContent.css
as a basic ad-blocker.
Mouse and keyboard
Mouse wheel scroll speed
To modify the default values (i.e. speed-up) of the mouse wheel scroll speed, go to about:config
and search for mousewheel.acceleration
. This will show the available options, modifying the following:
- Set
mousewheel.acceleration.start
to-1
. - Set
mousewheel.acceleration.factor
to the desired number (10
to20
are common values).
Mozilla's recommendation for increasing the mousewheel scroll speed is to:
- Set
mousewheel.default.delta_multiplier_y
between200
and500
(default:100
)
Alternatively you can install the SmoothWheel add-on.
Pixel-perfect trackpad scrolling
To enable one-to-one trackpad scrolling (as can be witnessed with GTK3 applications like Nautilus), set the MOZ_USE_XINPUT2=1
environment variable before starting Firefox.
If scrolling is undesirably jerky, try enabling Firefox's "Smooth Scrolling" option in Preferences > Advanced.
Enable touchscreen gestures
Make sure dom.w3c_touch_events.enabled
is either set to 1 (enabled) or 2 (default, auto-detect).
Run export MOZ_USE_XINPUT2=1
before launching Firefox. To make this change persistent, add that command to /etc/profile.d/firefox.sh
.
Mouse click on URL bar's behavior
To make the url bar behaves like in Windows regarding mouse clicks: a single click selects everything, a double click selects a single word until a punctuation sign and a triple click selects everything again, set the following in about:config
:
browser.urlbar.clickSelectsAll; true browser.urlbar.doubleClickSelectsAll; false layout.word_select.stop_at_punctuation; true (default)
Set backspace's behavior
See Firefox#Backspace does not work as the 'Back' button.
Disable middle mouse button clipboard paste
See Clipboard#Firefox.
Miscellaneous
Enable additional media codecs
Before continuing, remember there is a reason some of these variables are not enabled by default, e.g. stability, memory leaks, etc. Go to about:config
and check the following options:
Key | Value | Description |
---|---|---|
media.mediasource.enabled | true (default) | Enable Media Source Extensions (MSE) |
media.mediasource.mp4.enabled | true (default) | Enable MP4 MSE |
media.mediasource.webm.enabled | true (default) | Enable WebM MSE. |
media.mediasource.ignore_codecs | true | Enable H.264 MSE, amongst other things (This boolean key has to be created!) |
Widevine and Netflix/Amazon Video
Widevine is a digital rights management tool that Netflix, Amazon Prime Video, and others use to protect their video content.
The first time you visit a Widevine-enabled page Firefox will display a prompt below the address bar asking for permission to install DRM. Approve this and then wait for the "Downloading" bar to disappear, you are now able to watch videos from Netflix, Amazon Prime Video, or any other Widevine protected site.
Remove full screen warning
Warning about video displayed in full screen mode ("… is now fullscreen") can be disabled by setting full-screen-api.warning.timeout
to 0
in about:config
.
Change the order of search engines in the Firefox Search Bar
To change the order search engines are displayed in:
- Open the drop-down list of search engines and click Manage Search Engines... entry.
- Highlight the engine you want to move and use Move Up or Move Down to move it. Alternatively, you can use drag-and-drop.
"I'm Feeling Lucky" mode
Some search engines have a "feeling lucky" feature. For example, Google has "I'm Feeling Lucky", and DuckDuckGo has "I'm Feeling Ducky".
To activate them, search for keyword.url
in about:config
and modify its value (if any) to the URL of the search engine.
For Google, set it to:
https://www.google.com/search?btnI=I%27m+Feeling+Lucky&q=
For DuckDuckGo, set it to:
https://duckduckgo.com/?q=\
Secure DNS with DNSSEC validator
You can enable DNSSEC support for safer browsing.
Adding magnet protocol association
In about:config
set network.protocol-handler.expose.magnet
to false
. In case it does not exist, it needs to be created, right click on a free area and select New > Boolean, input network.protocol-handler.expose.magnet
and set it to false
.
The next time you open a magnet link, you will be prompted with a Launch Application dialogue. From there simply select your chosen torrent client. This technique can also be used with other protocols.
Prevent accidental closing
The Disable Ctrl-Q Shortcut extension can be installed to prevent unwanted closing of the browser.
An alternative is to add a rule in your window manager configuration file. For example in Openbox add:
<keybind key="C-q"> <action name="Execute"> <execute>false</execute> </action> </keybind>
in the <keyboard> section of your ~/.config/openbox/rc.xml
file.
Plugins do not work with latest version
There can be compatibility issues with plugins not working with the latest Firefox version (e.g. Pentadactyl). If possible, try installing the nightly/beta builds available, or temporarily downgrade Firefox.
Disable Add-on Compatibility Checks plugin should take care of spurious compatibility issues when the plugins get disabled, even though they work just fine with the new version.
Jerky or choppy scrolling
Scrolling in Firefox can feel "jerky" or "choppy". A post on MozillaZine gives settings that work on Gentoo, but reportedly work on Arch Linux as well:
- Set
mousewheel.min_line_scroll_amount
to 40 - Set
general.smoothScroll
andgeneral.smoothScroll.pages
to false - Set
image.mem.min_discard_timeout_ms
to something really large such as 2100000000 but no more than 2140000000. Above that number Firefox will not accept your entry and complain with the error code: "The text you entered is not a number." - Set
image.mem.max_decoded_image_kb
to at least 512K
Now scrolling should flow smoothly.
Run Firefox inside an nspawn container
Note: on newer systems, you must enable local access to the user xserver with 'xhost local:root'
To run as PID 1
# systemd-nspawn --setenv=DISPLAY=:0 \ --setenv=XAUTHORITY=~/.Xauthority \ --bind-ro=$HOME/.Xauthority:/root/.Xauthority \ --bind=/tmp/.X11-unix \ -D ~/containers/firefox \ firefox
Else rather boot the container, with systemd ideally setting up your networking with systemd-networkd:
# systemd-nspawn --bind-ro=$HOME/.Xauthority:/root/.Xauthority \ --bind=/tmp/.X11-unix \ -D ~/containers/firefox \ --network-veth -b
--bind-ro=/tmp/.X11-unix
Once your container is booted, run the Xorg binary like so:
# systemd-run -M firefox --setenv=DISPLAY=:0 firefox
Show search matches position in scroll bar
This chrome feature can be achieved via FindBar Tweak extension.
Disable WebRTC audio post processing
If you are using the PulseAudio module-echo-cancel, you probably don't want Firefox to do additional audio post processing.
To disable audio post processing, change the value of the following preferences to false
:
-
media.getusermedia.aec_enabled
(Acoustic Echo Cancellation) -
media.getusermedia.agc_enabled
(Automatic Gain Control) -
media.getusermedia.noise_enabled
(Noise suppression)
Fido U2F authentication
Install libu2f-host for the required udev rules to allow Firefox to communicate with the U2F key.
Since version 57, Firefox supports Fido U2F authentication protocol. However, it's disabled by default. To enable it set the following settings to true
in about:config
.
-
security.webauth.u2f
-
security.webauth.webauthn_enable_usbtoken
If you're using a Firefox version lower than 57 (e.g. Firefox 52 ESR), U2F isn't supported natively, but there is an extension to add this functionality.