[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 2018, the project has been actively developed and supported for nearly two decades, but since 2005 it has been releasing updates in a "rolling" manner, directly from its CVS repository (although un-official third-party mirrors exist on MELPA and github).

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 our own CVS repository. However, we recognize that it may be more convenient for users to download and update the package using the un-official third-party mirrors that exist on MELPA and github. We need to say that those mirrors are not controlled by this project and we have no way of knowing or guaranteeing their reliability or integrity.

This project uses the cvs[1] version control system, so in order to download the current version from the official source, you need to have cvs installed.

% cvs -d :pserver:anonymous@cvs.namazu.org:/storage/cvsroot login
CVS password: # No password is set.  Just hit Enter/Return key.
% cvs -d :pserver:anonymous@cvs.namazu.org:/storage/cvsroot co emacs-w3m

Source code access with ViewVC is 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 file:

(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 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.org 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.