Browsing

&liberator.appname; overrides nearly all &liberator.host; keys in order to make browsing more pleasant for Vim users. On the rare occasions when you want to pass a keystroke to &liberator.host;, or to the web page, and have it retain its original meaning you have 2 possibilities: CTRL-Z]]> CTRL-Z

Disable all &liberator.appname; keys except and pass them to the next event handler. This is especially useful if JavaScript controlled forms (e.g., the RichEdit form fields of Gmail) don't work anymore. To exit this mode, press . If you also need to pass in this mode to the web page, prepend it with .

CTRL-V]]> CTRL-V

If you only need to pass a single key to a JavaScript form field or another extension prefix the key with . Also works to unshadow &liberator.host; shortcuts like which are otherwise hidden in &liberator.appname;. When &liberator.appname; mode is temporarily disabled with , will pass the next key to &liberator.appname; instead of the web page.

Opening web pages

o :o :open :open arg1, arg2, … o

Open one or more URLs in the current tab. Multiple URLs can be separated with urlseparator (default: ", " Note that the space after the comma is required.) The first URL is opened in the current tab, and all other URLs are opened in new tabs. Each token is analyzed and in this order:

  1. Opened as a local file if it is an existing relative or absolute filename.
    • :open /etc/fstab shows the file system table.
    • :open ../other/foo.html in your home directory opens /home/other/foo.html
  2. Opened with the specified search engine if the token looks like a search string and the first word is the name of a search engine ( :open wikipedia linus torvalds opens the Wikipedia entry for linus torvalds). The short name of a search engine is automatically guessed from its name. If you want to set a custom name, you can change it with :dialog searchengines.
  3. Opened with the default search engine or keyword (specified with the defsearch option) if the first word is no search engine (:open linus torvalds opens a Google search for linus torvalds).
  4. Passed directly to &liberator.host; in all other cases (:open www.osnews.com, www.slashdot.org opens OSNews in the current, and Slashdot in a new background tab).

You can use :open -tags linux torvalds to complete bookmarks with tag "linux" and which contain "torvalds". Note that -tags support is only available for tab completion, not for the actual command. The items which are completed on are specified in the complete option.

t :t :tabopen :tabnew :tabopen! arg1, arg2, … t

Just like :open but also uses a new tab for the first URL. When used with !, the tabopen value of the activate option is negated.

T T

Show a :tabopen prompt containing the current URL. Useful if you want to go somewhere by editing the URL of the current page.

:tabdu :tabduplicate :counttabduplicate!

Duplicates current tab count times. Uses tabopen value of the activate option to determine if the last cloned tab should be activated. When used with !, tabopen value is negated.

O O

Show an :open prompt containing the current URL. Useful if you want to go somewhere by editing the URL of the current page.

w :winopen :wopen :winopen! arg1, arg2, … w

Just like :tabopen but opens the resulting web page(s) in a new window.

W W

Open one or more URLs in a new window based on current location. Works like w but preselects current URL in the :winopen query.

p]]> p

Open (put) a URL based on the current clipboard contents in the current buffer. You can also just select (for non-X11 users: copy) some non-URL text, and search for it with the default search engine or keyword (specified by the defsearch option) with p.

P P

Open (put) a URL based on the current clipboard contents in a new buffer. Works like p but opens a new tab.

Whether the new buffer is activated, depends on the activate option.

gP gP

Open (put) a URL based on the current clipboard contents in a new buffer. Works like P but inverts the activate option.

]]> count<C-x>

Decrements the last number in URL by 1, or by count if given. Negative numbers are not supported, as this is not generally useful, so the number cannot be decremented past 0.

]]> count<C-a>

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

~ ~

Open home directory. You can also use the hints and have the probably fastest file browser on earth. :)

Navigating

CTRL-O :ba :back]]> :countback url :back! CTRL-o

Go count pages back in the browser history. If url is specified go back to the first matching URL. The special version :back! goes to the beginning of the browser history.

CTRL-i :fo :fw :forward]]> :countforward url :forward! CTRL-i

Go count pages forward in the browser history. If url is specified go forward to the first matching URL. The special version :forward! goes to the end of the browser history.

:ju :jumps :jumps

List all jumps aka current tab's history aka session history.

Current history position is marked with >, jump numbers are counters to be used with :back (above zero record) or :forward (below zero record).

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. Whether the new tab is activated or not depends on the activate option.

gu countgu

Go to countth parent directory.

2gu on http://www.example.com/dir1/dir2/file.htm opens http://www.example.com/dir1/.

gU gU

Go to the root of the web site.

gU on http://www.example.com/dir1/dir2/file.htm opens http://www.example.com/. When browsing a local directory, it goes to the root directory.

Reloading

r r

Force reloading of the current web page.

R R

Force reloading of the current web page skipping the cache.

:re :reload :reload!

Reload current web page. Forces reloading of the current page. If ! is given, skip the cache.

:reloada :reloadall :reloadall!

Reload all pages. Forces reloading of all pages. If ! is given, skip the cache.

Stopping

]]> <C-c>

Stop loading the current web page.

:st :stop :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. Existing documents will only be overwritten if ! is given.

Quitting

:q :quit :quit

Quit current tab. If this is the last tab in the window, close the window. If this was the last window, close &liberator.appname;. When quitting &liberator.appname;, the session is not stored.

:qa :qall :quita :quitall :quitall

Quit &liberator.appname;. Quit &liberator.appname;, no matter how many tabs/windows are open. The session is not stored.

:wc :wclose :winc :winclose :winclose

Close window.

:winon :winonly :winonly

Close all other windows.

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

Save the session and quit. Quit &liberator.appname;, no matter how many tabs/windows are open. The session is stored. :wq is different from Vim, as it closes the window instead of just one tab by popular demand. Complain on the mailing list if you want to change that.

ZQ ZQ

Quit and don't save the session. Works like :qall.

ZZ ZZ

Quit and save the session. Quit &liberator.appname;, no matter how many tabs/windows are open. The session is stored. Works like :xall.

The current directory

:chd :chdir :cd :cd -|path

Change the current directory. :cd - changes to the last directory.

:pw :pwd :pwd

Print the current directory name.