Qutebrowser Quickstart Guide
This guide covers everything from a fresh system setup to launching and navigating the keyboard-driven qutebrowser wrapper cleanly on your environment.
Arch Installation
On Arch Linux, applications are managed using the native package manager, pacman.
Environment Commands
Install Qutebrowser: Sync and install the browser using
sudo pacman -Syu qutebrowser
Graphics Pipeline Fix
Because of upstream initialization issues with certain Wayland display pipelines, launching qutebrowser directly can cause a segmentation fault (SIGSEGV). To bypass the hardware acceleration crash and force a stable rendering path, launch the browser from your terminal with these explicit arguments:
qutebrowser --qt-flag disable-gpu --qt-flag disable-vulkan --qt-flag disable-software-rasterizer
Qutebrowser Keybindings ReferenceThis guide
This provides a comprehensive cheat sheet of the essential default keyboard shortcuts and modal commands for navigating qutebrowser efficiently.
Page Navigation & Scrolling
Moving through a webpage uses standard vim-like directional keys, eliminating the need to interact with a scrollbar or mouse.
Scrolling & History
Scroll Down: Press j to move down a line. You can also use Ctrl + d to scroll down a half-page.
Scroll Up: Press k to move up a line. You can also use Ctrl + u to scroll up a half-page.
Jump to Top: Press gg to snap directly to the very top of the webpage.
Jump to Bottom: Press G (Shift + g) to snap directly to the bottom of the page.
History Back: Press H (Shift + h) to step backward through the current tab's browsing history.
History Forward: Press L (Shift + l) to step forward through your history.
Opening Links & Searching
Commands to manipulate the location bar, execute web searches, or find specific text patterns on an active page.
Interactive Location Bars
Open URL / Search:
Press o to open the command prompt for entering a new URL or submitting a default web search query.
Open in New Tab: Press O (Shift + o) to execute an open command or search string directly inside a new tab buffer.
In-Page Search: Press / to activate the text lookup bar. Type your string and press Enter. Cycle Search Results: Press n to step forward through matches, or N (Shift + n) to cycle backward.
Follow Page Link: Press f to overlay characters ("hints") over every visible link. Type the letters to click it in the active tab.
Follow Link in New Tab: Press F (Shift + f) to overlay hints and target the chosen link to open cleanly in a new background tab.
Tab & Buffer Management
Efficiently organize layout columns, control application workspaces, or swap between active tabs.
Workspace Adjustments
Next Tab: Press J (Shift + j) to shift your focus one tab to the right.
Previous Tab: Press K (Shift + k) to shift your focus one tab to the left.
Close Tab: Press d to close and discard the current tab element.
Undo Closed Tab: Press u to instantly reopen the last tab buffer you accidentally closed. Command Mode:
Press : to open the underlying ex-command entry bar for execution or configuration settings.
Posted
06:24 04-06-2026