Difference between revisions of "Jumanji"

From ArchWiki
Jump to: navigation, search
(Add a warning about insecure WebKit.)
 
(15 intermediate revisions by 10 users not shown)
Line 1: Line 1:
[[Category:Web Browser]]
+
[[Category:Web browser]]
[http://pwmt.org/projects/jumanji/ jumanji] is a web browser that provides a minimalistic and space saving interface as well as an easy usage that mainly focuses on keyboard interaction like vimperator does
+
[[ja:Jumanji]]
 +
{{Warning|jumanji is based on a WebKit port that is today considered insecure and outdated. It's recommended to use [[List of applications/Internet#Web browsers|another browser]] instead. More info [https://blogs.gnome.org/mcatanzaro/2016/02/01/on-webkit-security-updates/ here].}}
  
==Installation==
+
[http://pwmt.org/projects/jumanji/ jumanji] is a web browser that provides a minimalistic and space saving interface as well as an easy usage that mainly focuses on keyboard interaction like ''vimperator'' does.
===Method 1: AUR (Recommended)===
+
[https://aur.archlinux.org/packages.php?ID=38684 jumanji] is available from the [[Arch User Repository]].
+
  
===Method 2: From Source===
+
== Installation ==
Grab the source from git, change the config.h as desired, compile and install as follows:
+
 
git clone git://pwmt.org/jumanji.git
+
[[Install]] the {{AUR|jumanji-git}} package to get a development release.
cd jumanji
+
 
make install
+
== Configuration ==
 +
 
 +
=== config.h ===
  
==Configuration==
 
===config.h===
 
 
To modify config.h:
 
To modify config.h:
 
* get jumanji-git PKGBUILD from AUR
 
* get jumanji-git PKGBUILD from AUR
* {{Ic|makepkg}}
+
* {{ic|makepkg}}
* {{Ic|git --git-dir src/jumanji/ init}}
+
* {{ic|git --git-dir src/jumanji/ init}}
 
* change src/jumanji/config.def.h
 
* change src/jumanji/config.def.h
* {{Ic|makepkg -e}}
+
* {{ic|makepkg -e}}
 +
 
 +
=== rc file configuration ===
 +
 
 +
jumanji allows for a lot of user configuration either by modifying the config.def.h file or through a rc file located at {{ic|~/.config/jumanji/jumanjirc}}. you can set searchengines, homepages, custom stylesheets, user scripts, proxy. Change the default download directory and much more. A sample configuration file below shows how to customize jumanji.
 +
 
 +
{{bc|<nowiki>
 +
# jumanji configuration
 +
# search engines
 +
searchengine ggl https://www.google.com/search?q=%s
 +
searchengine wiki https://en.wikipedia.org/w/index.php?search=%s
 +
# browser settings
 +
set homepage https://www.google.com/ig
 +
set auto_save 60
 +
set single_instance false
 +
# Use privoxy for adblocking
 +
set proxy localhost:8118
 +
# look n feel
 +
set font monospace normal 9
 +
set stylesheet file:///home/inxs/.config/jumanji/style.css
 +
# follow hints
 +
script ~/.config/jumanji/scripts/hinting.js
 +
# downloads
 +
set download-dir ~/downloads/
 +
set download_command urxvt -e sh -c "wget --load-cookies ~/.config/jumanji/cookies '%s' -O '%s'";
 +
# keybindings
 +
map <C-,> navigate_history previous
 +
map <C-.> navigate_history next
 +
bmap ^DD$ quit
 +
</nowiki>}}
 +
 
 +
{{Note| Latest version seems to use "proxy localhost:8118" instead of "''set'' proxy localhost:8118".}}
  
===rc file configuration===
+
== Commands ==
jumanji allows for a lot of user configuration either by modifying the config.def.h file or through a rc file located at '''~/.config/jumanji/jumanjirc'''. you can set searchengines, homepages, custom stylesheets, user scripts, proxy. Change the default download directory and much more. A sample configuration file below shows how to customize jumanji.
+
# jumanji configuration
+
# search engines
+
searchengine ggl http://www.google.com/search?q=%s
+
searchengine wiki http://en.wikipedia.org/w/index.php?search=%s
+
# browser settings
+
set homepage http://www.google.com/ig
+
set auto_save 60
+
set single_instance false
+
# Use privoxy for adblocking
+
set proxy localhost:8118
+
# look n feel
+
set font monospace normal 9
+
set stylesheet file:///home/inxs/.config/jumanji/style.css
+
# follow hints
+
script ~/.config/jumanji/scripts/hinting.js
+
# downloads
+
set download_dir ~/downloads/
+
set download_command urxvt -e sh -c "wget --load-cookies ~/.config/jumanji/cookies '%s' -O '%s'";
+
# keybindings
+
map <C-,> nav_history previous
+
map <C-.> nav_history next
+
bmap ^DD$ quit
+
  
==Commands==
 
 
Below are some basic commands that can be used with jumanji  
 
Below are some basic commands that can be used with jumanji  
  
===Look and Feel===
+
=== Look and feel ===
 +
 
 
  C-m      = Toggle status bar
 
  C-m      = Toggle status bar
 
  C-n      = Toggle tab bar
 
  C-n      = Toggle tab bar
  
===Page Navigation===
+
=== Page navigation ===
 +
 
 
  o        = enter url to open in same tab
 
  o        = enter url to open in same tab
 
  t        = enter url to open in new tab
 
  t        = enter url to open in new tab
Line 70: Line 78:
 
  r        = reload
 
  r        = reload
  
===Zooming===
+
=== Zooming ===
 +
 
 
  zI        = zoom_in
 
  zI        = zoom_in
 
  zO        = zoom_out
 
  zO        = zoom_out
 
  z0        = zoom to original size
 
  z0        = zoom to original size
  
===Searching===
+
=== Searching ===
 +
 
 
  /        = search %s
 
  /        = search %s
 
  ?        = search reverse %s
 
  ?        = search reverse %s
 
  :open    = start a search with your search engine %s (the first one in your jumanjirc is used)
 
  :open    = start a search with your search engine %s (the first one in your jumanjirc is used)
  
===Bookmarks and History===
+
=== Bookmarks and history ===
 +
 
 
  :bmark  = insert bookmark (bookmarks are saved in ~/.config/jumanji/bookmarks)
 
  :bmark  = insert bookmark (bookmarks are saved in ~/.config/jumanji/bookmarks)
 
  o <tab>  = show bookmarks and history to open in same tab
 
  o <tab>  = show bookmarks and history to open in same tab
 
  t <tab>  = show bookmarks and history to open in new tab
 
  t <tab>  = show bookmarks and history to open in new tab
  
===Link Following===
+
=== Link following ===
 +
 
 
  f        = spawn numbers next to each hyperlink. Type the number after typing f to follow the link in the same tab [http://www.pwmt.org/jumanji/faq/]
 
  f        = spawn numbers next to each hyperlink. Type the number after typing f to follow the link in the same tab [http://www.pwmt.org/jumanji/faq/]
 
  F        = spawn numbers next to each hyperlink. Type the number after typing F to follow the link in a new tab
 
  F        = spawn numbers next to each hyperlink. Type the number after typing F to follow the link in a new tab
Line 93: Line 105:
 
  gF      = view source in a new tab
 
  gF      = view source in a new tab
  
===Tabs===
+
=== Tabs ===
 +
 
 
  gt  or C-Tab  or  S-k  = go to next tab
 
  gt  or C-Tab  or  S-k  = go to next tab
 
  gT  or C-S-Tab or  S-j  = go to previous tab
 
  gT  or C-S-Tab or  S-j  = go to previous tab
Line 99: Line 112:
 
  C-w                      = close tab
 
  C-w                      = close tab
  
===Exit===
+
=== Exit ===
 +
 
 
  ZZ        = exit
 
  ZZ        = exit
 
  C-q      = exit
 
  C-q      = exit
  
==See also==
+
== See also ==
 +
 
 
* [https://bbs.archlinux.org/viewtopic.php?id=100505 Old, closed forum thread]
 
* [https://bbs.archlinux.org/viewtopic.php?id=100505 Old, closed forum thread]
 
* [https://bbs.archlinux.org/viewtopic.php?id=115119 The current forum thread]
 
* [https://bbs.archlinux.org/viewtopic.php?id=115119 The current forum thread]

Latest revision as of 01:51, 16 October 2016

Warning: jumanji is based on a WebKit port that is today considered insecure and outdated. It's recommended to use another browser instead. More info here.

jumanji is a web browser that provides a minimalistic and space saving interface as well as an easy usage that mainly focuses on keyboard interaction like vimperator does.

Installation

Install the jumanji-gitAUR package to get a development release.

Configuration

config.h

To modify config.h:

  • get jumanji-git PKGBUILD from AUR
  • makepkg
  • git --git-dir src/jumanji/ init
  • change src/jumanji/config.def.h
  • makepkg -e

rc file configuration

jumanji allows for a lot of user configuration either by modifying the config.def.h file or through a rc file located at ~/.config/jumanji/jumanjirc. you can set searchengines, homepages, custom stylesheets, user scripts, proxy. Change the default download directory and much more. A sample configuration file below shows how to customize jumanji.

# jumanji configuration
# search engines
searchengine ggl https://www.google.com/search?q=%s
searchengine wiki https://en.wikipedia.org/w/index.php?search=%s
# browser settings
set homepage https://www.google.com/ig
set auto_save 60
set single_instance false
# Use privoxy for adblocking
set proxy localhost:8118 
# look n feel
set font monospace normal 9
set stylesheet file:///home/inxs/.config/jumanji/style.css 
# follow hints
script ~/.config/jumanji/scripts/hinting.js
# downloads
set download-dir ~/downloads/
set download_command urxvt -e sh -c "wget --load-cookies ~/.config/jumanji/cookies '%s' -O '%s'";
# keybindings
map <C-,> navigate_history previous
map <C-.> navigate_history next
bmap ^DD$ quit
Note: Latest version seems to use "proxy localhost:8118" instead of "set proxy localhost:8118".

Commands

Below are some basic commands that can be used with jumanji

Look and feel

C-m       = Toggle status bar
C-n       = Toggle tab bar

Page navigation

o         = enter url to open in same tab
t         = enter url to open in new tab
j         = scroll down
k         = scroll up
h         = scroll left
l         = scroll right
C-d       = scroll down (half the screen)
C-u       = scroll up (half the screen)
space     = page down
gg        = beginning
G         = end
C-o       = back
C-i       = forward
:stop     = stop
r         = reload

Zooming

zI        = zoom_in
zO        = zoom_out
z0        = zoom to original size

Searching

/        = search %s
?        = search reverse %s
:open    = start a search with your search engine %s (the first one in your jumanjirc is used)

Bookmarks and history

:bmark   = insert bookmark (bookmarks are saved in ~/.config/jumanji/bookmarks)
o <tab>  = show bookmarks and history to open in same tab
t <tab>  = show bookmarks and history to open in new tab

Link following

f        = spawn numbers next to each hyperlink. Type the number after typing f to follow the link in the same tab [1]
F        = spawn numbers next to each hyperlink. Type the number after typing F to follow the link in a new tab
gh       = Go to homepage in the same tab
gH       = open homepage in a new tab
gf, C-s  = view source
gF       = view source in a new tab

Tabs

gt  or C-Tab   or   S-k   = go to next tab
gT  or C-S-Tab or   S-j   = go to previous tab
xgt                       = go to tab number x, where x is any number 0-9
C-w                       = close tab

Exit

ZZ        = exit
C-q       = exit

See also