Please note that all of the following is intended to work for BZR not "Stable". If you are still using "Stable", please upgrade. BZR is more stable and has better features to book.

• How do I start AWN?

Find it under your menus (In Ubuntu, its Applications > Accessories > Avant Window Navigator) or type avant-window-navigator & at the terminal prompt.

• There's a big ugly black bar around AWN! How do I get rid of it?

You need to be running a compositor like Beryl or Compiz.

• How do I access the preferences for awn?

Right-click either end of the bar and choose "Preferences" or type awn-manager & at the terminal.

• How do I close awn?
  

Right-click either end of the bar and choose "Close" or type
killall -u $USER avant-window-navigator at the terminal.

• How do I add launchers to the bar?

Just drag and drop! You can also select "Add" in the Launchers menu of AWN-Manager.

A note, however: this may, in some cases, not work. In that case, launch gconf-editor & from run (Alt+F2) or from the terminal. Change the key in

/apps/avant-window-navigator/window_manager/launchers

to include a reference to your launcher.

• How do I change the order of my launchers?

Right click either end of the bar and select "Preferences" to open AWN-Manager. From there, select "Launchers" on the left hand menu. You can drag and drop there in order to rearrange your launchers.

• How Can I make AWN run at start up?
  

In Ubuntu, goto System > Preferences > Sessions and add a new entry for the command 'avant-window-navigator'

• How Can I test Fading Icons feature?

Open the preferences window (see above). From there, on the first tab, you should see "Fade effect (experimental)". Make sure that that's checked. A note, however: this is an experimental feature. It has many bugs, and may not work as intended. You have been warned.

• How do I make AWN look like the LG3D or Leopard Dock?

This feature is now accessible through the GUI. Right click on the bar and select "Preferences" from the context menu in order to open AWN-Manager. Click on the "Bar Appearance" tab from the "General Preferences" menu, and then select "3d Look" from the "Look" drop down menu.

You are, of course, free to play around to create your own custom look by changing the settings for bar angle, height, and icon offset.

• How do I add applets?

Right click either end of the bar and choose "Preferences" to open AWN-Manager. Select "Applets" from the left hand menu. Highlight the applet you wish to add and use the arrows to move it to the active applets list. You may also drag and drop to rearrange you applets in this menu.

AWN ships with the following applets: Trash Applet, Separator, Launcher/Taskmanger, Notification Area, and Workspace Switcher. More applets are currently in development and may be included soon. AWN Main Menu and Stacks applets can be found in AWN-Extras.

• How do I install AWN-Extras?

Instructions for installing AWN-Extras from source can be found here.

For those running using Reacocard Ubuntu repo:

sudo apt-get awn-core-applets-bzr

• How do I reset AWN's preferences?

In order to reset all of AWN's preferences to their defaults run the following in the terminal:

gconftool-2 --recursive-unset /apps/avant-window-navigator

This can be useful when you wish to return to AWN's default appearance.

• How do I reposition AWN?

By default AWN sits centered on the bottom edge of the screen. The option to reposition it does not currently exist, but it is a planned feature.

• How do I apply a patch to AWN?

Applying patches is not recomended for the normal user. Patches are a way for developers to work on new features before commiting them to the core code. By their nature they should be considered very unstable. Instructions for applying patches are available here. A site for developers to post patches for the consideration of the community can be found here.