From ArchWiki
< GNOME(Redirected from Epiphany)
Jump to navigation Jump to search

Web is the default web browser for GNOME. Web provides a simple and minimalist interface for accessing the internet. Whilst it is developed primarily for GNOME, Web works acceptably in other desktop environments as well.

Note: Web was known as Epiphany prior to version 3.4. The application was given new descriptive names, one for each supported language. The name Epiphany is still used in numerous places such as the executable name, some package names, some desktop entries, and some GSettings schemas.


Web can be installed by installing the epiphany package. If you want to save login passwords, install gnome-keyring.


Blocking advertisements

Enabled by default, one can disable it by unchecking Block Advertisements in Preferences. EasyList is the default blocking list. All lists are periodically refreshed.

To get list of currently enabled filters:

$ gsettings get org.gnome.Epiphany content-filters

Tango-edit-clear.pngThis article or section needs language, wiki syntax or style improvements. See Help:Style for reference.Tango-edit-clear.png

Reason: English can be improved here; changes required for better readability. (Discuss in Talk:GNOME/Web)

Web has been using content filter for a while, therefor JSON-formatted resource must be setted. One can found the rules form this link. For example:

$ gsettings set org.gnome.Epiphany content-filters "['', '']"
Tip: dconf-editor may be used as an GUI alternative.

Tracking Prevention

Web includes Intelligent Tracker Prevention, which can be enabled in Preferences.

Firefox Sync

Web allows the usage of Firefox Sync to sync bookmarks, history, passwords and open tabs. It can be configured in the Import and Export dropdown menu.

Web applications

Web can create web applications out of websites and add them to desktop menu. To configure and remove them enter about:applications in the address bar.

Custom stylesheet

Web supports custom stylesheet you can enable under Fonts and style in Preferences.

Use example below to set new tab page layout and colors according to Adwaita dark variant:

#overview {
  background-color: #2E3436 !important;
  max-width: 100% !important;
  max-height: 100% !important;
  position: fixed !important;

#overview .overview-title {
  color: white !important;


Web does not check GNOME font settings, but checks Font configuration.


See GStreamer for required plugin installation.

To enable hardware accelerated video decoding, see GStreamer#Hardware video acceleration and #Hardware accelerated compositing.

Hardware accelerated compositing

By default hardware accelerated compositing is only used when required (on-demand) to display 3D transforms.

To force enable hardware accelerated compositing:

$ gsettings set org.gnome.Epiphany.web:/ hardware-acceleration-policy 'always'

Proxy configuration

Web provides for proxy configuration no graphical menu, instead use Proxy server#Environment variables

See also