2014-09-07 23:22:38 +02:00
= Commands
== Normal commands
.Quick reference
[options="header",width="75%",cols="25%,75%"]
|==============
|Command|Description
2014-11-24 21:05:09 +01:00
|<<adblock-update,adblock-update>>|Update the adblock block lists.
2014-09-07 23:22:38 +02:00
|<<back,back>>|Go back in the history of the current tab.
2014-09-09 23:13:43 +02:00
|<<bind,bind>>|Bind a key to a command.
2014-10-06 20:46:01 +02:00
|<<close,close>>|Close the current window.
2015-02-09 17:38:50 +01:00
|<<download,download>>|Download a given URL, or current page if no URL given.
|<<download-cancel,download-cancel>>|Cancel the last/[count]th download.
2015-02-12 23:30:31 +01:00
|<<download-delete,download-delete>>|Delete the last/[count]th download from disk.
|<<download-open,download-open>>|Open the last/[count]th download.
|<<download-remove,download-remove>>|Remove the last/[count]th download from the list.
2014-09-07 23:22:38 +02:00
|<<forward,forward>>|Go forward in the history of the current tab.
2014-12-29 22:01:27 +01:00
|<<fullscreen,fullscreen>>|Toggle fullscreen mode.
2014-09-08 06:57:22 +02:00
|<<help,help>>|Show help about a command or setting.
2014-09-07 23:22:38 +02:00
|<<hint,hint>>|Start hinting.
|<<home,home>>|Open main startpage in current tab.
|<<inspector,inspector>>|Toggle the web inspector.
|<<later,later>>|Execute a command after some time.
2014-09-22 21:13:42 +02:00
|<<navigate,navigate>>|Open typical prev/next links or navigate using the URL path.
2014-09-07 23:22:38 +02:00
|<<open,open>>|Open a URL in the current/[count]th tab.
|<<paste,paste>>|Open a page from the clipboard.
|<<print,print>>|Print the current/[count]th tab.
|<<quickmark-add,quickmark-add>>|Add a new quickmark.
2014-12-10 23:30:04 +01:00
|<<quickmark-del,quickmark-del>>|Delete a quickmark.
2014-09-07 23:22:38 +02:00
|<<quickmark-load,quickmark-load>>|Load a quickmark.
|<<quickmark-save,quickmark-save>>|Save the current page as a quickmark.
|<<quit,quit>>|Quit qutebrowser.
|<<reload,reload>>|Reload the current/[count]th tab.
2014-10-08 22:20:57 +02:00
|<<repeat,repeat>>|Repeat a given command.
2014-09-07 23:22:38 +02:00
|<<report,report>>|Report a bug in qutebrowser.
|<<restart,restart>>|Restart qutebrowser while keeping existing tabs open.
2015-01-31 22:56:23 +01:00
|<<save,save>>|Save configs and state.
2015-04-03 14:39:47 +02:00
|<<search,search>>|Search for a text on the current page. With no text, clear results.
2015-02-16 20:26:09 +01:00
|<<session-delete,session-delete>>|Delete a session.
|<<session-load,session-load>>|Load a session.
|<<session-save,session-save>>|Save a session.
2014-09-07 23:22:38 +02:00
|<<set,set>>|Set an option.
|<<set-cmd-text,set-cmd-text>>|Preset the statusbar to some text.
|<<spawn,spawn>>|Spawn a command in a shell.
|<<stop,stop>>|Stop loading in the current/[count]th tab.
2014-09-27 23:14:53 +02:00
|<<tab-clone,tab-clone>>|Duplicate the current tab.
2014-09-07 23:22:38 +02:00
|<<tab-close,tab-close>>|Close the current/[count]th tab.
2015-03-30 12:14:15 +02:00
|<<tab-detach,tab-detach>>|Detach the current tab to its own window.
2014-09-07 23:22:38 +02:00
|<<tab-focus,tab-focus>>|Select the tab given as argument/[count].
|<<tab-move,tab-move>>|Move the current tab.
|<<tab-next,tab-next>>|Switch to the next tab, or switch [count] tabs forward.
|<<tab-only,tab-only>>|Close all tabs except for the current one.
|<<tab-prev,tab-prev>>|Switch to the previous tab, or switch [count] tabs back.
2014-09-09 23:13:43 +02:00
|<<unbind,unbind>>|Unbind a keychain.
2014-09-07 23:22:38 +02:00
|<<undo,undo>>|Re-open a closed tab (optionally skipping [count] closed tabs).
2014-09-22 21:01:58 +02:00
|<<view-source,view-source>>|Show the source of the current page.
2015-02-16 20:26:09 +01:00
|<<wq,wq>>|Save open pages and quit.
2014-09-07 23:22:38 +02:00
|<<yank,yank>>|Yank the current URL/title to the clipboard or primary selection.
|<<zoom,zoom>>|Set the zoom level for the current tab.
|<<zoom-in,zoom-in>>|Increase the zoom level for the current tab.
|<<zoom-out,zoom-out>>|Decrease the zoom level for the current tab.
|==============
2014-11-24 21:05:09 +01:00
[[adblock-update]]
=== adblock-update
Update the adblock block lists.
2014-09-07 23:22:38 +02:00
[[back]]
=== back
2014-10-06 20:46:01 +02:00
Syntax: +:back [*--tab*] [*--bg*] [*--window*]+
2014-09-27 23:14:53 +02:00
2014-09-07 23:22:38 +02:00
Go back in the history of the current tab.
2014-09-27 23:14:53 +02:00
==== optional arguments
* +*-t*+, +*--tab*+: Go back in a new tab.
* +*-b*+, +*--bg*+: Go back in a background tab.
2014-10-06 20:46:01 +02:00
* +*-w*+, +*--window*+: Go back in a new window.
2014-09-27 23:14:53 +02:00
2014-09-13 00:33:15 +02:00
==== count
How many pages to go back.
2014-09-09 23:13:43 +02:00
[[bind]]
=== bind
2015-03-10 23:25:37 +01:00
Syntax: +:bind [*--mode* 'MODE'] [*--force*] 'key' 'command'+
2014-09-09 23:13:43 +02:00
Bind a key to a command.
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'key'+: The keychain or special key (inside `<...>`) to bind.
2014-09-14 23:11:11 +02:00
* +'command'+: The command to execute, with optional args.
2014-09-14 23:25:56 +02:00
==== optional arguments
* +*-m*+, +*--mode*+: A comma-separated list of modes to bind the key in (default: `normal`).
2014-09-09 23:13:43 +02:00
2015-03-10 23:25:37 +01:00
* +*-f*+, +*--force*+: Rebind the key if it is already bound.
2014-09-09 23:13:43 +02:00
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-10-06 20:46:01 +02:00
[[close]]
=== close
Close the current window.
2014-11-20 06:25:01 +01:00
[[download]]
=== download
2015-02-09 17:38:50 +01:00
Syntax: +:download ['url'] ['dest']+
2014-11-20 06:25:01 +01:00
2015-02-09 17:38:50 +01:00
Download a given URL, or current page if no URL given.
2014-11-20 06:25:01 +01:00
==== positional arguments
2015-02-09 17:38:50 +01:00
* +'url'+: The URL to download. If not given, download the current page.
2015-02-14 19:41:10 +01:00
* +'dest'+: The file path to write the download to, or not given to ask.
2014-11-20 06:25:01 +01:00
2015-02-09 17:38:50 +01:00
[[download-cancel]]
=== download-cancel
Cancel the last/[count]th download.
==== count
The index of the download to cancel.
2015-02-12 23:30:31 +01:00
[[download-delete]]
=== download-delete
Delete the last/[count]th download from disk.
==== count
The index of the download to cancel.
2015-02-09 17:38:50 +01:00
[[download-open]]
=== download-open
2015-02-12 23:30:31 +01:00
Open the last/[count]th download.
2015-02-09 17:38:50 +01:00
==== count
The index of the download to cancel.
[[download-remove]]
=== download-remove
Syntax: +:download-remove [*--all*]+
2015-02-12 23:30:31 +01:00
Remove the last/[count]th download from the list.
2015-02-09 17:38:50 +01:00
==== optional arguments
* +*-a*+, +*--all*+: If given removes all finished downloads.
==== count
The index of the download to cancel.
2014-09-07 23:22:38 +02:00
[[forward]]
=== forward
2014-10-06 20:46:01 +02:00
Syntax: +:forward [*--tab*] [*--bg*] [*--window*]+
2014-09-27 23:14:53 +02:00
2014-09-07 23:22:38 +02:00
Go forward in the history of the current tab.
2014-09-27 23:14:53 +02:00
==== optional arguments
* +*-t*+, +*--tab*+: Go forward in a new tab.
2014-10-06 20:46:01 +02:00
* +*-b*+, +*--bg*+: Go forward in a background tab.
* +*-w*+, +*--window*+: Go forward in a new window.
2014-09-27 23:14:53 +02:00
2014-09-13 00:33:15 +02:00
==== count
How many pages to go forward.
2014-12-29 22:01:27 +01:00
[[fullscreen]]
=== fullscreen
Toggle fullscreen mode.
2014-09-08 06:57:22 +02:00
[[help]]
=== help
2014-10-06 20:46:01 +02:00
Syntax: +:help [*--tab*] [*--bg*] [*--window*] ['topic']+
2014-09-08 06:57:22 +02:00
Show help about a command or setting.
==== positional arguments
* +'topic'+: The topic to show help for.
- :__command__ for commands.
- __section__\->__option__ for settings.
2014-10-06 20:46:01 +02:00
==== optional arguments
* +*-t*+, +*--tab*+: Open in a new tab.
* +*-b*+, +*--bg*+: Open in a background tab.
* +*-w*+, +*--window*+: Open in a new window.
2014-09-07 23:22:38 +02:00
[[hint]]
=== hint
2015-03-10 19:40:30 +01:00
Syntax: +:hint [*--rapid*] ['group'] ['target'] ['args' ['args' ...]]+
2014-09-07 23:22:38 +02:00
Start hinting.
==== positional arguments
* +'group'+: The hinting mode to use.
- `all`: All clickable elements.
- `links`: Only links.
- `images`: Only images.
* +'target'+: What to do with the selected element.
- `normal`: Open the link in the current tab.
- `tab`: Open the link in a new tab.
- `tab-bg`: Open the link in a new background tab.
2014-10-06 20:46:01 +02:00
- `window`: Open the link in a new window.
2014-11-01 00:54:19 +01:00
- `hover` : Hover over the link.
2014-09-07 23:22:38 +02:00
- `yank`: Yank the link to the clipboard.
- `yank-primary`: Yank the link to the primary selection.
2014-12-13 00:35:39 +01:00
- `run`: Run the argument as command.
2014-09-07 23:22:38 +02:00
- `fill`: Fill the commandline with the command given as
argument.
- `download`: Download the link.
- `userscript`: Call an userscript with `$QUTE_URL` set to the
link.
- `spawn`: Spawn a command.
2014-12-13 00:35:39 +01:00
* +'args'+: Arguments for spawn/userscript/run/fill.
2014-09-07 23:22:38 +02:00
- With `spawn`: The executable and arguments to spawn.
`{hint-url}` will get replaced by the selected
URL.
- With `userscript`: The userscript to execute.
- With `fill`: The command to fill the statusbar with.
`{hint-url}` will get replaced by the selected
URL.
2014-12-13 00:35:39 +01:00
- With `run`: Same as `fill`.
2014-09-07 23:22:38 +02:00
2015-03-10 19:40:30 +01:00
==== optional arguments
* +*-r*+, +*--rapid*+: Whether to do rapid hinting. This is only possible with targets `tab-bg`, `window`, `run`, `hover`, `userscript` and
`spawn`.
2014-09-07 23:22:38 +02:00
[[home]]
=== home
Open main startpage in current tab.
[[inspector]]
=== inspector
Toggle the web inspector.
[[later]]
=== later
2014-12-11 21:28:09 +01:00
Syntax: +:later 'ms' 'command'+
2014-09-07 23:22:38 +02:00
Execute a command after some time.
==== positional arguments
* +'ms'+: How many milliseconds to wait.
2014-09-14 23:11:11 +02:00
* +'command'+: The command to run, with optional args.
2014-09-07 23:22:38 +02:00
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-22 21:01:58 +02:00
[[navigate]]
=== navigate
2014-10-06 20:46:01 +02:00
Syntax: +:navigate [*--tab*] [*--bg*] [*--window*] 'where'+
2014-09-22 21:01:58 +02:00
2014-09-22 21:13:42 +02:00
Open typical prev/next links or navigate using the URL path.
2014-09-22 21:01:58 +02:00
2014-09-22 21:13:42 +02:00
This tries to automatically click on typical _Previous Page_ or _Next Page_ links using some heuristics. Alternatively it can navigate by changing the current URL.
2014-09-22 21:01:58 +02:00
==== positional arguments
* +'where'+: What to open.
- `prev`: Open a _previous_ link.
- `next`: Open a _next_ link.
2014-09-22 21:13:42 +02:00
- `up`: Go up a level in the current URL.
2014-09-22 21:51:09 +02:00
- `increment`: Increment the last number in the URL.
- `decrement`: Decrement the last number in the URL.
2014-09-22 21:01:58 +02:00
2014-09-07 23:22:38 +02:00
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-t*+, +*--tab*+: Open in a new tab.
2014-10-06 20:46:01 +02:00
* +*-b*+, +*--bg*+: Open in a background tab.
* +*-w*+, +*--window*+: Open in a new window.
2014-09-07 23:22:38 +02:00
[[open]]
=== open
2015-02-27 08:10:00 +01:00
Syntax: +:open [*--bg*] [*--tab*] [*--window*] ['url']+
2014-09-07 23:22:38 +02:00
Open a URL in the current/[count]th tab.
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'url'+: The URL to open.
2014-09-07 23:22:38 +02:00
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-b*+, +*--bg*+: Open in a new background tab.
* +*-t*+, +*--tab*+: Open in a new tab.
2014-10-06 20:46:01 +02:00
* +*-w*+, +*--window*+: Open in a new window.
2014-09-07 23:22:38 +02:00
2014-09-13 00:33:15 +02:00
==== count
2014-09-13 00:37:07 +02:00
The tab index to open the URL in.
2014-09-13 00:33:15 +02:00
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-07 23:22:38 +02:00
[[paste]]
=== paste
2014-10-06 20:46:01 +02:00
Syntax: +:paste [*--sel*] [*--tab*] [*--bg*] [*--window*]+
2014-09-07 23:22:38 +02:00
Open a page from the clipboard.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-s*+, +*--sel*+: Use the primary selection instead of the clipboard.
* +*-t*+, +*--tab*+: Open in a new tab.
* +*-b*+, +*--bg*+: Open in a background tab.
2014-10-06 20:46:01 +02:00
* +*-w*+, +*--window*+: Open in new window.
2014-09-07 23:22:38 +02:00
[[print]]
=== print
Syntax: +:print [*--preview*]+
Print the current/[count]th tab.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-p*+, +*--preview*+: Show preview instead of printing.
2014-09-07 23:22:38 +02:00
2014-09-13 00:33:15 +02:00
==== count
2014-09-13 00:37:07 +02:00
The tab index to print.
2014-09-13 00:33:15 +02:00
2014-09-07 23:22:38 +02:00
[[quickmark-add]]
=== quickmark-add
2014-09-13 00:22:27 +02:00
Syntax: +:quickmark-add 'url' 'name'+
2014-09-07 23:22:38 +02:00
Add a new quickmark.
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'url'+: The url to add as quickmark.
2014-09-07 23:22:38 +02:00
* +'name'+: The name for the new quickmark.
2014-12-10 23:30:04 +01:00
[[quickmark-del]]
=== quickmark-del
Syntax: +:quickmark-del 'name'+
Delete a quickmark.
==== positional arguments
* +'name'+: The name of the quickmark to delete.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-07 23:22:38 +02:00
[[quickmark-load]]
=== quickmark-load
2014-10-06 20:46:01 +02:00
Syntax: +:quickmark-load [*--tab*] [*--bg*] [*--window*] 'name'+
2014-09-07 23:22:38 +02:00
Load a quickmark.
==== positional arguments
* +'name'+: The name of the quickmark to load.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-t*+, +*--tab*+: Load the quickmark in a new tab.
* +*-b*+, +*--bg*+: Load the quickmark in a new background tab.
2014-10-06 20:46:01 +02:00
* +*-w*+, +*--window*+: Load the quickmark in a new window.
2014-09-07 23:22:38 +02:00
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-07 23:22:38 +02:00
[[quickmark-save]]
=== quickmark-save
Save the current page as a quickmark.
[[quit]]
=== quit
Quit qutebrowser.
[[reload]]
=== reload
2014-12-29 22:04:22 +01:00
Syntax: +:reload [*--force*]+
2014-09-07 23:22:38 +02:00
Reload the current/[count]th tab.
2014-12-29 22:04:22 +01:00
==== optional arguments
* +*-f*+, +*--force*+: Bypass the page cache.
2014-09-13 00:33:15 +02:00
==== count
2014-09-13 00:37:07 +02:00
The tab index to reload.
2014-09-13 00:33:15 +02:00
2014-10-08 22:20:57 +02:00
[[repeat]]
=== repeat
2014-12-11 21:28:09 +01:00
Syntax: +:repeat 'times' 'command'+
2014-10-08 22:20:57 +02:00
Repeat a given command.
==== positional arguments
* +'times'+: How many times to repeat.
* +'command'+: The command to run, with optional args.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-07 23:22:38 +02:00
[[report]]
=== report
Report a bug in qutebrowser.
[[restart]]
=== restart
Restart qutebrowser while keeping existing tabs open.
[[save]]
=== save
2015-01-31 22:56:23 +01:00
Syntax: +:save ['what' ['what' ...]]+
Save configs and state.
==== positional arguments
* +'what'+: What to save (`config`/`key-config`/`cookies`/...). If not given, everything is saved.
2014-09-07 23:22:38 +02:00
2014-12-29 22:45:26 +01:00
[[search]]
=== search
2015-04-03 14:39:47 +02:00
Syntax: +:search [*--reverse*] ['text']+
2014-12-29 22:45:26 +01:00
2015-04-03 14:39:47 +02:00
Search for a text on the current page. With no text, clear results.
2014-12-29 22:45:26 +01:00
==== positional arguments
* +'text'+: The text to search for.
==== optional arguments
* +*-r*+, +*--reverse*+: Reverse search direction.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2015-02-16 20:26:09 +01:00
[[session-delete]]
=== session-delete
2015-04-01 22:30:46 +02:00
Syntax: +:session-delete [*--force*] 'name'+
2015-02-16 20:26:09 +01:00
Delete a session.
==== positional arguments
* +'name'+: The name of the session.
2015-04-01 22:30:46 +02:00
==== optional arguments
* +*-f*+, +*--force*+: Force deleting internal sessions (starting with an underline).
2015-02-16 20:26:09 +01:00
[[session-load]]
=== session-load
2015-04-05 16:06:41 +02:00
Syntax: +:session-load [*--clear*] [*--temp*] [*--force*] 'name'+
2015-02-16 20:26:09 +01:00
Load a session.
==== positional arguments
* +'name'+: The name of the session.
2015-03-30 07:09:16 +02:00
==== optional arguments
* +*-c*+, +*--clear*+: Close all existing windows.
2015-04-05 16:06:41 +02:00
* +*-t*+, +*--temp*+: Don't set the current session for :session-save.
2015-04-01 22:30:46 +02:00
* +*-f*+, +*--force*+: Force loading internal sessions (starting with an underline).
2015-03-30 07:09:16 +02:00
2015-02-16 20:26:09 +01:00
[[session-save]]
=== session-save
2015-04-05 16:04:03 +02:00
Syntax: +:session-save [*--current*] [*--quiet*] [*--force*] ['name']+
2015-02-16 20:26:09 +01:00
Save a session.
==== positional arguments
2015-04-05 23:30:43 +02:00
* +'name'+: The name of the session. If not given, the session configured in general -> session-default-name is saved.
2015-02-16 20:26:09 +01:00
2015-03-30 07:03:14 +02:00
==== optional arguments
2015-04-05 16:04:03 +02:00
* +*-c*+, +*--current*+: Save the current session instead of the default.
2015-03-30 07:03:14 +02:00
* +*-q*+, +*--quiet*+: Don't show confirmation message.
2015-04-01 22:30:46 +02:00
* +*-f*+, +*--force*+: Force saving internal sessions (starting with an underline).
2015-03-30 07:03:14 +02:00
2014-09-07 23:22:38 +02:00
[[set]]
=== set
2015-02-05 08:29:33 +01:00
Syntax: +:set [*--temp*] [*--print*] ['section'] ['option'] ['value']+
2014-09-07 23:22:38 +02:00
Set an option.
2015-01-24 18:10:45 +01:00
If the option name ends with '?', the value of the option is shown instead. If the option name ends with '!' and it is a boolean value, toggle it.
2014-09-15 06:24:15 +02:00
2014-09-07 23:22:38 +02:00
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'section'+: The section where the option is in.
* +'option'+: The name of the option.
2014-09-07 23:22:38 +02:00
* +'value'+: The value to set.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-t*+, +*--temp*+: Set value temporarily.
2015-02-05 08:29:33 +01:00
* +*-p*+, +*--print*+: Print the value after setting.
2014-09-07 23:22:38 +02:00
[[set-cmd-text]]
=== set-cmd-text
2015-04-03 17:10:14 +02:00
Syntax: +:set-cmd-text [*--space*] 'text'+
2014-09-07 23:22:38 +02:00
Preset the statusbar to some text.
==== positional arguments
* +'text'+: The commandline to set.
2015-04-03 17:10:14 +02:00
==== optional arguments
* +*-s*+, +*--space*+: If given, a space is added to the end.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2014-09-07 23:22:38 +02:00
[[spawn]]
=== spawn
2015-01-15 22:28:04 +01:00
Syntax: +:spawn [*--userscript*] 'args' ['args' ...]+
2014-09-07 23:22:38 +02:00
Spawn a command in a shell.
Note the {url} variable which gets replaced by the current URL might be useful here.
==== positional arguments
* +'args'+: The commandline to execute.
2015-01-15 22:28:04 +01:00
==== optional arguments
* +*-u*+, +*--userscript*+: Run the command as an userscript.
2014-09-07 23:22:38 +02:00
[[stop]]
=== stop
Stop loading in the current/[count]th tab.
2014-09-13 00:33:15 +02:00
==== count
2014-09-13 00:37:07 +02:00
The tab index to stop.
2014-09-13 00:33:15 +02:00
2014-09-27 23:14:53 +02:00
[[tab-clone]]
=== tab-clone
2014-10-06 20:46:01 +02:00
Syntax: +:tab-clone [*--bg*] [*--window*]+
2014-09-27 23:14:53 +02:00
Duplicate the current tab.
==== optional arguments
* +*-b*+, +*--bg*+: Open in a background tab.
2014-10-06 20:46:01 +02:00
* +*-w*+, +*--window*+: Open in a new window.
2014-09-27 23:14:53 +02:00
2014-09-07 23:22:38 +02:00
[[tab-close]]
=== tab-close
2014-10-07 20:30:31 +02:00
Syntax: +:tab-close [*--left*] [*--right*] [*--opposite*]+
2014-09-07 23:22:38 +02:00
Close the current/[count]th tab.
2014-10-07 20:30:31 +02:00
==== optional arguments
* +*-l*+, +*--left*+: Force selecting the tab to the left of the current tab.
* +*-r*+, +*--right*+: Force selecting the tab to the right of the current tab.
2015-03-31 20:49:29 +02:00
* +*-o*+, +*--opposite*+: Force selecting the tab in the opposite direction of what's configured in 'tabs->select-on-remove'.
2014-10-07 20:30:31 +02:00
2014-09-13 00:33:15 +02:00
==== count
2014-09-13 00:37:07 +02:00
The tab index to close
2014-09-13 00:33:15 +02:00
2015-03-30 12:14:15 +02:00
[[tab-detach]]
=== tab-detach
Detach the current tab to its own window.
2014-09-07 23:22:38 +02:00
[[tab-focus]]
=== tab-focus
Syntax: +:tab-focus ['index']+
Select the tab given as argument/[count].
==== positional arguments
* +'index'+: The tab index to focus, starting with 1. The special value `last` focuses the last focused tab.
2014-09-13 00:33:15 +02:00
==== count
The tab index to focus, starting with 1.
2014-09-07 23:22:38 +02:00
[[tab-move]]
=== tab-move
Syntax: +:tab-move ['direction']+
Move the current tab.
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'direction'+: `+` or `-` for relative moving, not given for absolute moving.
2014-09-07 23:22:38 +02:00
2014-09-13 00:33:15 +02:00
==== count
If moving absolutely: New position (default: 0) If moving relatively: Offset.
2014-09-07 23:22:38 +02:00
[[tab-next]]
=== tab-next
Switch to the next tab, or switch [count] tabs forward.
2014-09-13 00:33:15 +02:00
==== count
How many tabs to switch forward.
2014-09-07 23:22:38 +02:00
[[tab-only]]
=== tab-only
2014-10-08 22:20:57 +02:00
Syntax: +:tab-only [*--left*] [*--right*]+
2014-09-07 23:22:38 +02:00
Close all tabs except for the current one.
2014-10-08 22:20:57 +02:00
==== optional arguments
* +*-l*+, +*--left*+: Keep tabs to the left of the current.
* +*-r*+, +*--right*+: Keep tabs to the right of the current.
2014-09-07 23:22:38 +02:00
[[tab-prev]]
=== tab-prev
Switch to the previous tab, or switch [count] tabs back.
2014-09-13 00:33:15 +02:00
==== count
How many tabs to switch back.
2014-09-09 23:13:43 +02:00
[[unbind]]
=== unbind
Syntax: +:unbind 'key' ['mode']+
Unbind a keychain.
==== positional arguments
2014-09-13 00:22:27 +02:00
* +'key'+: The keychain or special key (inside <...>) to unbind.
* +'mode'+: A comma-separated list of modes to unbind the key in (default: `normal`).
2014-09-09 23:13:43 +02:00
2014-09-07 23:22:38 +02:00
[[undo]]
=== undo
Re-open a closed tab (optionally skipping [count] closed tabs).
2014-09-22 21:01:58 +02:00
[[view-source]]
=== view-source
Show the source of the current page.
2015-02-16 20:26:09 +01:00
[[wq]]
=== wq
Syntax: +:wq ['name']+
Save open pages and quit.
==== positional arguments
* +'name'+: The name of the session.
2014-09-07 23:22:38 +02:00
[[yank]]
=== yank
Syntax: +:yank [*--title*] [*--sel*]+
Yank the current URL/title to the clipboard or primary selection.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-t*+, +*--title*+: Yank the title instead of the URL.
* +*-s*+, +*--sel*+: Use the primary selection instead of the clipboard.
2014-09-07 23:22:38 +02:00
[[zoom]]
=== zoom
Syntax: +:zoom ['zoom']+
Set the zoom level for the current tab.
2014-12-22 18:04:28 +01:00
The zoom can be given as argument or as [count]. If neither of both is given, the zoom is set to the default zoom.
2014-09-07 23:22:38 +02:00
==== positional arguments
* +'zoom'+: The zoom percentage to set.
2014-09-13 00:33:15 +02:00
==== count
The zoom percentage to set.
2014-09-07 23:22:38 +02:00
[[zoom-in]]
=== zoom-in
Increase the zoom level for the current tab.
2014-09-13 00:33:15 +02:00
==== count
How many steps to zoom in.
2014-09-07 23:22:38 +02:00
[[zoom-out]]
=== zoom-out
Decrease the zoom level for the current tab.
2014-09-13 00:33:15 +02:00
==== count
How many steps to zoom out.
2014-09-07 23:22:38 +02:00
== Hidden commands
.Quick reference
[options="header",width="75%",cols="25%,75%"]
|==============
|Command|Description
|<<command-accept,command-accept>>|Execute the command currently in the commandline.
|<<command-history-next,command-history-next>>|Go forward in the commandline history.
|<<command-history-prev,command-history-prev>>|Go back in the commandline history.
|<<completion-item-next,completion-item-next>>|Select the next completion item.
|<<completion-item-prev,completion-item-prev>>|Select the previous completion item.
|<<enter-mode,enter-mode>>|Enter a key mode.
|<<follow-hint,follow-hint>>|Follow the currently selected hint.
|<<leave-mode,leave-mode>>|Leave the mode we're currently in.
|<<open-editor,open-editor>>|Open an external editor with the currently selected form field.
|<<prompt-accept,prompt-accept>>|Accept the current prompt.
|<<prompt-no,prompt-no>>|Answer no to a yes/no prompt.
|<<prompt-yes,prompt-yes>>|Answer yes to a yes/no prompt.
|<<rl-backward-char,rl-backward-char>>|Move back a character.
|<<rl-backward-delete-char,rl-backward-delete-char>>|Delete the character before the cursor.
|<<rl-backward-word,rl-backward-word>>|Move back to the start of the current or previous word.
|<<rl-beginning-of-line,rl-beginning-of-line>>|Move to the start of the line.
|<<rl-delete-char,rl-delete-char>>|Delete the character after the cursor.
|<<rl-end-of-line,rl-end-of-line>>|Move to the end of the line.
|<<rl-forward-char,rl-forward-char>>|Move forward a character.
|<<rl-forward-word,rl-forward-word>>|Move forward to the end of the next word.
|<<rl-kill-line,rl-kill-line>>|Remove chars from the cursor to the end of the line.
|<<rl-kill-word,rl-kill-word>>|Remove chars from the cursor to the end of the current word.
|<<rl-unix-line-discard,rl-unix-line-discard>>|Remove chars backward from the cursor to the beginning of the line.
|<<rl-unix-word-rubout,rl-unix-word-rubout>>|Remove chars from the cursor to the beginning of the word.
|<<rl-yank,rl-yank>>|Paste the most recently deleted text.
|<<scroll,scroll>>|Scroll the current tab by 'count * dx/dy'.
|<<scroll-page,scroll-page>>|Scroll the frame page-wise.
|<<scroll-perc,scroll-perc>>|Scroll to a specific percentage of the page.
|<<search-next,search-next>>|Continue the search to the ([count]th) next term.
|<<search-prev,search-prev>>|Continue the search to the ([count]th) previous term.
|==============
[[command-accept]]
=== command-accept
Execute the command currently in the commandline.
[[command-history-next]]
=== command-history-next
Go forward in the commandline history.
[[command-history-prev]]
=== command-history-prev
Go back in the commandline history.
[[completion-item-next]]
=== completion-item-next
Select the next completion item.
[[completion-item-prev]]
=== completion-item-prev
Select the previous completion item.
[[enter-mode]]
=== enter-mode
Syntax: +:enter-mode 'mode'+
Enter a key mode.
==== positional arguments
* +'mode'+: The mode to enter.
[[follow-hint]]
=== follow-hint
Follow the currently selected hint.
[[leave-mode]]
=== leave-mode
Leave the mode we're currently in.
[[open-editor]]
=== open-editor
Open an external editor with the currently selected form field.
The editor which should be launched can be configured via the `general -> editor` config option.
[[prompt-accept]]
=== prompt-accept
Accept the current prompt.
[[prompt-no]]
=== prompt-no
Answer no to a yes/no prompt.
[[prompt-yes]]
=== prompt-yes
Answer yes to a yes/no prompt.
[[rl-backward-char]]
=== rl-backward-char
Move back a character.
This acts like readline's backward-char.
[[rl-backward-delete-char]]
=== rl-backward-delete-char
Delete the character before the cursor.
This acts like readline's backward-delete-char.
[[rl-backward-word]]
=== rl-backward-word
Move back to the start of the current or previous word.
This acts like readline's backward-word.
[[rl-beginning-of-line]]
=== rl-beginning-of-line
Move to the start of the line.
This acts like readline's beginning-of-line.
[[rl-delete-char]]
=== rl-delete-char
Delete the character after the cursor.
This acts like readline's delete-char.
[[rl-end-of-line]]
=== rl-end-of-line
Move to the end of the line.
This acts like readline's end-of-line.
[[rl-forward-char]]
=== rl-forward-char
Move forward a character.
This acts like readline's forward-char.
[[rl-forward-word]]
=== rl-forward-word
Move forward to the end of the next word.
This acts like readline's forward-word.
[[rl-kill-line]]
=== rl-kill-line
Remove chars from the cursor to the end of the line.
This acts like readline's kill-line.
[[rl-kill-word]]
=== rl-kill-word
Remove chars from the cursor to the end of the current word.
This acts like readline's kill-word.
[[rl-unix-line-discard]]
=== rl-unix-line-discard
Remove chars backward from the cursor to the beginning of the line.
This acts like readline's unix-line-discard.
[[rl-unix-word-rubout]]
=== rl-unix-word-rubout
Remove chars from the cursor to the beginning of the word.
This acts like readline's unix-word-rubout.
[[rl-yank]]
=== rl-yank
Paste the most recently deleted text.
This acts like readline's yank.
[[scroll]]
=== scroll
Syntax: +:scroll 'dx' 'dy'+
Scroll the current tab by 'count * dx/dy'.
==== positional arguments
* +'dx'+: How much to scroll in x-direction.
* +'dy'+: How much to scroll in x-direction.
2014-09-13 00:33:15 +02:00
==== count
multiplier
2014-09-07 23:22:38 +02:00
[[scroll-page]]
=== scroll-page
Syntax: +:scroll-page 'x' 'y'+
Scroll the frame page-wise.
==== positional arguments
* +'x'+: How many pages to scroll to the right.
* +'y'+: How many pages to scroll down.
2014-09-13 00:33:15 +02:00
==== count
multiplier
2014-09-07 23:22:38 +02:00
[[scroll-perc]]
=== scroll-perc
Syntax: +:scroll-perc [*--horizontal*] ['perc']+
Scroll to a specific percentage of the page.
The percentage can be given either as argument or as count. If no percentage is given, the page is scrolled to the end.
==== positional arguments
* +'perc'+: Percentage to scroll.
==== optional arguments
2014-09-13 00:22:27 +02:00
* +*-x*+, +*--horizontal*+: Scroll horizontally instead of vertically.
2014-09-07 23:22:38 +02:00
2014-09-13 00:33:15 +02:00
==== count
Percentage to scroll.
2014-09-07 23:22:38 +02:00
[[search-next]]
=== search-next
Continue the search to the ([count]th) next term.
2014-09-13 00:33:15 +02:00
==== count
How many elements to ignore.
2014-09-07 23:22:38 +02:00
[[search-prev]]
=== search-prev
Continue the search to the ([count]th) previous term.
2014-09-13 00:33:15 +02:00
==== count
How many elements to ignore.
2014-09-07 23:22:38 +02:00
== Debugging commands
These commands are mainly intended for debugging. They are hidden if qutebrowser was started without the `--debug`-flag.
.Quick reference
[options="header",width="75%",cols="25%,75%"]
|==============
|Command|Description
|<<debug-all-objects,debug-all-objects>>|Print a list of all objects to the debug log.
|<<debug-cache-stats,debug-cache-stats>>|Print LRU cache stats.
|<<debug-console,debug-console>>|Show the debugging console.
|<<debug-crash,debug-crash>>|Crash for debugging purposes.
2015-03-31 22:14:35 +02:00
|<<debug-pyeval,debug-pyeval>>|Evaluate a python string and display the results as a web page.
|<<debug-trace,debug-trace>>|Trace executed code via hunter.
2014-09-07 23:22:38 +02:00
|==============
[[debug-all-objects]]
=== debug-all-objects
Print a list of all objects to the debug log.
[[debug-cache-stats]]
=== debug-cache-stats
Print LRU cache stats.
[[debug-console]]
=== debug-console
Show the debugging console.
[[debug-crash]]
=== debug-crash
Syntax: +:debug-crash ['typ']+
Crash for debugging purposes.
==== positional arguments
* +'typ'+: either 'exception' or 'segfault'.
[[debug-pyeval]]
=== debug-pyeval
Syntax: +:debug-pyeval 's'+
2015-03-31 22:14:35 +02:00
Evaluate a python string and display the results as a web page.
2014-09-07 23:22:38 +02:00
==== positional arguments
* +'s'+: The string to evaluate.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.
2015-03-31 22:14:35 +02:00
[[debug-trace]]
=== debug-trace
Syntax: +:debug-trace ['expr']+
Trace executed code via hunter.
==== positional arguments
* +'expr'+: What to trace, passed to hunter.
2015-04-06 17:32:33 +02:00
==== note
* This command does not split arguments after the last argument and handles quotes literally.
* With this command, +;;+ is interpreted literally instead of splitting off a second command.