luakit browser

sources: wiki archlinux.org

Luakit is an extremely fast, lightweight and flexible web browser using the webkit engine. It is customizable through lua scripts and fully usable with keyboard shortcuts.

Basic usage

Note: Most of the shortcuts are viewable and customizable from ~/.config/luakit/binds.lua.

Press:to access the command prompt. You can do nearly everything from there. Use [Tab] to autocomplete commands.

To quit, use the:quitcommand, or the ZQ shortcut. You can also close the browser while remembering the session (i.e. restoring the tabs) by using the:writequitcommand instead, or the ZZ shortcut.

Browsing

Press:oto open a prompt with the open command and enter the URI you want.
Press:Oto edit the current URI.
If it is not a recognized URI, Luakit will use the default search engine specified in globals.lua.
Specify which search engine to use by prefixing the entry with the appropriate keywork (e.g.:open google foobarwill search foobar on Google).
Use common shortcuts to navigate. For emacs and vim aficionados, some of their regular shortcuts are provided. You can use the mouse as well.
Use:fto display the index of all visible links. Enter the appropriate number or a part of the string to open the link.
Use:Finstead to open link in a new tab.
Press Ctrl+t to open a new tab, Ctrl+w to close it. Press:tto prompt for an URI to be opened in a new tab, and:Tto edit the current URI in a new tab.
Press:wto prompt for an URI to be opened in a new window, and:Wto edit the current URI in a new window.
Switch from one tab to another with gt and gT, or Ctrl+Page Up and Ctrl+Page Down.
```
Reorder the tabs with < and >.
```
Reload the page with r, stop the loading with Ctrl+c.
You can re-open last closed tab with u.
Open downloads page with gd (or gD fo a new tab).
Copy URI to primary selection with y.
View page source code with:viewsource. Return to normal view with :viewsource!.
View image source with;i(or with;Ifor new tab).
Inspect elements with:inspect. Repeat to open in a new window. Disable inspector with:inspect!
The:bookmarkscommand opens the bookmarks page. (Shortcut: gb or gB for new tab).
The:bookmark[URI [tags]]command adds the URI specified (or the current tab's URI, if omitted) to the bookmarks by specified tags.
Many webpages have editable elements like dropdown lists, checkboxes, text fields and so on. While they work perfectly with the mouse, you may encounter some troubles using the follow commands. In such a case, pressing the arrow keys may help. Alternatively, you can use the focus input gi shortcut.

configuration

lualkit is configured by files includes in ~/.config/luakit/*

Homepage: Set your homepage as follows:

globals.lua

globals = {
    homepage = "about:blank",
-- ...
}

Custom search engines: You can virtually add any search engine you want. Make a search on the website you want and copy paste the URI to the Luakit configuration by replacing the searched terms with an %s. Example:

globals.lua

search_engines = {
    aur = "https://aur.archlinux.org/packages.php?O=0&K=%s&do_Search=Go",
-- ...
}

The variable is used as a keyword for the :open command in Luakit.
Set the defaut search engine by using this same keyword:

globals.lua

search_engines.default = search_engines.aur

Download location: This can be specified in rc.lua :

-- Add download support
require "downloads"
require "downloads_chrome"
-- Set download location
downloads.default_dir = os.getenv("HOME") .. "/downloads"
downloads.add_signal("download-location", function (uri, file)
    if not file or file == "" then
        file = (string.match(uri, "/([^/]+)$")
            or string.match(uri, "^%w+://(.+)")
            or string.gsub(uri, "/", "_")
            or "untitled")
    end
    return downloads.default_dir .. "/" .. file
end)

lang fr|gb

luakit browser

Basic usage

Browsing

configuration