# qutebrowser

qutebrowser is a lightweight keyboard-driven, vim-like browser based on PyQt5 and QtWebKit.

## Installation

The qutebrowserAUR and qutebrowser-gitAUR packages can be installed.

## Basic usage

Use `:` to access the command prompt. You can use `Tab` to auto-complete.

Read the man page for more details.

    $ man qutebrowser

### basic keyboard shortcuts

    o        = enter url
    O        = enter url in new tab
    f        = spawn hints. Use arrow keys to browse the hints while displaying their URI, or use the hint letters.
    F        = spawn hints in new tab
    ;b       = spawn hints in new background tab
    ;r       = follow multiple background links rapidly
    H        = back
    L        = forward
    J        = go to next tab
    K        = go to previous tab
    'n'+T    = goto 'n' tab
    d        = close tab
    u        = undo closing tab
    ctrl+s   = stop loading
    r        = reload
    R        = reload ignoring cache
    ctrl+e   = open editable field in external editor (insert mode only)
    ;d       = download hinted URL
    m        = save bookmark
    gf       = toggle page source view
    +        = zoom_in
    -        = zoom_out
    =        = reset to 100%
    Ss       = show settings/configuration/options

### vim-like

    i        = toggle_insert_mode   (Esc works to go back to normal mode much like Vim)
    Esc      = back to normal mode (ctrl+n works too)
    j        = scroll down
    k        = scroll up
    h        = scroll left
    l        = scroll right
    gg       = go to top
    G        = go to bottom
    /        = find in page
    n        = repeat find forward
    :q       = quit/exit

### user configuration

You will find the configuration files of qutebrowser in your `XDG_CONFIG_HOME (or ~/.config)` under `qutebrowser/`. The main configuration happens in the file qutebrowser.conf, which is organized in sections like an ini-file. For example, under [searchengines] you can configure your search engines as described by the comment. To add a shortcut for searching the the arch wiki, add these two lines:

    archwiki = https://wiki.archlinux.org/?search={}
    aw = ${archwiki}

Now - in qutebrowser - you can search the arch wiki for an article about qutebrowser via `:open aw qutebrowser` which will bring you to this page. As per the standard configuration the key mapping 'o' will subsitute :open, so typing `o aw <your search term>` will henceforth allow you to quickly search the arch wiki.

Category:

- Web browser