[English / Japanese]

Emacs-w3m, a simple Emacs interface to w3m.

Use Emacs as a full-featured and secure internet browser!
(Does not support javascript).


Features


History

This project has been in active development continuously since 2000.

Originally, there had been a separate project Emacs/W3 which in its time was the most popular web browser on Emacs, but it suffered from slow operation. The decision was made to create this alternative, based upon Akinori Ito's w3m text-mode pager which had WWW capability.

As of 2023, the project is active and has been being supported continuously for over two decades, but since 2005 it has been releasing updates in a "rolling" manner, directly from its repository.

Here's the history of the old milestones under the prior system of issuing 'stable' releases:


Download

The official current version is always available from GitHub.

Historical versions are also available.


Requirements

Optionally, if you would like to use the shimbun library included in the emacs-w3m distribution, you have to install the Emacs packages APEL and FLIM.


Installation

If you are installing from the un-official third-party MELPA repository, the install process follows the standard MELPA procedure. The rest of this section describes how to install manually from source.

Before installing emacs-w3m, check whether your environment meets the requirements.

Installing emacs-w3m on UNIX-like systems

First, run the configure script.

% ./configure

However, if you've installed APEL and FLIM in non-standard directories (ie. somewhere not on the default load-path), you must specify them using the --with-addpath option as follows:

% ./configure --with-addpath=/your/path/to//apel:/your/path/to/flim

Next, execute the following commands to install emacs-w3m to an appropriate directory.

% make
# make install

Installing on non-UNIX-like systems

If you cannot execute the configure script on your system, or if no make command is available, execute the following command:

# emacs -batch -q -no-site-file -l w3mhack.el NONE -f w3mhack-nonunix-install

However, if APEL, FLIM (or any other library) are installed in non-standard directories (ie. somewhere not on the default load-path), the installer won't find them. In such a case, it is necessary to tell the installer where they are, as shown below:

# emacs -batch -q -no-site-file -l w3mhack.el //c/your/path/to/apel://c/your/path/to/flim -f w3mhack-nonunix-install

Configuration

Emacs-w3m has many configuration options, but the minimum that is required is just to put this line into your Emacs init file (~/.emacs.d/init.el, ~/.emacs, etc.):

(require 'w3m-load)

Just type M-x w3m, and you can use emacs-w3m.

In order to handle text/html part with emacs-w3m under SEMI MUAs such as Wanderlust, put the following line in your Emacs init file:

(require 'mime-w3m)

For more details, see Info manual, or browse the emacs-w3m customization group within Emacs.


Mailing List

The project mailing list, emacs-w3m@namazu.org, is bi-lingual Japanese / English. It is open to the public, and its archive is accessible via the emacs-w3m mailing list archive. You can also subscribe to the gmane.emacs.w3m newsgroup which is gateway'd to this list bidirectionally (connect to news.gmane.io using nntp).

If you want to subscribe to this list, check the disclaimer and send a mail containing

subscribe Your Name

(not your email address) in the body to emacs-w3m-ctl@namazu.org. To unsubscribe, send a mail containing just

# bye

in the body to emacs-w3m-ctl@namazu.org.


Related Links


Authors

(alphabetical order in the family names)

Thanks to the many other people for their great contributions.


Contact

In order to contact us, please send a mail to emacs-w3m@namazu.org. This mailing list is gateway'd to the gmane.emacs.w3m newsgroup bidirectionally and accepts even messages posted from nonsubscribers.