DistributionGuides

From AWN Wiki

[edit] Ubuntu

[edit] Hardy Heron (8.0x) and later

As of version 0.2.1, Awn has been accepted as a package in universe/gnome. The awn-extras (applets) package is not available in Hardy universe/gnome. If it is required, use one of the alternate methods to install it.

Awn can be installed by simply running the following in the terminal:

 sudo apt-get install avant-window-navigator

It has been reported that in some cases, the dbus-x11 package is not installed automatically and must be installed manually. This is most likely due to Debian's guidelines on dependencies.

[edit] Gutsy Gibbon (7.10)

Version 0.2.1 is available in the gutsy-backports repository. To enable this repository, go to "System → Administration → Software Sources" in the Administration menu, "Updates" tab, and check "Unsupported updates (gutsy-backports)". Then, it can be installed via Synaptic or Adept, or by simply running the following in the terminal:

 sudo apt-get install avant-window-navigator awn-manager

[edit] Testing Package Archive

The Awn developers have a Personal Package Archive (PPA). The supported versions of Ubuntu are Feisty, Gutsy, Hardy, Intrepid, and Jaunty. The sources.list entries needed for each version can be determined using the dropdown list on the PPA site. The packages provided include avant-window-navigator-trunk, awn-manager-trunk, and awn-extras-applets-trunk. For more information, please see the forum thread.

[edit] Quick Installation Guide

1. Open the PPA page (linked above) and select your Ubuntu version from the dropdown.
2. Open the "Software Sources" configuration dialog, located in System → Administration → Software Sources.
3. Click on the "Updates" tab and enable the "Recommended Updates" for your distribution. For example, if you're running Gutsy (7.10), then you would enable "Recommended Updates (gutsy-updates)".
4. Click on the "Third-Party Software" tab.
5. For each line from the gray box on the PPA page, copy it, click on the "Add" button in "Software Sources", paste the line into the new dialog box, and press OK.
6. Back in the tab, make sure that both of the new entries are checked.
7. Follow the instructions at the Launchpad PPA help page to add the PPA's key to your system. Note that they provide both a text and screencast version of the instructions.
8. You can now close the Software Sources dialog.
9. Open the "Synaptic Package Manager", located in System → Administration → Synaptic Package Manager.
10. Click the "Reload" button. This will download the new Awn package information.
11. If you have already installed Awn from another source, uninstall that first. This will not change or delete your current settings. While the packages are supposed to automatically replace Awn packages from different sources, we have had reports that it does not occur consistently.
12. Install the packages named above.

[edit] TheEsylum.com's ppc repository (Ubuntu Feisty and Gutsy)

There is a repository maintained by Aantn for Ubuntu ppc. You can find instructions on his blog here.

[edit] getdeb.net

There is a set of release .deb files at getdeb.net for both Feisty and Gutsy, in both 32-bit and 64-bit editions. These are to be installed via the gdebi installer GUI or via the command line dpkg -i [pkgname.deb].

[edit] Debian

[edit] Official repository

There is now an official Debian package for Awn in Sid/Unstable and Lenny/Testing. To install, run the following command:

sudo apt-get install avant-window-navigator

[edit] Arearelax repository

Packages from awn trunk are available in Arearelax's repository (Italian version). Just add this line to your /etc/apt/sources.list:

deb http://www.arearelax.org/awn/ ./

To install it:

sudo apt-get update && sudo apt-get install avant-window-navigator-trunk

[edit] Do-It-Yourself Debian/Ubuntu Packages

In the case that your version of Debian/Ubuntu/Other-Debian-derived-distribution does not have a sufficiently recent version of Awn (we recommend 0.2.1 or later), there is a .deb package building guide on this wiki.

[edit] Gentoo

[edit] Portage

As of version 0.2.1, both Awn and awn-extras are in Portage. If you're running a stable arch and Awn has not been stabilized for it yet, you will need to unmask it yourself. To do so, add the following lines to /etc/portage/package.keywords:

gnome-extra/avant-window-navigator
gnome-extra/avant-window-navigator-extras

Then, simply run this from the command line (in the example, the package manager used is emerge):

# emerge avant-window-navigator avant-window-navigator-extras

[edit] Desktop Effects Overlay

The desktop effects overlay is the successor to the retired xeffects overlay. It provides "live" ebuilds, which means that you can install the latest development version of Awn via your favorite Portage-compatible package manager. For more information about overlays, Gentoo has provided a user guide that should be followed if you have not installed from an overlay before. To install packages from the overlay first follow the user guide, then run

layman -a desktop-effects

to add the overlay. Since the development ebuilds have no keywords, you will need to add them yourself. To do so, add the following lines to /etc/portage/package.keywords:

gnome-extra/avant-window-navigator **
gnome-extra/avant-window-navigator-extras **

Then, install the packages as seen in the #Portage section.

[edit] Mandriva Linux

AWN is available in the official /contrib section of the Mandriva Linux repositories, for all releases since Mandriva Linux 2007 Spring. The package is regularly updated to the latest available code via the /backports repository. To install the version originally shipped with the release of Mandriva Linux you use, follow the instructions at the Mandriva Wiki to enable the official repositories, and then install the avant-window-navigator package. To install the latest available version from the /backports repository, follow the instructions to enable the /backports repositories, and then install or update the avant-window-navigator package.

[edit] Fedora

[edit] F7 Kirov Repository

First, according to https://bugzilla.redhat.com/bugzilla/show_bug.cgi?id=238863 AWN has been accepted for inclusion in the offical Fedora Repositories! Looking at the spec file it seems to be just core at the moment. We may want to get on them to include awn-extras as well.

Instructions copied wholesale from http://www.planetblur.org/hosted/awnforum/index.php?shard=forum&action=g_reply&ID=214&page=1

Log into root:

su

Remove any previous AWN installations:

rpm -e avant-window-navigator

Add the Kirov repository to Yum repo list:

cd /etc/yum.repos.d/
wget http://www.csc.calpoly.edu/~admiller/repo/pub/kirov.repo
rpm --import http://www.csc.calpoly.edu/~admiller/repo/pub/RPM-GPG-KEY-Kirov

Install:

yum install avant-window-navigator awn-applets-core

[edit] F8+ Repositories

• AWN is now included in the Fedora repositories for version 8 and up. To install it, login as root:

su

(Alternatively: sudo -s)

• Remove any previously installed packages of awn-applets-core:

rpm -e awn-applets-core

• Install/update AWN:

yum install avant-window-navigator awn-extras-applets

[edit] openSUSE

[edit] Packman Repository

OpenSUSE 10.2/10.3 RPMs are available at the Packman Rrepository, maintained by Andrea Florio (Anubis). You can also download the packages manually. If the repository is not in your list add it using YaST, zypper, or another compatible RPM manager. Help with these tools is beyond the scope of the wiki. To add the repository with zypper, run the following in a terminal:

• openSUSE 10.2:

sudo zypper addrepo http://packman.iu-bremen.de/suse/10.2/ 'Packman Repository'

To import the GnuPG key issue the following command as root:

rpm --import http://packman.unixheads.com/suse/10.2/gpg-pubkey-1abd1afb.asc

• openSUSE 10.3:

sudo zypper addrepo http://packman.iu-bremen.de/suse/10.3/ 'Packman Repository'

To import the GnuPG key, issue the following command:

sudo rpm --import http://packman.unixheads.com/suse/10.3/gpg-pubkey-1abd1afb.asc

To install AWN from the command line, run the following:

sudo zypper in avant-window-navigator

[edit] Arch Linux

You can download the PKGBUILD in the AUR.