w3m - a text based Web browser and pager


w3m [options] [URL or filename]

Use "w3m -h" to display a complete list of current options.


.I w3m is a World Wide Web (WWW) text based client. It has English and Japanese help files and an option menu and can be configured to use either language. It will display hypertext markup language (HTML) documents containing links to files residing on the local system, as well as files residing on remote systems. It can display HTML tables and frames. In addition, it can be used as a "pager" in much the same manner as "more" or "less". Current versions of .I w3m run on Unix (Solaris, SunOS, HP-UX, Linux, FreeBSD, and EWS4800) and on Microsoft Windows 9x/NT.


At start up, w3m will load any local file or remote URL specified at the command line. For help with runtime options, press "H" while running w3m. Command line options are:

-t tab

    set tab width


    ignore backspace effect

-l line

    # of preserved line (default 10000)


    load bookmark

-bookmark file

    specify bookmark file

-T type

    specify content-type


    internet message mode


    visual startup mode


    monochrome display


    automatically render frame


    dump formatted page into stdout

-cols width

    specify column width (used with -dump)

-ppc count

    specify the number of pixels per character (default 8.0) Larger values will make tables narrower.


    dump page source into stdout


    dump response of HEAD request into stdout


    dump HEAD and source into stdout


    dump HEAD, source, and extra information into stdout

-post file

    use POST method with file content

-header string

    insert string as a header


    goto <num> line


    show line number


    don't use proxy


    don't use mouse


    use cookie.


    don't use cookie


    squeeze multiple blank lines


    toggle wrap search mode


    don't use termcap init/deinit

-title [=TERM]

    set buffer name to terminal title string. If TERM is specified, use the TERM style title configuration.

-o opt=value

    assign value to config option


    show all available config option

-config file

    specify config file


    show usage


    show w3m version




  • To use w3m as a pager:
    $ ls | w3m
  • To use w3m to translate HTML files:
    $ cat foo.html | w3m -T text/html
  • or
    $ cat foo.html | w3m -dump -T text/html >foo.txt


This is the .I w3m 0.2.1 Release.

Additional information about .I w3m may be found on its Japanese language Web site located at: http://w3m.sourceforge.net/index.ja.html
or on its English version of the site at: http://w3m.sourceforge.net/index.en.html


.I w3m has incorporated code from several sources. Hans J. Boehm, Alan J. Demers, Xerox Corp. and Silicon Graphics have the copyright of the GC library comes with w3m package. Users have contributed patches and suggestions over time.