Ouch Browser

Focus on your browsing.

Features

• Arc Browser-like workflow (UI, keyboard shortcuts, etc.)
• Intergration with the GNOME platform
• Privacy respecting (we do not collect any data)
• Mobile support
• Extremely lightweight (the binary is just a little over a megabyte large!)
• Extensible via plugins (using Lua)

Installing

As Ouch Browser is beta software, it's installation options are limited.

Binary

Warning

Ouch Browser is only officially available on x86_64 architectures. You may need to build Ouch Browser for your architecture before continuing.

Note

You might want to install a package for your package manager instead. We recommend using the Flatpak package for installation.

1. Download the latest release

2. Extract the file. This will result in a new ouch-0.5.0-x86_64 folder in where you downloaded the file, depending on your method of extraction.

3. Open the directory, then execute the install.sh file.

Wait a few seconds, and Ouch Browser should appear in your launcher. If it doesn't by a minute, you may need to log out, and log back in.

Flatpak

1. Download the latest release

2. Extract the file. This will result in a new ouch-0.5.0-x86_64 folder in where you downloaded the file, depending on your method of extraction.

3. Open the directory in a terminal, then run:

flatpak install ./site.srht.shrimple.ouch.flatpak

RPM

Fedora Workstation (and most Fedora derivatives and spins)

1. Add Ouch Browser's COPR repo

sudo dnf enable shrimple/ouch

2. Install Ouch Browser

sudo dnf install ouch

Fedora Atomic (Silverblue, Kinoite, etc.)

Note

None of the maintainers of Ouch Browser use an Fedora Atomic desktop. If you do, please contribute instructions on how to install the Ouch Browser COPR repo.

Building

Binary

To build Ouch Browser, you need GTK 4, libadwaita, WebKitGTK, Blueprint, and just installed on your system.

If you are on Fedora, you can install the GNOME Software Development group, which should provide all of the needed dependencies. Check your Linux distribution's package manager for a similar meta-package.

sudo dnf group install gnome-software-development

Then, you can build Ouch Browser.

just build-schemas
just build

Flatpak

GNOME Builder

Building Ouch Browser as a Flatpak with GNOME Builder is recommended due to being integrated with GNOME.

0. Open GNOME Builder, then click on "Clone Repository..." then enter https://git.sr.ht/~shrimple/ouch into the "Repository URL" field.

1. Click on the little hammer icon on the title bar. This will start the build.

2. After the build has finished, click on the dropdown menu beside the hammer icon, and click on "Export," and a GNOME Files window will open with the exported file selected.

Flatpak Builder

Building Ouch Browser as a Flatpak with Flatpak Builder may be a better way than using GNOME Builder, due to being run as a single command, and is editor-agonistic. You can build the Flatpak with this command:

just build-flatpak

The exported Flatpak file will be in the Ouch Browser source folder.

Development

The maintainers of Ouch Browser use Visual Studio Code to develop Ouch Browser, but however, GNOME Builder is recommended, due to being easy to use, and it's simplicity. Despite whichever one you choose, we provide configurations for both of the editors (.vscode/settings.json and .editorconfig). If you plan on contributing, we do not recommend changing any of these settings.

For Visual Studio Code users, we also provide a file (.vscode/extensions.json) containing the needed extensions to develop Ouch Browser. We also include tasks, for example, you can press Ctrl + Shift + B to build Ouch Browser.

Contributing Translations

Translations are more than welcome, please go to our Weblate project to get started.

Credits

• Jakub Steiner for designing the app icon.
• Lo for the tabs code and the URL matching code from Zenith.
• All of the translation contributors.