aboutsummaryrefslogtreecommitdiffhomepage
path: root/FAQ
blob: 5a255b6eaf55de2bbac7efbbdd1b34ef5a2b87ff (plain)
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
FAQ
---

### I just installed uzbl but it doesn't do much.  I can load one uri and quit the program but that's it.
You did not load a configuration.  Uzbl does not create a default config file on startup like some other programs do.
Because we want to give you the freedom to place your config where you want, and to use a config or not.
Have a look in /usr/share/uzbl/examples/configs.
Use the --config parameter or save your config as $XDG\_CONFIG\_HOME/uzbl/config to have it auto-loaded.

### Where is the location bar? How do I change the URL ?
Uzbl has no location bar.  All changes to the uri (editing of current uri, typing new uri, loading of uri from bookmarks/history/...) happens *outside* of uzbl.
Have a look at the sample scripts in /usr/share/uzbl/examples.  Most of our examples use dmenu which is a nifty little tool to pick an item from a list of items (very
useful with history/bookmarks) with a limited set of keystrokes.  see man dmenu.
You can also use it to make edits to a uri (press tab to load it into the
search field) or type a url from scratch, though dmenu
is not the most suitable editor. We're looking into a better way to make edits.
Zenity is also an option, if you want copy-paste support.

### Where are the widgets (forward, back,.. button etc)
Uzbl's layout only contains what you really need to see.  we only have a statusbar, which even can also be disabled.  There are no buttons, but we do
have lots of keybinding possibilities.

### Why can't I type anything in forms?  How does the keybinding work?
You are in command mode, not in insert mode.

* command mode: you can trigger actions inside uzbl with minimum amount of keypresses (eg 'q' to quit)  (see config examples), but not to type actual text into forms, because all your keypresses are interpreted.
* insert mode: after going into insert mode (by default this is the 'i' binding from inside command mode), your keypresses are not interpreted but passed on, so you can enter text into forms.  Press Esc to go out of insert mode.

The above method is called "modal" as inspired on VI.  If you don't like
this you can easily change this:

* enable always\_insert\_mode in your config.  You will always be in insert mode.
* configure a modkey.  Since your keypresses are not interpreted anymore to trigger actions, you need a modkey to do things (eg alt+'q' to quit instead of just 'q' from command mode)

This method is how many applications work.

Both have their pro's and cons.  We don't want to force anyone in using
either, so by tuning the modkey and always\_insert\_mode settings you can pick
whichever method you like, or both at the same time (command mode, insert mode, and the modkey to perform actions while in insert mode)

### Why do you depend on gtk?
Uzbl itself doesn't use much gtk stuff (only the statusbar) so we could do without gtk.  But Webkit needs a widget toolkit to create widgets (think javascript popups, html forms etc).
It also supports QT and wxwigdets.  One could argue we don't need no popups or fancy form widgets and you could have a point, but forking webkit would bring us way to far. 
And we don't find the use of gtk *that* disturbing.  Besides, a curses/xlib html form wouldn't look too nice, would it?

### What? You call all of this user-friendly?
Yes.  If you don't agree, don't use it :)