{
    "mode": "man",
    "parameter": "w3m",
    "section": "1",
    "url": "https://www.chedong.com/phpMan.php/man/w3m/1/json",
    "generated": "2026-06-15T18:53:09Z",
    "synopsis": "w3m [OPTION]... [ file | URL ]...",
    "sections": {
        "NAME": {
            "content": "w3m - a text based web browser and pager\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "w3m [OPTION]... [ file | URL ]...\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "w3m is a text based browser which can display local or remote web pages as well as other doc‐\numents.  It is able to process HTML tables and frames but it ignores JavaScript and Cascading\nStyle  Sheets.   w3m can also serve as a pager for text files named as arguments or passed on\nstandard input, and as a general purpose directory browser.\n\nw3m organizes its content in buffers or tabs, allowing easy navigation  between  them.   With\nthe  w3m-img extension installed, w3m can display inline graphics in web pages.  And whenever\nw3m's HTML rendering capabilities do not meet your needs, the target URL can be  handed  over\nto a graphical browser with a single command.\n\nFor help with runtime options, press “H” while running w3m.\n\n",
            "subsections": []
        },
        "ARGUMENTS": {
            "content": "When  given  one or more command line arguments, w3m will handle targets according to content\ntype.  For web, w3m gets this information from HTTP headers; for relative  or  absolute  file\nsystem paths, it relies on filenames.\n\nWith  no  argument,  w3m expects data from standard input and assumes “text/plain” unless an‐\nother MIME type is given by the user.\n\nIf provided with no target and no fallback target (see for instance  option  -v  below),  w3m\nwill exit with usage information.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "Command line options are introduced with a single “-” character and may take an argument.\n",
            "subsections": [
                {
                    "name": "General options",
                    "content": ""
                },
                {
                    "name": "-B",
                    "content": "",
                    "flag": "-B"
                },
                {
                    "name": "-M",
                    "content": "",
                    "flag": "-M"
                },
                {
                    "name": "-no-mouse",
                    "content": "deactivate mouse support\n"
                },
                {
                    "name": "-num",
                    "content": ""
                },
                {
                    "name": "-N",
                    "content": "used\n",
                    "flag": "-N"
                },
                {
                    "name": "-ppc",
                    "content": "width of num pixels per character.  Range of 4.0 to 32.0, default 8.0.  Larger  values\nwill make tables narrower.  (Implementation not verified)\n"
                },
                {
                    "name": "-ppl",
                    "content": "height of num pixels per line.  Range of 4.0 to 64.0.  (Implementation not verified)\n"
                },
                {
                    "name": "-title -title=TERM",
                    "content": "use  the buffer name as terminal title string.  With specified TERM, this sets the ti‐\ntle configuration style accordingly\n"
                },
                {
                    "name": "-v",
                    "content": "",
                    "flag": "-v"
                },
                {
                    "name": "-W",
                    "content": "",
                    "flag": "-W"
                },
                {
                    "name": "-X",
                    "content": "+num   go to line num; only effective for num larger than the number of lines in the terminal\n",
                    "flag": "-X"
                },
                {
                    "name": "Browser options",
                    "content": ""
                },
                {
                    "name": "-cols",
                    "content": "with stdout as destination; HTML is rendered to lines of num characters\n"
                },
                {
                    "name": "-cookie -no-cookie",
                    "content": "use stored cookies and accept new ones, or do neither\n"
                },
                {
                    "name": "-F",
                    "content": "",
                    "flag": "-F"
                },
                {
                    "name": "-graph -no-graph",
                    "content": "use or do not use graphic characters for drawing HTML table and frame borders\n"
                },
                {
                    "name": "-header",
                    "content": "append string to the HTTP(S) request.  Expected to match the header  syntax  Variable:\nValue\n"
                },
                {
                    "name": "-m",
                    "content": "",
                    "flag": "-m"
                },
                {
                    "name": "-no-proxy",
                    "content": "do not use proxy\n"
                },
                {
                    "name": "-post",
                    "content": "use  POST  method  to  upload  data  defined  in  file.   The  syntax  to  be  used is\nvar1=value1[&var2=value2]...\n"
                },
                {
                    "name": "-4",
                    "content": "",
                    "flag": "-4"
                },
                {
                    "name": "-6",
                    "content": "",
                    "flag": "-6"
                },
                {
                    "name": "Text pager options",
                    "content": ""
                },
                {
                    "name": "-l",
                    "content": "10,000)\n",
                    "flag": "-l"
                },
                {
                    "name": "-r",
                    "content": "nroff-style backspaces for bold and underlined characters) instead of processing them\n",
                    "flag": "-r"
                },
                {
                    "name": "-s",
                    "content": "",
                    "flag": "-s"
                },
                {
                    "name": "-t",
                    "content": "",
                    "flag": "-t"
                },
                {
                    "name": "Data type/encoding options",
                    "content": ""
                },
                {
                    "name": "-I",
                    "content": "user defined character encoding of input data\n",
                    "flag": "-I"
                },
                {
                    "name": "-O",
                    "content": "user defined character encoding of output data\n",
                    "flag": "-O"
                },
                {
                    "name": "-T",
                    "content": "explicit characterization of input data by MIME type\n",
                    "flag": "-T"
                },
                {
                    "name": "Options for data output, followed by immediate exit",
                    "content": ""
                },
                {
                    "name": "-dump",
                    "content": "pipe\n"
                },
                {
                    "name": "-dump",
                    "content": "dump the page's source code into stdout\n"
                },
                {
                    "name": "-dump",
                    "content": "dump response of a HEAD request for a URL into stdout\n"
                },
                {
                    "name": "-dump",
                    "content": "dump HEAD, and source code for a URL into stdout\n"
                },
                {
                    "name": "-dump",
                    "content": "dump HEAD, source code, and extra information for a URL into stdout\n"
                },
                {
                    "name": "-help",
                    "content": ""
                },
                {
                    "name": "-show-option",
                    "content": "show all available configuration options\n"
                },
                {
                    "name": "-version",
                    "content": "show the version of w3m\n"
                },
                {
                    "name": "Options for overriding default settings and resources",
                    "content": ""
                },
                {
                    "name": "-bookmark",
                    "content": "use file instead of the default bookmark.html file\n"
                },
                {
                    "name": "-config",
                    "content": "use file instead of the default configuration file\n"
                },
                {
                    "name": "-debug",
                    "content": ""
                },
                {
                    "name": "-o",
                    "content": "modify  one  configuration  item with an explicitly given value; without option=value,\nequivalent to -show-option\n",
                    "flag": "-o"
                },
                {
                    "name": "-reqlog",
                    "content": "log headers of HTTP communication in file ~/.w3m/request.log\n"
                }
            ]
        },
        "EXAMPLES": {
            "content": "",
            "subsections": [
                {
                    "name": "Pager-like usage",
                    "content": "Combine snippets of HTML code and preview the page\n$ cat header.html footer.html | w3m -T text/html\n\nCompare two files using tabs\n$ w3m -N config.old config\n"
                },
                {
                    "name": "Browser-like usage",
                    "content": "Display web content in monochrome terminal\n$ w3m -M http://w3m.sourceforge.net\n\nDisplay embedded graphics\n$ w3m -o autoimage=TRUE http://w3m.sourceforge.net\n\nDisplay content from Usenet\n$ w3m -m nntp://news.aioe.org/comp.os.linux.networking\n\nUpload data for a URL using the POST method\n$ w3m -post - http://example.com/form.php <<<'a=0&b=1'\n"
                },
                {
                    "name": "Filter-like usage",
                    "content": "Convert an HTML file to plain text with a defined line length\n$ w3m -cols 40 foo.html > foo.txt\n\nOutput the bookmarks page as text with an appended list of links\n$ w3m -B -o displaylinknumber=1 > out.txt\n\nConversion of file format and character encoding\n$ w3m -T text/html -I EUC-JP -O UTF-8 < foo.html > foo.txt\n"
                },
                {
                    "name": "Start with no input",
                    "content": "Welcome users with a built-in page\n$ w3m -v\n"
                }
            ]
        },
        "ENVIRONMENT": {
            "content": "w3m recognises the environment variable WWWHOME as defining a fallback target for use if  it\nis invoked without one.\n",
            "subsections": []
        },
        "FILES": {
            "content": "~/.w3m/bookmark.html\ndefault bookmark file\n\n~/.w3m/config\nuser defined configuration file; overrides /etc/w3m/config\n\n~/.w3m/cookie\ncookie jar; written on exit, read on launch\n\n~/.w3m/history\nbrowser history - visited files and URLs\n\n~/.w3m/keymap\nuser defined key bindings; overrides default key bindings\n\n~/.w3m/mailcap\nexternal viewer configuration file\n\n~/.w3m/menu\nuser defined menu; overrides default menu\n\n~/.w3m/mime.types\nMIME types file\n\n~/.w3m/mouse\nuser defined mouse settings\n\n~/.w3m/passwd\npassword and username file\n\n~/.w3m/preform\ncontains predefined values to fill recurrent HTML forms\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "README  and example files are to be found in the doc directory of your w3m installation.  Re‐\ncent   information   about   w3m   may   be   found   on   the   project's   web   pages   at\n⟨http://w3m.sourceforge.net⟩\n",
            "subsections": []
        },
        "ACKNOWLEDGMENTS": {
            "content": "w3m  has  incorporated code from several sources.  Users have contributed patches and sugges‐\ntions over time.\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Akinori ITO ⟨aito@fw.ipsj.or.jp⟩\n\n\n\n\nw3m 0.5.3                                    2016-08-06                                       W3M(1)",
            "subsections": []
        }
    },
    "summary": "w3m - a text based web browser and pager",
    "flags": [
        {
            "flag": "-B",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-M",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "deactivate mouse support"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-N",
            "long": null,
            "arg": null,
            "description": "used"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "width of num pixels per character. Range of 4.0 to 32.0, default 8.0. Larger values will make tables narrower. (Implementation not verified)"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "height of num pixels per line. Range of 4.0 to 64.0. (Implementation not verified)"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use the buffer name as terminal title string. With specified TERM, this sets the ti‐ tle configuration style accordingly"
        },
        {
            "flag": "-v",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-W",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-X",
            "long": null,
            "arg": null,
            "description": "+num go to line num; only effective for num larger than the number of lines in the terminal"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "with stdout as destination; HTML is rendered to lines of num characters"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use stored cookies and accept new ones, or do neither"
        },
        {
            "flag": "-F",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use or do not use graphic characters for drawing HTML table and frame borders"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "append string to the HTTP(S) request. Expected to match the header syntax Variable: Value"
        },
        {
            "flag": "-m",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "do not use proxy"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use POST method to upload data defined in file. The syntax to be used is var1=value1[&var2=value2]..."
        },
        {
            "flag": "-4",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-6",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-l",
            "long": null,
            "arg": null,
            "description": "10,000)"
        },
        {
            "flag": "-r",
            "long": null,
            "arg": null,
            "description": "nroff-style backspaces for bold and underlined characters) instead of processing them"
        },
        {
            "flag": "-s",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-t",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-I",
            "long": null,
            "arg": null,
            "description": "user defined character encoding of input data"
        },
        {
            "flag": "-O",
            "long": null,
            "arg": null,
            "description": "user defined character encoding of output data"
        },
        {
            "flag": "-T",
            "long": null,
            "arg": null,
            "description": "explicit characterization of input data by MIME type"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "pipe"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "dump the page's source code into stdout"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "dump response of a HEAD request for a URL into stdout"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "dump HEAD, and source code for a URL into stdout"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "dump HEAD, source code, and extra information for a URL into stdout"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "show all available configuration options"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "show the version of w3m"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use file instead of the default bookmark.html file"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "use file instead of the default configuration file"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": ""
        },
        {
            "flag": "-o",
            "long": null,
            "arg": null,
            "description": "modify one configuration item with an explicitly given value; without option=value, equivalent to -show-option"
        },
        {
            "flag": "",
            "long": null,
            "arg": null,
            "description": "log headers of HTTP communication in file ~/.w3m/request.log"
        }
    ],
    "examples": [
        "Combine snippets of HTML code and preview the page",
        "$ cat header.html footer.html | w3m -T text/html",
        "Compare two files using tabs",
        "$ w3m -N config.old config",
        "Display web content in monochrome terminal",
        "$ w3m -M http://w3m.sourceforge.net",
        "Display embedded graphics",
        "$ w3m -o autoimage=TRUE http://w3m.sourceforge.net",
        "Display content from Usenet",
        "$ w3m -m nntp://news.aioe.org/comp.os.linux.networking",
        "Upload data for a URL using the POST method",
        "$ w3m -post - http://example.com/form.php <<<'a=0&b=1'",
        "Convert an HTML file to plain text with a defined line length",
        "$ w3m -cols 40 foo.html > foo.txt",
        "Output the bookmarks page as text with an appended list of links",
        "$ w3m -B -o displaylinknumber=1 > out.txt",
        "Conversion of file format and character encoding",
        "$ w3m -T text/html -I EUC-JP -O UTF-8 < foo.html > foo.txt",
        "Welcome users with a built-in page",
        "$ w3m -v"
    ],
    "see_also": [],
    "tldr": {
        "source": "official",
        "description": "A text-based web browser.",
        "examples": [
            {
                "description": "Open a URL",
                "command": "w3m {{https://example.com}}"
            },
            {
                "description": "Open a URL in monochrome mode",
                "command": "w3m {{https://example.com}} -M"
            },
            {
                "description": "Open a URL without mouse support",
                "command": "w3m {{https://example.com}} -no-mouse"
            },
            {
                "description": "Open a new browser tab",
                "command": "<Shift t>"
            },
            {
                "description": "Display your browser history",
                "command": "<Ctrl h>"
            },
            {
                "description": "Quit w3m",
                "command": "<q><y>"
            }
        ]
    }
}