GNOME/Web

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.

Installation

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

Configuration

Blocking advertisements

Enabled by default, you can disable it by unchecking Try blocking ads in Preferences. EasyList, EasyPrivacy and Fanboy-annoyance are default blocking lists. All lists are periodically refreshed.

To get list of currently enabled filters:

$ gsettings get org.gnome.Epiphany adblock-filters

To set new list of filters, for example uBlock Origin default lists:

$ gsettings set org.gnome.Epiphany adblock-filters "['https://easylist.to/easylist/easylist.txt', 'https://easylist.to/easylist/easyprivacy.txt', 'https://easylist.to/easylist/fanboy-annoyance.txt', 'https://pgl.yoyo.org/adservers/serverlist.php?hostformat=hosts&showintro=1&mimetype=plaintext', 'https://www.malwaredomainlist.com/hostslist/hosts.txt', 'https://mirror.cedia.org.ec/malwaredomains/justdomains']"

See EasyList and Known Adblock Plus subscriptions) for some of the popular ad blocking lists.

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:

~/.config/epiphany/user-stylesheet.css

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

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

Fonts

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

Video

See GStreamer for required plugin installation. For hardware accelerated video decoding also enable #Hardware accelerated compositing.

Hardware accelerated compositing

Enable hardware accelerated compositing with following command:

$ 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