Difference between revisions of "UZBL-Browser"

From ArchWiki
Jump to: navigation, search
(Page Navigation)
m (Installation)
(30 intermediate revisions by 18 users not shown)
Line 1: Line 1:
[[Category:Internet and Email (English)]]
+
[[Category:Web Browser]]
==Overview==
+
{{Article summary start}}
A complete browser experience based on uzbl-core.
+
{{Article summary text|A lightweight browser based on the UNIX philosophy. This article addresses the steps necessary to run and configure Uzbl.}}
 +
{{Article summary heading|Resources}}
 +
{{Article summary link|Uzbl Homepage|http://www.uzbl.org/}}
 +
{{Article summary end}}
  
===Install===
+
[http://www.uzbl.org/ Uzbl] is a lightweight browser based on '''uzbl-core'''. '''Uzbl''' adheres to the UNIX philosophy of "Write programs that do one thing and do it well". The uzbl-browser package includes uzbl-core, uzbl-browser and uzbl-event-manager. Most users will want to use '''uzbl-browser''' or '''uzbl-tabbed''' as they provide the fullest set of tools for browsing. Uzbl-browser allows for a single page per window (with as many windows as you want), while uzbl-tabbed provides a wrapper for uzbl-browser and implements basic tabs with multiple pages per window.
The uzbl-browser package can be found in the community repository and may be installed via pacman with the following:
+
  
# pacman -S uzbl-browser
+
==Installation==
  
===Commands===
+
[[pacman|Install]] {{Pkg|uzbl-browser}} or {{Pkg|uzbl-tabbed}} available in the [[Official Repositories]].
Below are basic commands that can be used with uzbl-browser  
+
  
{{Note| One may toggle the command bar with ' t ' on the keyboard.}}
+
==Plugins==
 +
 
 +
Uzbl can make use of outside [[browser plugins]] like Flash and Java. Installing these packages will enable their use in uzbl-browser and uzbl-tabbed.
 +
 
 +
==Commands==
 +
 
 +
One of the biggest advantages of using Uzbl is that nearly everything can be controlled by the keyboard. This is preferable to the traditional mouse/keyboard combo because less moving around of the hands is needed. [[Vim]] users will find Uzbl much easier to pick-up, especially as the default bindings loosely resemble Vim keystrokes. For instance, following a link requires the user to type {{Ic|fl}}, and then the keystrokes in the box that appears next to each link on the page. Shortening the command to just {{Ic|f}} in the config file allows for even faster navigation.
 +
 
 +
Below are basic, default commands that can be used with uzbl-browser and uzbl-tabbed. These commands can all be found in {{ic|$XDG_CONFIG_HOME/uzbl/config}} (which is usually located in {{ic|~/.config/uzbl/config}}). The default settings work well, but many users like to edit them to suit their preferences and in fact, it is encouraged to change this file to suit your needs. More help with editing the config file can be found on [http://www.uzbl.org/readme.php the Uzbl readme].
 +
 
 +
====Navigation====
  
====Page Navigation====
 
 
  o        = enter url
 
  o        = enter url
  j         = scroll up
+
  O         = edit url
k        = scroll down
+
h        = scroll left
+
l        = scroll right
+
<<        = beginning
+
>>        = end
+
 
  b        = back
 
  b        = back
 
  m        = forward
 
  m        = forward
 
  S        = stop
 
  S        = stop
 
  r        = reload
 
  r        = reload
 +
R        = reload ignoring cache
 +
fl        = spawn numbers next to each hyperlink. Type the number after typing fl to follow the link.
 +
gh        = go home
 +
 +
====Page Movement====
 +
 +
j        = scroll up
 +
k        = scroll down
 +
h        = scroll left
 +
l        = scroll right
 +
PgUp      = scroll page up
 +
ctrl+b    = scroll page up
 +
PgDn      = scroll page down
 +
ctrl+f    = scroll page down
 +
Home      = vertical beginning of the page
 +
<<        = vertical beginning of the page
 +
End      = vertical end of the page
 +
>>        = vertical end of the page
 +
Space    = vertical end of the page
 +
^        = horizontal beginning of the page
 +
$        = horizontal end of the page
 +
/        = find in page
 +
?        = find backwards in page
 +
n        = repeat find forward
 +
N        = repeat find backwards
  
 
====Zooming====
 
====Zooming====
 +
 
  +        = zoom_in
 
  +        = zoom_in
 
  -        = zoom_out
 
  -        = zoom_out
 
  T        = toggle_zoom_type
 
  T        = toggle_zoom_type
  1        = sh “echo set zoom_level = 1.0 > $4″
+
  1        = set zoom_level = 1
  2        = sh “echo set zoom_level = 2.0 > $4″
+
  2        = set zoom_level = 2
  
 
====Searching====
 
====Searching====
  /*        = search %s
+
 
  ?*       = search_reverse %s
+
  ddg      = search term in DuckDuckGo
  gg <term> = search term in google
+
  gg       = search term in Google
 +
  \wiki    = search term in Wikipedia
  
 
====Inserting Text====
 
====Inserting Text====
 +
 
  i        = toggle_insert_mode  (Esc works to go back to command mode much like vim)
 
  i        = toggle_insert_mode  (Esc works to go back to command mode much like vim)
 +
fi        = go to the first input field and enter insert mode
  
 
====Bookmarks and History====
 
====Bookmarks and History====
  B         = insert bookmark (bookmarks are saved in ~/.local/share/uzbl/bookmarks
+
 
 +
  M         = insert bookmark (bookmarks are saved in ~/.local/share/uzbl/bookmarks
 
  U        = load url from history via dmenu
 
  U        = load url from history via dmenu
 
  u        = load url from bookmarks via dmenu
 
  u        = load url from bookmarks via dmenu
  
====Exit====
+
====Tabs (when using uzbl-tabbed)====
 +
 
 +
go        = load uri in new tab
 +
gt        = go to next tab
 +
gT        = go to previous tab
 +
gn        = open new tab
 +
gi+n      = goto 'n' tab
 +
 
 +
====Other====
 +
 
 +
t        = show/hide status bar
 +
w        = open new window
 
  ZZ        = exit
 
  ZZ        = exit
 +
:        = enter command
 +
Esc      = back to normal mode
 +
ctrl+[    = back to normal mode
 +
 +
==Tips and tricks==
 +
 +
* Create an alias in {{ic|~/.bashrc}} to start uzbl-tabbed as just uzbl:
 +
 +
alias uzbl='uzbl-tabbed'
  
===Links===
+
* If you wish to open uzbl with a program launcher using the trick above:
http://www.uzbl.org/wiki/uzbl_tabbed
+
  cd /usr/bin
 +
  sudo ln -s uzbl-tabbed uzbl
 +
This creates a [http://en.wikipedia.org/wiki/Symbolic_link symbolic link], called uzbl, which points to uzbl-tabbed.
  
http://bbs.archlinux.org/viewtopic.php?id=70700&p=1
+
==Troubleshooting==
 +
Parcellite can cause problems at the time of selecting text under uzbl. just disable it.
  
====sources====
+
==See also==
  
[http://tuxtraining.com/2009/09/05/uzbl-and-uzbl_tabbed-py-a-browser-that-adheres-to-the-unix-philosophy Mixed via TuxTraining.com]
+
* [http://www.uzbl.org/wiki/ Uzbl wiki with user config files and scripts]
 +
* http://bbs.archlinux.org/viewtopic.php?id=70700&p=1
 +
* [https://github.com/Dieterbe/uzbl/raw/master/examples/config/config Configuration file]

Revision as of 17:12, 10 November 2012

Summary help replacing me
A lightweight browser based on the UNIX philosophy. This article addresses the steps necessary to run and configure Uzbl.
Resources
Uzbl Homepage

Uzbl is a lightweight browser based on uzbl-core. Uzbl adheres to the UNIX philosophy of "Write programs that do one thing and do it well". The uzbl-browser package includes uzbl-core, uzbl-browser and uzbl-event-manager. Most users will want to use uzbl-browser or uzbl-tabbed as they provide the fullest set of tools for browsing. Uzbl-browser allows for a single page per window (with as many windows as you want), while uzbl-tabbed provides a wrapper for uzbl-browser and implements basic tabs with multiple pages per window.

Installation

Install uzbl-browser or uzbl-tabbed available in the Official Repositories.

Plugins

Uzbl can make use of outside browser plugins like Flash and Java. Installing these packages will enable their use in uzbl-browser and uzbl-tabbed.

Commands

One of the biggest advantages of using Uzbl is that nearly everything can be controlled by the keyboard. This is preferable to the traditional mouse/keyboard combo because less moving around of the hands is needed. Vim users will find Uzbl much easier to pick-up, especially as the default bindings loosely resemble Vim keystrokes. For instance, following a link requires the user to type fl, and then the keystrokes in the box that appears next to each link on the page. Shortening the command to just f in the config file allows for even faster navigation.

Below are basic, default commands that can be used with uzbl-browser and uzbl-tabbed. These commands can all be found in $XDG_CONFIG_HOME/uzbl/config (which is usually located in ~/.config/uzbl/config). The default settings work well, but many users like to edit them to suit their preferences and in fact, it is encouraged to change this file to suit your needs. More help with editing the config file can be found on the Uzbl readme.

Navigation

o         = enter url
O         = edit url
b         = back
m         = forward
S         = stop
r         = reload
R         = reload ignoring cache
fl        = spawn numbers next to each hyperlink. Type the number after typing fl to follow the link.
gh        = go home

Page Movement

j         = scroll up
k         = scroll down
h         = scroll left
l         = scroll right
PgUp      = scroll page up
ctrl+b    = scroll page up
PgDn      = scroll page down
ctrl+f    = scroll page down
Home      = vertical beginning of the page
<<        = vertical beginning of the page
End       = vertical end of the page
>>        = vertical end of the page
Space     = vertical end of the page
^         = horizontal beginning of the page
$         = horizontal end of the page
/         = find in page
?         = find backwards in page
n         = repeat find forward
N         = repeat find backwards

Zooming

+         = zoom_in
-         = zoom_out
T         = toggle_zoom_type
1         = set zoom_level = 1
2         = set zoom_level = 2

Searching

ddg       = search term in DuckDuckGo
gg        = search term in Google
\wiki     = search term in Wikipedia

Inserting Text

i         = toggle_insert_mode   (Esc works to go back to command mode much like vim)
fi        = go to the first input field and enter insert mode

Bookmarks and History

M         = insert bookmark (bookmarks are saved in ~/.local/share/uzbl/bookmarks
U         = load url from history via dmenu
u         = load url from bookmarks via dmenu

Tabs (when using uzbl-tabbed)

go        = load uri in new tab
gt        = go to next tab
gT        = go to previous tab
gn        = open new tab
gi+n      = goto 'n' tab

Other

t         = show/hide status bar
w         = open new window
ZZ        = exit
:         = enter command
Esc       = back to normal mode
ctrl+[    = back to normal mode

Tips and tricks

  • Create an alias in ~/.bashrc to start uzbl-tabbed as just uzbl:
alias uzbl='uzbl-tabbed'
  • If you wish to open uzbl with a program launcher using the trick above:
 cd /usr/bin
 sudo ln -s uzbl-tabbed uzbl

This creates a symbolic link, called uzbl, which points to uzbl-tabbed.

Troubleshooting

Parcellite can cause problems at the time of selecting text under uzbl. just disable it.

See also