Idea

These scripts are helpers for the uzbl web browser. They tailor certain features (such as bookmark selection and file downloads) to take advantage of services provided by the awesome window manager.

Obviously, these scripts will not be of much direct use unless you actually use awesome, but the general ideas may be useful for other environments.

Current Features

There are three components so far: a download helper, a bookmark selector, and a cookie service.

Download helper

The download helper prompts for a destination to save files using either pygtk or pyqt4 (configurable in the script). Cancelling the dialog cancels the download.

After a download is initiated, the script notifies awesome of its progress, and some included functions (listed in the source of the script) allow awesome to display updates on download percentages. The script also uses the freedesktop notification protocol to send notifications of download completion.

Bookmark selector

This is a simpler script that replaces the default dmenu-driven version that ships with uzbl; instead, it uses the completion facility provided by awesome's promptboxes.

This fits in better with the awesome theme visually, and the positioning is up to awesome (and the person configuring it), rather than dmenu.

Cookie service

This is based on the idea by Bob Farrell (see the uzbl mailing list), but communicates via dbus instead of a fifo. This brings a few advantages:

• Automatic startup as a dbus service
• No cruft left on the filesystem due to crashes
• No need for defining another protocol

This one requires a bit more installation than the others, but does not depend on awesome at all:

1. Set cookieclient.py as your cookie handler
2. Put cookiejarred in your path
3. Add the dbus .service file to your dbus service directory (can be user-local at $XDG_CONFIG_DIR/dbus-1/services)

There is now an alternate cookie client written in C. This is considerably faster and may be worth a look.

Dependencies

• uzbl
• awesome
• dbus-python

Optional

• PyGtk
• PyQt4

Only one of the GUI toolkits is needed.