---
id: qutebrowser
version: "3.7.0"
license: GPL-3.0-or-later
license_treatment: copyleft
maintenance: active
---

# qutebrowser — A keyboard-driven, vim-like browser based on Python and Qt.

License: copyleft · Maintenance: active · Downloads: 87.8K/mo

## What it is and what it does

qutebrowser is a web browser designed for users who prefer keyboard-driven workflows similar to vim. It runs on Python and Qt, offering a minimal graphical interface where most navigation and commands are executed via keyboard shortcuts rather than mouse clicks. The browser is free software licensed under GPL-3.0-or-later and draws inspiration from earlier keyboard-focused projects like dwb and Vimperator.

The package depends on jinja2 and PyYAML for configuration and templating, and requires substantial Qt infrastructure (QtCore, QtQuick, QtSQL, QtDBus, QtOpenGL, and either QtWebEngine or QtWebKit as the rendering backend). Installation involves resolving these compiled dependencies, which creates high friction on systems without pre-built binaries. The project maintains active development with recent releases and supports Python 3.9 through 3.13.

Use it for:

- Daily web browsing for developers and power users who work primarily in terminal-based environments and prefer keyboard shortcuts.
- Research and information gathering workflows where rapid keyboard navigation and command-line-style interactions speed up task completion.
- Customizing browser behavior through configuration files (jinja2 templates and YAML) without writing browser extensions.
- Lightweight browsing on systems where traditional browsers feel heavy, leveraging the minimal GUI design.
- Learning vim-like keybindings in a graphical application context before or alongside terminal editor mastery.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

A keyboard-driven, vim-like web browser built on Python and Qt that prioritizes keyboard navigation over mouse interaction.

Yes, if you are a keyboard-focused developer or power user willing to manage Qt dependencies. The active maintenance, zero known vulnerabilities, and GPL license make it a solid choice for personal use. No, if you need a browser that works out-of-the-box on systems without pre-installed Qt libraries or if you require proprietary redistribution rights.

## Install

pip install qutebrowser
uv add qutebrowser
poetry add qutebrowser

## Installing qutebrowser

Before you install: High install friction due to substantial Qt and PyQt dependencies that require compilation or pre-built binaries on most systems. Maintenance is active with a recent release, though the primary maintainer works part-time on the project.

License in practice: GPL-3.0-or-later copyleft license means any modifications or derivative works must be released under compatible terms; suitable for personal use but restrictive for proprietary redistribution.

Quickstart:

pip install qutebrowser
qutebrowser https://example.com

Requires Qt 5.15.0+ or Qt 6.2.0+ and PyQt 5.15.0+ or 6.2.2+ to be installed separately; Python 3.9 or newer required.

Verify before relying:

- Whether PyQt and Qt libraries are pre-installed on target systems or must be compiled from source.
- Exact installation time and disk footprint on common platforms (Linux, macOS, Windows).
- Whether the adblock, pygments, and colorama optional dependencies are worth installing for typical workflows.

## Package facts

- License: GPL-3.0-or-later (copyleft)
- Python support: supports_current
- Install friction: high
- Maintenance: active
- Downloads: 87.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

vim-like browser, keyboard-driven web browser, qt python browser, minimal gui browser, keyboard navigation browser, command-line style browser, qutebrowser alternative, keyboard-driven, vim-inspired, desktop-app

[View on SkillFed](https://skillfed.io/packages/qutebrowser) · [View on PyPI](https://pypi.org/project/qutebrowser/)