{"id":15720273,"url":"https://github.com/gnome/epiphany","last_synced_at":"2025-05-16T12:02:17.795Z","repository":{"id":3471868,"uuid":"4526739","full_name":"GNOME/epiphany","owner":"GNOME","description":"Read-only mirror of https://gitlab.gnome.org/GNOME/epiphany","archived":false,"fork":false,"pushed_at":"2025-04-08T07:10:16.000Z","size":117893,"stargazers_count":348,"open_issues_count":0,"forks_count":51,"subscribers_count":26,"default_branch":"main","last_synced_at":"2025-04-09T05:07:00.788Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://gitlab.gnome.org/GNOME/epiphany","language":"C","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"kkovaacs/zorp","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GNOME.png","metadata":{"files":{"readme":"README.md","changelog":"NEWS","contributing":"CONTRIBUTING.md","funding":null,"license":"COPYING","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2012-06-02T04:12:20.000Z","updated_at":"2025-04-08T07:10:20.000Z","dependencies_parsed_at":"2023-09-23T05:52:47.342Z","dependency_job_id":"d85a3900-e547-4b15-aa5d-9f8eb7fd6ca1","html_url":"https://github.com/GNOME/epiphany","commit_stats":null,"previous_names":[],"tags_count":521,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fepiphany","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fepiphany/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fepiphany/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GNOME%2Fepiphany/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GNOME","download_url":"https://codeload.github.com/GNOME/epiphany/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247980836,"owners_count":21027808,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-10-03T21:58:10.045Z","updated_at":"2025-04-09T05:07:12.071Z","avatar_url":"https://github.com/GNOME.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"# GNOME Web\n\nGNOME Web (codename: Epiphany) is a GNOME web browser based on\n[the WebKit rendering engine](https://webkit.org/). The codename means \"a\nusually sudden manifestation or perception of the essential nature or meaning of\nsomething\" ([Merriam-Webster](https://www.merriam-webster.com/dictionary/epiphany)).\n\nEpiphany is opinionated.\n\n## Download and Install\n\nEpiphany is designed for Linux systems. The recommended way to install Epiphany\nis via [Flatpak](https://www.flatpak.org/). You may:\n\n * [Download the latest stable version from Flathub](https://flathub.org/apps/details/org.gnome.Epiphany)\n   (recommended).\n * [Download Epiphany Technology Preview](https://nightly.gnome.org/repo/appstream/org.gnome.Epiphany.Devel.flatpakref)\n   if you are adventurous and want to help test tomorrow's Epiphany today. It\n   is **not stable**.\n\n * Download Epiphany Canary if you are even more adventurous and want to help\n   test the most recent development versions of WebKitGTK and Epiphany. This\n   flavor of Epiphany is more likely to be **very unstable** because the code\n   being built comes directly from WebKit's git main branch and Epiphany's git\n   master branch. Epiphany Canary can be installed by executing the following\n   flatpak command in a terminal:\n\n   ```shell\n   flatpak --user install https://nightly.gnome.org/repo/appstream/org.gnome.Epiphany.Canary.flatpakref\n   ```\n\nEpiphany is probably also available via your operating system's package manager,\nbut such packages are often outdated and insecure. Flatpak is the best\napplication distribution mechanism for Linux.\n\n## Building from Source\n\n### The Easy Way\n\nThe recommended way to build Epiphany locally is using the flatpak-builder\nmanifest with GNOME Builder. After installing Builder and launching it, you'll\nsee the Select a Project page. Select Open, then select the toplevel Epiphany\ndirectory. Builder will detect the org.gnome.Epiphany.json flatpak-builder\nmanifest and you will be able to build the project in Builder. All required\ndependencies will be provided by the manifest.\n\n### Building Manually\n\nEpiphany uses the [Meson build system](http://mesonbuild.com/). You can build\nEpiphany the same way you would any software that uses Meson. For example:\n\n```\n$ mkdir build \u0026\u0026 cd build\n$ meson ..\n$ ninja\n$ sudo ninja install\n```\n\nYou will have to install several pkg-config dependencies. If you are missing a\ndependency, meson will present an error that looks like this:\n\n```\nmeson.build:84:0: ERROR:  Native dependency 'hogweed' not found\n```\n\nIn RPM-based distributions, you can install the missing dependencies\nautomatically. For example, in Fedora:\n\n```\n$ sudo dnf install 'pkgconfig(hogweed)'\n```\n\nIn deb-based distributions:\n\n```\n$ sudo apt install $(apt-file search --package-only hogweed)\n```\n\nIn other distributions, you must research each dependency to determine which\npackage provides the required pkg-config file.\n\n### Rebuilding Dependencies\n\nNewcomers should try to avoid bugs that require making changes in WebKit or\nother dependencies of Epiphany. Once you've contributed a few easier patches to\nEpiphany and are ready to start making code changes in WebKit or other\ndependencies, then your development setup becomes a bit more complicated. You\nare welcome to use whatever method you prefer for development, but the\nrecommended method is to use either [Toolbox](https://containertoolbx.org/) or\n[JHBuild](https://gnome.pages.gitlab.gnome.org/jhbuild/index.html). Here is an\nexample of how to build your own WebKit using JHBuild, assuming your JHBuild\ninstallation prefix is `$HOME/jhbuild install/`:\n\n```\n$ git clone https://github.com/WebKit/WebKit.git WebKit\n$ mkdir -p WebKit/WebKitBuild/GNOME\n$ cd WebKit/WebKitBuild/GNOME\n$ jhbuild run cmake -DCMAKE_BUILD_TYPE=RelWithDebInfo -DPORT=GTK -DDEVELOPER_MODE=ON -DCMAKE_INSTALL_PREFIX=$HOME/jhbuild/install/ -DCMAKE_INSTALL_LIBDIR=lib -GNinja ../..\n$ jhbuild run ninja\n$ jhbuild run cmake -P cmake_install.cmake\n```\n\n## Manifesto\n\nA web browser is more than an application: it is a way of thinking, a way of\nseeing the world. Epiphany's principles are simplicity, standards compliance,\nand software freedom.\n\n### Simplicity\n\nFeature bloat and user interface clutter is evil.\n\nEpiphany aims to present the simplest interface possible for a browser. Simple\ndoes not necessarily mean less-powerful. The commonly-used browsers of today are\ntoo big, buggy, and bloated. Epiphany is a small browser designed for the web:\nnot for mail, newsgroups, file management, instant messaging, or coffeemaking.\nThe UNIX philosophy is to design small tools that do one thing and do it well.\n\n### Standards Compliance\n\nThe introduction of nonstandard features in browsers could make it difficult\nor impossible to use alternative products like Epiphany if developers embrace\nthem. Alternative standards-complying browsers might not be able to fully access\nwebsites making use of these features. The success of nonstandard features can\nultimately lead one browser to dominate the market.\n\nStandards compliance ensures the freedom of choice. Epiphany aims to achieve\nthis.\n\n### Software Freedom\n\nEpiphany is not just free of cost; more importantly, the source code is made\navailable to you under a license that [respects your freedom](https://www.gnu.org/philosophy/philosophy.html).\n\nJust as GNOME exists to oppose proprietary desktop software, Epiphany opposes\nthe dominance of the web by proprietary software web browsers. Today's chief\noffender is Google Chrome, a browser that purports to be open source, yet\nactually includes several proprietary components. In contrast, Epiphany is fully\nfree software.\n\n## Human Interface\n\nEpiphany follows the [GNOME Human Interface Guidelines](https://developer.gnome.org/hig).\nUnless there are serious reasons to make an exception, not following the\nguidelines will be considered a bug.\n\n### GNOME Integration\n\nEpiphany's main goal is to be integrated with GNOME, as well as similar\ndesktops (notably elementary OS). We don't aim to make Epiphany usable outside\nthese environments.\n\n### Preferences\n\nWe are cautious about adding new preferences. Preferences can be added when they\nmake sense, but they should always be carefully-considered.\n[Preferences come with a cost](https://ometer.com/preferences.html).\n\n### Target Audience\n\nWe target nontechnical users by design. This happens to be 90% of the user\npopulation. Technical details should not be exposed in the interface.\n\nWe target web users, not web developers. A few geek-oriented features, like the\nweb inspector, are welcome so long as they are non-obtrusive.\n\n## Website\n\n[Epiphany has a website,](https://apps.gnome.org/Epiphany) though there is not\nvery much content there.\n\n## Contact Us\n\nThe recommended way to contact us is via the\n[Epiphany discussion forum](https://discourse.gnome.org/tag/epiphany).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnome%2Fepiphany","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgnome%2Fepiphany","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgnome%2Fepiphany/lists"}