w3m MANUAL
Akinori Ito
aito@ei5sun.yz.yamagata-u.ac.jp
Introduction
w3m is a pager/text-based WWW browser. You can browse local documents and/or
documents on the WWW using a terminal emulator.
Options
Command line usage is
w3m [options] [file|URL]
If you specify filenames/URLs on command line, these documents are displayed.
If you specify nothing, w3m reads a document from standard input and display it.
If no filename and/or URLs are specified and standard input is tty, w3m terminates
without displaying anything.
Options are as follows:
- +<line number>
- Move to the specified line.
- -t width
- Specify tab width. Default is 8.
- -r
- When displaying text/plain document, prohibit emphasis using backspace.
If you don't specify this option,
``A^H_'' is interpreted as underlined character and ``A^HA'' as a bold character.
- -l number
- Specify line number preserved internally when reading text/plain document
fron standard input. Default is 10000.
- -s
- Display documents with Shift_JIS code.
- -e
- Display documents with EUC_JP code.
- -j
- Display documents with ISO-2022-JP code.
- -T type
- Specify document type. Without this option, document type
is determined from extension of a file. If the determination
fails, the document is regarded as text/plain.
Example:
Read HTML document from standard input and display it
cat hoge.html | w3m -T text/html
Display HTML source
w3m -T text/plain hoge.html
- -m
- Display document with Internet message mode.
With this option, w3m determines document type from header infomation.
It is useful when reading E-mail or NetNews messages.
- -B
- Show the bookmark.
- -M
- Monochrome display mode.
- -F
- Automatically render frame.
- -num
- Show linenumber.
- -dump
- Read document specified by URL and dump formatted text into standard
output. The width of the document become 80. This width can be overridden
with -cols option.
- -cols width
- Specify document width. Used with -dump option.
- -dump_source
- Read document specified by URL and dump the source.
- -no-proxy
- Don't use proxy server.
- -no-mouse
- Don't activate mouse.
Document color
Links and images are displayed as follows.
| | Color mode | Monochrome mode |
|---|
| links | blue | underline |
| inline images | green | reverse |
| form input | red | reverse |
These colors can be customized using option setting command "o".
Key binding
After invocation, you can operate w3m by one-character commands from
the keyboard.
Here's the original key-binding table. If you are using Lynx-like key
bindings, see here.
Page/Cursor motion
| SPC,C-v | Forward page
|
| b,ESC v | Backward page
|
| l,C-f | Cursor right
|
| h,C-b | Cursor left
|
| j,C-n | Cursor down
|
| k,C-p | Cursor up
|
| J | Roll up one line
|
| K | Roll down one line
|
| > | Shift screen right
|
| < | Shift screen left
|
| . | Shift screen one column right
|
| , | Shift screen one column left
|
| g | Go to the first line
|
| G | Go to the last line
|
| ESC g | Go to specified line
|
| TAB | Move to next hyperlink
|
| ESC TAB | Move to previous hyperlink
|
Hyperlink operation
| RET | Follow hyperlink
|
| a, ESC RET | Save link to file
|
| u | Peek link URL
|
| I | View inline image
|
| ESC I | Save inline image to file
|
| : | Mark URL-like strings as anchors
|
| ESC : | Mark Message-ID-like strings as news anchors
|
| c | Peek current URL
|
| = | Display infomation about current document
|
| F | Render frame
|
| M | Browse current document using external browser
(use 2M and 3M to invoke second and third browser)
|
| ESC M | Browse link using external browser
(use 2ESC M and 3ESC M to invoke second and third browser)
|
File/Stream operation
| U | Open URL
|
| V | View new file
|
| @ | Execute shell command and load
|
| # | Execute shell command and browse
|
Buffer operation
| B | Back to the previous buffer
|
| v | View HTML source
|
| s | Select buffer
|
| E | Edit buffer source
|
| R | Reload buffer
|
| S | Save buffer
|
| ESC s | Save source
|
| ESC e | Edit buffer image
|
Bookmark operation
| ESC b | Load bookmark
|
| ESC a | Add current to bookmark
|
Search
| /,C-s | Search forward
|
| ?,C-r | Search backward
|
| n | Search next
|
Mark operation
| C-SPC | Set/unset mark
|
| P | Go to previous mark
|
| N | Go to next mark
|
| " | Mark by regular expression
|
Miscellany
| ! | Execute shell command
|
| H | Help (load this file)
|
| o | Set option
|
| C-c | Stop
|
| q | Quit (with confirmation, if you like)
|
| Q | Quit without confirmation
|
Line-edit mode
| C-f | Move cursor forward
|
| C-b | Move cursor backward
|
| C-h | Delete previous character
|
| C-d | Delete current character
|
| C-k | Kill everything after cursor
|
| C-u | Kill everything before cursor
|
| C-a | Move to the top of line
|
| C-e | Move to the bottom of line
|
| SPC | Complete filename
|
| RETURN | Accept
|