Awn Extras:Installation

From AWN Wiki

Jump to: navigation, search

Contents

[edit] Installing Awn Extras

This is a guide for installing the applets from the Awn Extras project. It is preferred that you try out the #Binary Pages/Repositories first. If it doesn't work for you or your distribution isn't listed, then try #Building From Source. Note that this method assumes that you are comfortable using and navigating with the terminal.

[edit] Binary Packages/Repositories

[edit] Ubuntu

Note: Although the official Ubuntu repositories may contain the dock, Awn Extras unfortunately did not make it into either the official Gutsy or Hardy repositories.
  • The Awn Testing Team provides a package for the applets called awn-extras-applets-trunk.
  • reacocard provides a package for the applets called awn-core-applets-bzr.

[edit] Gentoo

  • As of version 0.2.1, awn-extras is in the official portage repository: 
emerge gnome-extra/avant-window-navigator-extras
  • The desktop-effects overlay provides the awn-extras package which automatically installs from the latest development version (note that there are USE flags available): 
emerge gnome-extra/avant-window-navigator-extras

[edit] Mandriva

  • If installing from the /backports repository for Mandriva Linux 2008, or from any repository on Mandriva Linux 2008 Spring or later, you can also install the awn-extras-applets package.

[edit] openSUSE

  • The Packman repository provides the awn-extras-applets package for openSUSE 10.3 only. It will be made available for openSUSE 10.2 as soon as possible. To install, run the following command in the terminal: 
sudo zypper in awn-extras-applets

Alternatively, you can download the package manually.

[edit] Fedora

  • The Fedora 8 updates repository contains the awn-extras-applets package. 
yum install awn-extras-applets

[edit] Building From Source

[edit] Requirements

Here are the packages that are required to compile and install Awn Extras's applets, for a number of Linux distributions.

Note: This assumes that you've installed all of the requirements for Awn.
Warning: Some of the dependencies (the Python ones) listed are not required to compile the applets. They are listed because as of 0.2.1, if you don't have the dependencies for a Python applet, the applet will "crash" and a white line will appear in place of the applet. The error message with regards to why the applet crashed is only logged if you run Awn from the command line.

The dependencies have been moved into an easy-to-read dependency matrix.

[edit] Instructions

(Note: Colored, monospaced font boxes indicate that you need to run this in a terminal, unless otherwise noted)

As of version 0.2.1, there are two methods to get the source code for Awn Extras:

  • Release versions are generally more stable.
  • Development versions can have more features, but are considered to be more unstable.

The instructions for both methods are very similar, so it is clearly marked when the two deviate.

1.

(Release) (Development)
Download the source code from Launchpad. Download the source repository via bzr: 
bzr branch lp:awn-extras awn-extras

2. Change the directory to where the root directory of the applets: 

cd awn-extras

3a. Make sure the build system can find all of the development files necessary. If you did not install avant-window-navigator into /usr , you will probably need to modify at least one environment variable. Run the following command: 

pkg-config --modversion awn

If the output looks like this (Note: don't try to run this, it's an error message): 

Package awn was not found in the pkg-config search path.
Perhaps you should add the directory containing `awn.pc'
to the PKG_CONFIG_PATH environment variable
No package 'awn' found

then you need to run the following (where [PREFIX] is the prefix that you installed awn to, defaults to /usr/local): 

export PKG_CONFIG_PATH="$PKG_CONFIG_PATH:[PREFIX]/lib/pkgconfig"

3b.

(Release) (Development)
Configure the build system for the applets: 
./configure

It is strongly encouraged that you install the applets to the same directory as you did for avant-window-navigator. So, if you had installed it in a non-default location (/usr/local is the default), run the script like so: 

./configure --prefix=[PREFIX]

If you need to recompile the applets so that you can file a bug on them, you should instead run the script like so: 

CFLAGS="-ggdb" ./configure [configure flags]
Generate the build system's files (Note: this will also run ./configure for you): 
./autogen.sh

It is strongly encouraged that you install the applets to the same directory as you did for avant-window-navigator. So, if you had installed it in a non-default location (/usr/local is the default), run the script like so: 

./autogen.sh --prefix=[PREFIX]

If you need to recompile the applets so that you can file a bug on them, you should instead run the script like so: 

CFLAGS="-ggdb" ./autogen.sh [configure flags]
Note: There are two configure flags for Awn Extras that you may wish to be aware of: --without-gnome and --without-gconf disable building applets that specifically have dependencies on Gnome-specific libraries and GConf, respectively. There are no configure flags analogous to Awn's --with-desktop and --with-vala, as these settings are determined by your Awn installation.

4. Compile the applets: 

make

5. Install the applets (Note: you may need to run this as root, via sudo or su): 

make install

6. (Development only) To update your source tree so that you have the latest source code from the repository, run the following command: 

bzr pull

If you have added some changes to the tree (such as patches from the forums), you may have to revert the patches: 

bzr revert

and then run bzr pull. Then, repeat steps 3b to 5.

[edit] Troubleshooting

  • I'm getting errors during the make or make install sections! - Make sure the dependencies are present as listed in the Requirements section.
Retrieved from "http://wiki.awn-project.org/Awn_Extras:Installation"
Personal tools