Browsing

Opening web pages

o :o :open :open args o

Open a single URL in the current tab, or multiple URLs in the current tab and background tabs. URLs may be separated with urlseparator, in which case the first URL is opened in the current tab and the rest are opened in new background tabs.

Each URL may be one of the following:

  1. A local filename, if it begins with /, ./, or ~/ and the specified file exists.

  2. A search or bookmark keyword, or a search engine name, followed by search arguments.

    :open wikipedia Linus Torvalds

    Search engines can be edited via :dialog searchengines and search keywords may be added by right clicking any search box and selecting Add a Keyword for this Search.

  3. Any search string which does not look like a URL or hostname, which will be passed to the default search engine (see defsearch).

    :open Linus Torvalds
  4. Any other value is passed directly to &dactyl.host; and must be a valid URL or hostname.

:open provides powerful URL completion from several possible sources, which can be adjusted via the complete option.

t :t :tabopen :tabnew :tabopen! args t

Like :open, but all arguments are opened in new tabs. The first new tab is activated if activate contains tabopen or ! is provided.

O O

Open an :open prompt followed by the current URL.

T T

Open a :tabopen prompt followed by the current URL.

s s

Open a search prompt.

 S S

Open a search prompt for a new tab.

 :tabdu :tabduplicate :counttabduplicate!

Duplicates current tab count times. The first new tab is activated if activate contains tabopen or ! is provided.

w :winopen :wopen :winopen! args w

Like :tabopen, but all arguments are opened in a single new window.

When called via :private, the new window is a private browsing window.

W W

Open a :winopen prompt followed by the current URL.

p]]> p

Open (put) a URL based on the current clipboard contents, or, on X11 systems, the currently selected text. All white space is stripped from the selection and it is opened in the same manner as :open.

<tab-open-clipboard-url> P P

Open (put) a URL based on the current clipboard contents in a new buffer. Works like p but opens a new tab. The new tab is activated if activate contains paste.

gP gP

Open (put) a URL based on the current clipboard contents in a new buffer. The new tab is activated if activate does not contain paste.

]]> count<C-x>

Decrements the last number in URL by 1, or by count if given. Negative numbers are not supported as trailing numbers in URLs are often preceded by hyphens.

]]> count<C-a>

Increments the last number in URL by 1, or by count if given.

History

]]> count]]>

Go to an older position in the jump list. If count is specified, jump count positions backward.

]]> count]]>

Go to a newer position in the jump list. If count is specified, jump count positions forward.

:ju :jumps :jumps

Display the jump list. The jump numbers shown are suitable as arguments to or .

H]]> [count]H

Go back in the browser history. If count is specified, go back count pages.

L]]> countL

Go forward in the browser history. If count is specified, go forward count pages.

:ba :back :countback url :countback!

Go back in the browser history. If count is specified, go back count pages.

The special version :back! goes to the beginning of the browser history.

:fw :fo :forward :countforward url :countforward!

Go forward in the browser history. If count is specified, go forward count pages.

The special version :forward! goes to the end of the browser history.

count[d

Go to the countth previous domain in the history stack.

count]d

Go to the countth next domain in the history stack.

:hs :hist :history :history! filter

Show recently visited URLs. Opens the message window at the bottom of the screen with all history items whose page titles or URLs match filter.

The special version :history! works the same as :history except that it opens all matching pages in new tabs rather than listing them.

The pages may also be filtered via the following options,

-max
The maximum number of items to list or open (short name -m).
-sort
The sort order of the results (short name -s).

Navigating

~]]> ~

Open home directory. Equivalent to :open ~/

 gh]]> gh

Go home. Opens the homepage in the current tab.

 gH]]> gH

Go home in a new tab. Opens the homepage in a new tab. The new tab is activated if activate contains homepage.

gu]]> countgu

Go to countth parent directory.

For example, at the URL http://www.example.com/dir1/dir2/file.htm, 2gu opens http://www.example.com/dir1/.

gU]]> gU

Go to the root of the web site.

For example, at the URL http://www.example.com/dir1/dir2/file.htm, gU opens http://www.example.com/.

Reloading

<reload> r r

Reload the current web page.

 <full-reload> R R

Reload the current web page without using the cache.

 :re :reload :reload!

Reload current web page. If ! is given, reload without using the cache.

:reloada :reloadall :reloadall!

Reload all tabs. If ! is given, reload without using the cache.

Stopping

:st :stop]]> <C-c> :stop

Stop loading the current web page.

 :stopa :stopall :stopall

Stop loading all web pages.

Writing

:w :write :sav :saveas :saveas! file

Save current web page to disk. If file is omitted, save to the page's default filename. If file is a directory or ends with your platform's path separator, save to the page's default filename in that directory. Existing documents will only be overwritten if ! is given.

:write >> file

Appends the current web page to the file file. The given file must already exist.

:write !cmd

Writes the current web page to cmd and prints the command's output.

Quitting

ZQ :x :exit :exit!

Quit &dactyl.appName;, no matter how many tabs/windows are open. The session is not stored. Use ! to forcibly quit.

:q :quit :quit

Quit current tab. If this is the last tab in the window, close the window.

:qa :qall :quita :quitall :quitall

Close the current &dactyl.appName; window, no matter how many tabs are open.

:wc :wclose :winc :winclose :winclose

Close the current window.

 :winon :winonly :winonly

Close all windows but the current.

 ZZ :xa :xall :wq :wqa :wqall :wqall :xall

Save the current session and quit.

Unlike Vim, :wq closes the entire window rather than just the current tab.

The current directory

:chd :chdir :cd :cd path

Change the current directory. If path is -, change to the previous directory. If it is omitted, change to the home directory.

:pw :pwd :pwd

Print the current directory name.