Official Avant Window Navigator repository
Vala C++ C Python GAP Scheme Shell
Switch branches/tags
Nothing to show
Permalink
Failed to load latest commit information.
applet-activation C code cleanups Nov 27, 2013
applets Replace the vala files that use DBus with their generated c files. Oct 12, 2015
awn-settings settings: Rename modules to use lower_case format Nov 30, 2013
bindings Use AM_CPPFLAGS instead of INCLUDES per automake guidelines Nov 4, 2013
data Fix the default settings. Oct 11, 2015
doc Update the build system. Oct 11, 2015
libawn More cleanups in DBus dispatcher code Nov 27, 2013
m4 Update the build system. Oct 11, 2015
po po: Synchronize the translations. Oct 11, 2015
shave Build system: Add shave support (generates much less verbose autotool… Mar 2, 2009
src Replace the vala files that use DBus with their generated c files. Oct 12, 2015
tests make: Enable C++11 Nov 13, 2013
themes Fix the default settings. Oct 11, 2015
.gitignore Replace the vala files that use DBus with their generated c files. Oct 12, 2015
AUTHORS 2008-02-18 Mark Lee <avant-wn@lazymalevolence.com> Feb 18, 2008
COPYING Initial Import Jul 30, 2007
COPYING.GPL3 * COPYING.GPL3: Jan 10, 2010
COPYING.ICON 2008-02-01 Julien Lavergne, <julien.lavergne@gmail.com> Feb 1, 2008
COPYING.LIB 2008-02-01 Julien Lavergne, <julien.lavergne@gmail.com> Feb 1, 2008
ChangeLog * configure.in: Apr 20, 2011
HACKING * HACKING: Aug 27, 2009
Makefile.am Replace problematic vala sources with C source generated by valac-0.12 Nov 19, 2013
Makefile.app-icons 2008-02-18 Mark Lee <avant-wn@lazymalevolence.com> Feb 18, 2008
Makefile.applet-common Merge 1911 Jul 19, 2010
Makefile.c-applet make: Enable C++11 Nov 13, 2013
Makefile.desktop-files Merge 1911 Jul 19, 2010
Makefile.marshal Merge 1911 Jul 19, 2010
Makefile.schemas * .bzrignore: Sep 13, 2009
Makefile.shave * Makefile.marshal: Jul 18, 2009
Makefile.vala-applet Merge 1924 Jul 19, 2010
NEWS 2008-02-18 Neil J. Patel <njpatel@gmail.com> Feb 18, 2008
README README: Remove dead links Nov 13, 2013
TODO * TODO: Aug 18, 2009
autogen.sh Move configure.in to configure.ac per autoconf guidelines Nov 4, 2013
awn.config Add QtCreator project files Nov 13, 2013
awn.creator Add QtCreator project files Nov 13, 2013
awn.files settings: Rename modules to use lower_case format Nov 30, 2013
awn.includes More cleanups Nov 27, 2013
awn.pc.in * awn.pc.in: Jul 8, 2009
configure.ac make: Mark the project as foreign to silence autotools errors Oct 17, 2015

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