Awn debian packaging
C Shell Python Vala
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
applet-activation
applets
awn-settings
bindings
data
debian
doc
libawn
m4
po
shave
src
tests
themes
.gitignore
AUTHORS
COPYING
COPYING.LIB
ChangeLog
INSTALL
Makefile.am
Makefile.app-icons
Makefile.applet-common
Makefile.c-applet
Makefile.desktop-files
Makefile.in
Makefile.marshal
Makefile.schemas
Makefile.shave
Makefile.vala-applet
NEWS
README
TODO
aclocal.m4
autogen.sh
awn.pc.in
config.guess
config.h.in
config.sub
configure
configure.in
depcomp
gtk-doc.make
install-sh
intltool-extract.in
intltool-merge.in
intltool-update.in
ltmain.sh
missing
mkinstalldirs
py-compile

README

============================
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://launchpad.net/awn - Main project page
* http://wiki.awn-project.org/ - Wiki
* http://awn.planetblur.org/ - Forum
* irc://irc.freenode.net/#awn - IRC