# phpman > man > w3m(1) > **TLDR:** A text-based web browser. > - Open a URL: `w3m {{https://example.com}}` - Open a URL in monochrome mode: `w3m {{https://example.com}} -M` - Open a URL without mouse support: `w3m {{https://example.com}} -no-mouse` - Open a new browser tab: `` - Display your browser history: `` - Quit w3m: `` *Source: tldr-pages* --- [W3M(1)](https://www.chedong.com/phpMan.php/man/W3M/1/markdown) General Commands Manual [W3M(1)](https://www.chedong.com/phpMan.php/man/W3M/1/markdown) ## NAME w3m - a text based web browser and pager ## SYNOPSIS w3m [OPTION]... [ _file_ | _URL_ ]... ## DESCRIPTION _w3m_ is a text based browser which can display local or remote web pages as well as other doc‐ uments. It is able to process HTML tables and frames but it ignores JavaScript and Cascading Style Sheets. _w3m_ can also serve as a pager for text files named as arguments or passed on standard input, and as a general purpose directory browser. _w3m_ organizes its content in buffers or tabs, allowing easy navigation between them. With the w3m-img extension installed, _w3m_ can display inline graphics in web pages. And whenever _w3m_'s HTML rendering capabilities do not meet your needs, the target URL can be handed over to a graphical browser with a single command. For help with runtime options, press “H” while running _w3m_. ## ARGUMENTS When given one or more command line arguments, _w3m_ will handle targets according to content type. For web, _w3m_ gets this information from HTTP headers; for relative or absolute file system paths, it relies on filenames. With no argument, _w3m_ expects data from standard input and assumes “text/plain” unless an‐ other MIME type is given by the user. If provided with no target and no fallback target (see for instance option **-v** below), _w3m_ will exit with usage information. ## OPTIONS Command line options are introduced with a single “-” character and may take an argument. ### General options ### -B ### -M ### -no-mouse deactivate mouse support ### -num ### -N used ### -ppc 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) ### -ppl height of _num_ pixels per line. Range of 4.0 to 64.0. (Implementation not verified) ### -title -title=TERM use the buffer name as terminal title string. With specified TERM, this sets the ti‐ tle configuration style accordingly ### -v ### -W ### -X **+**_num_ go to line _num_; only effective for _num_ larger than the number of lines in the terminal ### Browser options ### -cols with stdout as destination; HTML is rendered to lines of _num_ characters ### -cookie -no-cookie use stored cookies and accept new ones, or do neither ### -F ### -graph -no-graph use or do not use graphic characters for drawing HTML table and frame borders ### -header append _string_ to the HTTP(S) request. Expected to match the header syntax Variable: Value ### -m ### -no-proxy do not use proxy ### -post use POST method to upload data defined in _file_. The syntax to be used is var1=value1[&var2=value2]... ### -4 ### -6 ### Text pager options ### -l 10,000) ### -r nroff-style backspaces for bold and underlined characters) instead of processing them ### -s ### -t ### Data type/encoding options ### -I user defined character encoding of input data ### -O user defined character encoding of output data ### -T explicit characterization of input data by MIME type ### Options for data output, followed by immediate exit ### -dump pipe ### -dump dump the page's source code into stdout ### -dump dump response of a HEAD request for a URL into stdout ### -dump dump HEAD, and source code for a URL into stdout ### -dump dump HEAD, source code, and extra information for a URL into stdout ### -help ### -show-option show all available configuration options ### -version show the version of _w3m_ ### Options for overriding default settings and resources ### -bookmark use _file_ instead of the default bookmark.html file ### -config use _file_ instead of the default configuration file ### -debug ### -o modify one configuration item with an explicitly given value; without _option=value_, equivalent to **-show-option** ### -reqlog log headers of HTTP communication in file ~/.w3m/request.log ## EXAMPLES ### Pager-like usage 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 ### Browser-like usage Display web content in monochrome terminal $ w3m -M Display embedded graphics $ w3m -o auto_image=TRUE 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 - <<<'a=0&b=1' ### Filter-like usage 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 display_link_number=1 > out.txt Conversion of file format and character encoding $ w3m -T text/html -I EUC-JP -O UTF-8 < foo.html > foo.txt ### Start with no input Welcome users with a built-in page $ w3m -v ## ENVIRONMENT _w3m_ recognises the environment variable WWW_HOME as defining a fallback target for use if it is invoked without one. ## FILES ~/.w3m/bookmark.html default bookmark file ~/.w3m/config user defined configuration file; overrides /etc/w3m/config ~/.w3m/cookie cookie jar; written on exit, read on launch ~/.w3m/history browser history - visited files and URLs ~/.w3m/keymap user defined key bindings; overrides default key bindings ~/.w3m/mailcap external viewer configuration file ~/.w3m/menu user defined menu; overrides default menu ~/.w3m/mime.types MIME types file ~/.w3m/mouse user defined mouse settings ~/.w3m/passwd password and username file ~/.w3m/pre_form contains predefined values to fill recurrent HTML forms ## SEE ALSO README and example files are to be found in the doc directory of your _w3m_ installation. Re‐ cent information about _w3m_ may be found on the project's web pages at ⟨⟩ ## ACKNOWLEDGMENTS _w3m_ has incorporated code from several sources. Users have contributed patches and sugges‐ tions over time. ## AUTHOR Akinori ITO ⟨⟩ w3m 0.5.3 2016-08-06 [W3M(1)](https://www.chedong.com/phpMan.php/man/W3M/1/markdown)