GNU ELPA - luwak


Web browser based on lynx -dump.
luwak-1.0.0.tar (.sig), 2024-Mar-31, 60.0 KiB
Yuchen Pei <>
Atom feed
Browse ELPA's repository
CGit or Gitweb

To install this package from Emacs, use package-install or list-packages.

Full description

1. Overview

luwak mode is a simple Emacs web browser based on lynx -dump. It is currently text-only and GET-only.


  • Asynchronous loading
  • Some usual browser features: open, reload, search with a search engine, follow links, go forward / backward in history, copy url of the current page or link at point
  • Completion from persistent history in prompt to open a url
  • Multiple ways of rendering links: numbered, forward-sexp or hide altogether
  • Quickly open a link on the page with completion for url / link id
  • imenu support, from all unindented strings (which look like headings)
  • Support of storing and capturing for org mode, guessing the title (first imenu item)
  • Write the dump of the current page to a file
  • Render a buffer containing a lynx dump in the luwak mode
  • Browse with or without torsocks

2. Install and use

To use, clone this repo, add to load-path and require. Make sure you have lynx installed in your system (apt install lynx, pacman -S lynx etc.). By default the browser does not torsocks, which can be disabled with a prefix arg or switching luwak-tor-switch to nil.

(add-to-list 'load-path "~/.emacs.d/luwak")
(require 'luwak)

There are three entry points:

  • luwak-open: open a url
  • luwak-search: search a query using a customisable default search engine
  • luwak-render-buffer: render a lynx dump file in luwak mode

3. Naming

lynx dump -> feline excretion -> Kopi Luwak

4. TODOs

  • Multiple search engines
  • Support for images
  • Support for POST

5. Contact and license

luwak is maintained by Yuchen Pei ( It is covered by GNU AGPLv3+. You may find the license text in a file named COPYING.agpl3 in the project tree.