1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
|
#+title: luwak: a text-only Emacs web browser based on lynx -dump
* Overview
Luwak mode is a simple Emacs GET-only and text-only web browser, based
on ~lynx -dump~.
Features:
- 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
- Write the dump of the current page to a file
- Render a lynx dump in the luwak mode
- imenu support, from all unindented strings (which look like
headings)
- Support of storing and capturing for org mode, guessing the title
(first imenu item)
- Multiple ways of rendering links: numbered, forward-sexp, hide
altogether
- Quickly open a link on the page with completion for url / link id
- Browse with or without torsocks
* 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 uses torsocks, which can be
disabled with a prefix arg or switching ~luwak-tor-switch~ to ~t~.
#+begin_src elisp
(add-to-list 'load-path "~/.emacs.d/luwak")
(require 'luwak)
#+end_src
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
* Naming
lynx dump -> feline excretion -> Kopi Luwak
* Contact and license
luwak is maintained by Yuchen Pei (id@ypei.org). It is covered by [[https://www.gnu.org/licenses/agpl-3.0.en.html][GNU
AGPLv3+]]. You may find the license text in a file named COPYING.agpl3
in the project tree.
|