How to Set Up and Use Qutebrowser on Linux

Qutebrowser is a keyboard-focused, Vim-inspired web browser built with Python and Qt. On Linux, you can install it from several distribution repositories, then handle most everyday browsing without reaching for the mouse. This guide covers the current installation options, the shortcuts that matter first, and the supported ways to customize the browser.

Install Qutebrowser on Linux

Qutebrowser's own installation guide lists packages for major Linux distributions. The project notes that distro packages are community-maintained, so versions in Debian Stable or Ubuntu can lag behind upstream releases.

Open a terminal and use the command for your distribution:

  • Ubuntu, Debian, and Linux Mint: sudo apt install qutebrowser
  • Fedora: sudo dnf install qutebrowser
  • Arch Linux: sudo pacman -S qutebrowser
  • Gentoo: run emerge -av qutebrowser as root.
  • Void Linux: run xbps-install qutebrowser as root.

For openSUSE, the official Qutebrowser instructions point users to prebuilt packages on the openSUSE Build Service rather than documenting a universal default-repository command.

Linux terminal showing Qutebrowser install commands for Ubuntu or Debian, Fedora, and Arch Linux
Use the package command that matches your Linux distribution.

After installation, launch the browser from your desktop application menu or run qutebrowser in a terminal. If a distro package is old or broken, check the upstream installation page before adding third-party repositories.

Open websites and search from the keyboard

The fastest way to learn Qutebrowser is to use its normal-mode shortcuts. According to the official Qutebrowser quickstart, press o to enter a URL or search query in the current tab. Press O instead to open it in a new tab. If the text is not recognized as a URL, Qutebrowser sends it to the configured search engine; DuckDuckGo is the default search engine documented by the project.

Qutebrowser window with an address prompt containing https://www.example.com
Press o, type a URL or search, and press Enter.

For page navigation, use the arrow keys or the Vim-style h, j, k, and l keys. Press H to go back in history and L to go forward. Use + and - to zoom.

Click links without a mouse

Press f to enter hint mode. Qutebrowser places short labels over clickable elements; type the label shown on the link you want. This is one of the browser's defining features because it makes link navigation practical without pointer movement.

Qutebrowser hint mode showing short keyboard labels over links on an example web page
Hint mode labels clickable elements so you can select them from the keyboard.

Manage tabs, search pages, and bookmarks

A small set of shortcuts covers most daily browsing:

  • J / K: move to the next or previous tab.
  • d: close the current tab.
  • u: reopen the most recently closed tab.
  • /: search within the current page; use n and N for next and previous matches.
  • : open the command line.

Commands provide access to functions that do not need a dedicated shortcut. For example, use :bookmark-add to save the current page and :bookmark-list to open the bookmark list. The official command reference documents available commands and their options.

Customize Qutebrowser

For simple changes, press : and run :set with no arguments. Qutebrowser opens its qute://settings page, where supported settings can be changed and saved to autoconfig.yml. The project specifically advises against editing that YAML file by hand.

Qutebrowser settings view with the qute settings page and config edit command visible
Qutebrowser supports both its settings page and a Python configuration file for customization.

Advanced users can create config.py, typically at ~/.config/qutebrowser/config.py on Linux. Run :config-edit to open it in your configured editor and :config-source to reload it. The official configuration guide also explains an important detail: once a config.py exists, autoconfig.yml is not loaded automatically unless your Python configuration calls config.load_autoconfig().

Useful first-session checklist

  1. Install Qutebrowser from your distribution or the upstream-recommended source.
  2. Launch it and press o to open a site.
  3. Practice j/k scrolling and f hint mode.
  4. Use J/K for tabs and d/u to close or restore them.
  5. Open :help whenever you need the built-in documentation.

Once those shortcuts become familiar, Qutebrowser works much like a modal editor for the web: normal mode handles navigation, hint mode selects page elements, insert mode passes typing to web forms, and command mode gives direct access to browser actions.

Leave a Comment

How to Record Speaker Output on Linux with Audacity

How to Record Speaker Output on Linux with Audacity

Capture Linux desktop audio in Audacity by routing its recording stream to your output device’s monitor source. Follow PulseAudio and PipeWire steps, export tips, and fixes for silent tracks.

How to Use Dropbox on Linux: Install and Sync Your Files

How to Use Dropbox on Linux: Install and Sync Your Files

Install Dropbox on Linux from the official package, sign in, sync a local folder, manage selective sync, and check status from the command line.

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

How to Install Inkscape on Linux: Ubuntu, Fedora, Arch, and More

Install Inkscape from your Linux distribution’s repositories, the Ubuntu stable PPA, Snap, or Flathub, with current commands and notes for choosing a package source.

How to Find and Remove Duplicate Files on Linux With FSlint

How to Find and Remove Duplicate Files on Linux With FSlint

Use FSlint to scan selected Linux folders, review duplicate groups, and safely delete redundant files or learn when hard-link merging is appropriate.

How to Install SABnzbd on Linux and Configure It

How to Install SABnzbd on Linux and Configure It

Install SABnzbd on Ubuntu or Debian, or run it in Docker on another Linux host. Then open the web interface and configure your provider and download folders.

How to Install the Paper GTK Theme on Linux

How to Install the Paper GTK Theme on Linux

Install the Paper GTK theme from supported Linux repositories, enable it for GTK apps in GNOME Tweaks, and see what the legacy theme can and cannot change.

How to Install and Set Up Plex on OpenMediaVault with Compose

How to Install and Set Up Plex on OpenMediaVault with Compose

The old OpenMediaVault Plex plugin is archived. Set up Plex on OMV 8 with OMV-Extras, the Compose plugin, persistent storage, and Plex’s official container.

How to Clean and Speed Up Ubuntu Safely

How to Clean and Speed Up Ubuntu Safely

Clean and speed up Ubuntu with safe APT cleanup, storage checks, and startup controls that help free space and troubleshoot a sluggish desktop.

How to Install the Hiri Email Client on Linux

How to Install the Hiri Email Client on Linux

Install Hiri on Linux with its Snap package or official tarball, add a desktop launcher, and check supported accounts plus a warning about Hiri’s old Snap release.

How to Get System Specifications for a Linux PC

How to Get System Specifications for a Linux PC

Use Fastfetch and built-in Linux commands to check your distro, kernel, CPU, memory, graphics, storage, and connected devices, then save a clear report.