w3m
w3m はテキストベースの Web ブラウザであり、more や [ [less]] w3m を使用すると、ターミナルエミュレータ ウィンドウを通じて Web ページを閲覧できます。さらに、w3m は、HTML をプレーンテキストにタイプセットするテキスト整形ツールとしても使用できます。
インストール
使い方
こちらを参照 w3m(1)
設定
w3m は、ブラウザ内の設定メニューを使用するか、設定ファイルを直接変更することによって構成できます。
より高度なオプションの一部は設定メニューを使用して使用できないため、設定ファイル自体を編集することをお勧めします。
デフォルトでは、すべての設定ファイルは ~/.w3m
にあります。
ヒントとテクニック
Vim キーバインド
~/.w3m/keymap
を カスタム設定 に置き換えます。
URL ヒント
w3m は qutebrowser のようなリンクナビゲーションをサポートしています。設定ファイルに移動して、次の行を display_link_number 0
から display_link_number 1
に変更するだけです。
そして、keymap f COMMAND "RESHAPE ; LINK_BEGIN ; GOTO_LINK"
と keymap F COMMAND "RESHAPE ; LINK_BEGIN ; TAB_LINK"
を ~/.w3m/keymap
に追加します。
kittens イメージプロトコルの使用
kitty ターミナルエミュレータのユーザーは、独自の グラフィックスプロトコル を使用することを選択できます。
これを行うには、~/.w3m/config
内の次の行を変更するだけです。
inline_img_protocol 0 imgdisplay w3mimgdisplay
これに:
inline_img_protocol 4 imgdisplay kitty
検索
wrap_search
を 1 に設定すると、検索がページ内のすべての一致の最後に到達した後に先頭にジャンプできるようになります。
ignorecase_search
を 1 に設定すると、大文字と小文字を区別しない検索が有効になります。
Custom search engines
You can map keys to launch a CGI script that will capture your input and pass it onto a custom search engine, to do so first create a keybind inside ~/.w3m/keymap
to launch your script:
keymap s COMMAND "SET_OPTION dictcommand=file:///cgi-bin/omnibar_google.cgi ; DICT_WORD"
And place omnibar_google.cgi inside your ~/.w3m/cgi-bin
directory and giving it execute permission.
While the above script will return a Google result, you can use these kinds of scripts to search StackOverflow, GitHub, DuckDuckGo, Reddit and a bunch of other websites.
You can view similar scripts on GitHub.
Reader mode
Some webpages do not work well with w3m, be it because they use a lot of javascript or CSS to display most of their content. Very often you will have to scroll multiple pages just to get to the start of an article.
This can be mitigated by first passing the webpages through a reader mode program such as rdrview-gitAUR.
To do so add the following to ~/.w3m/keymap
:
keymap R COMMAND "READD_SHELL 'rdrview $W3M_URL -H 2> /dev/null 1> /tmp/readable.html' ; LOAD /tmp/readdable.html"
Redirect URLs
~/.w3m/siteconf
file is used to set some preferences depending on the website, such as: referrer and user agent.
It can also be used to redirect to lighter (both in terms of layout and bandwidth), more privacy respecting alternatives to websites.
In addition to this it can also be used to run certain CGI scripts.
~/.w3m/siteconf
url m!^https?://([a-z]+\.)?twitter\.com/! substitute_url "https://nitter.net/" url m!^https?://([a-z]+\.)?reddit\.com/! substitute_url "https://safereddit.com/" #url m!^https?://([a-z]+\.)?google\.com/! #substitute_url "https://duckduckgo.com/lite/" url m!^https?://([a-z]+\.)?imgur\.com/! substitute_url "https://rimgo.pussthecat.org/" url m!^https?://([a-z]+\.)?wikipedia\.com/! substitute_url "https://wl.vern.cc/" url "https://www.youtube.com/" exact substitute_url "file:/cgi-bin/video.cgi?" #substitute_url "https://yewtu.be/" url "https://stackoverflow.com/" exact substitute_url "https://ao.bloatcat.tk/" url "https://www.reuters.com/" exact substitute_url "https://neuters.de/" url "https://fandom.com/" exact substitute_url "https://breezewiki.pussthecat.org/" url "https://medium.com/" exact substitute_url "https://scribe.rip/" url "https://web.archive.org/" exact substitute_url "https://wayback-classic.net/"
Restore closed windows
Default w3m cannot reopen closed tabs, this can be added by binding the close tab button to echo the current URL of the tab to be closed to a text file, and binding another key to restore the latest URL added to the file, using a CGI script.
Inside ~/.w3m/keymap
add:
keymap d COMMAND "EXTERN 'echo %s >> ~/.w3m/RestoreTab.txt' ; CLOSE_TAB" keymap u COMMAND TAB_GOTO file:/cgi-bin/restore_tab.cgi
Then place the following file inside ~/.w3m/cgi-bin
and make it executable.
Opening magnet links
magnet.cgi can be used to make w3m auto open magnet links using Transmission.
Fingerprinting
Using tor
You can use torify(1) to route w3m traffic through tor.
$ torify w3m -v
User agent and headers
By default w3m uses its own user agent, meaning w3m users stand out amongst other users.
Fingerprint can be reduced by using a more generic user agent, language and http_accept header.
~/.w3m/config
user_agent Mozilla/5.0 (Windows NO 10.0; rev:91.0) Gecko/20100101 Firefox91.0 no_referer 1 cross_origin_referer 0 accept_language en-US,en;q=0.5 accept_encoding gzip, deflate accept_media text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Disable cookies
To disable cookies set use_cookie
to 0 in ~/.w3m/config
.
Disable cache
To disable cookies set no_cache
to 1 in ~/.w3m/config
.
Troubleshooting
Images flickering/causing lag
Unfortunately, sometimes w3m lags when trying to scroll past an image, to the point where the browser can become unresponsive for multiple seconds.
A solution to this is outright disabling images, but this breaks some websites (for example, hacker news relies on GIFs for comment indentation).
A more elegant solution would be to make a keybind to toggle images on or off, to do so add the following line to ~/.w3m/keymap
:
keymap i COMMAND "SET_OPTION display_image=toggle ; RESHAPE"