awn
awn copied to clipboard
Official Avant Window Navigator repository
============================ Avant Window Navigator (Awn)
A dock-like bar which sits at the bottom of your screen, allowing you to launch and control applications. It also has the ability to embed external applets. The look and feel are fully customizable, and theming support is also available.
Installation
Please find out if your distribution has either binary packages available for Awn, or ebuilds/recipes/build scripts available through your distribution's package manager. It will save you a lot of time and energy if you install via your distribution's package manager.
The following packages are required to build Awn from source. Note that in most distributions, you need both the library and development/header packages installed in order for the build process to work correctly.
- GNU Make
- libdesktop-agnostic [1]_
- libwnck 2.22 or later
- libX11
- dbus-glib
- xdamage
- xcomposite
- xrender
- Python 2.5 or later
- PyGTK 2.12 or later
- pyxdg (also known as python-xdg)
.. _[1]:: https://launchpad.net/libdesktop-agnostic
To build from source, run::
./configure
make
make install
./configure
can take arguments, please see ./configure --help
for
details. As the default install location is /usr/local
, you may need to run
sudo make install
instead of make install
.
Usage
You can launch Awn from Applications -> Accessories -> Avant Window Navigator
.
You can change the settings by either launching the preferences dialog from
System -> Preferences -> Awn Settings
, or right-clicking on most places on
the bar, and selecting 'Dock Preferences' in the menu that appears.
If the preferences dialog does not start, please run awn-settings
from the
terminal to see if any dependencies are missing.
Help
If you have any questions/bug reports/ideas, you can find help in the following locations:
- https://github.com/p12tic/awn
- https://github.com/p12tic/awn-extras
- https://github.com/p12tic/libdesktop-agnostic
This PPA contains packages for testing:
- https://launchpad.net/~awn-testing/+archive/ppa