mention where BUGS are and how to report bugs
[homepage.git] / hacking / software / gnome-awesome-applet.mdwn
1 [[!meta title="GNOME Awesome Applet"]]
2 # GNOME applet to interact with the Awesome window manager
3
4 [Awesome](http://awesome.naquadah.org) it's an awesome window manager.<br />
5 [GNOME](http://www.gnome.org) it's an awesome desktop environment.
6
7 Problem is, not many people believe in both. So, if you subscribe to both the
8 above statements, you might feel a bit on your own on how to smoothly integrate
9 Awesome and GNOME.
10
11 One of the first things you'll notice is that most other Awesome users are
12 happy with the wibox while you really want to use the GNOME panel. You can
13 easily disable the wibox and keep your beloved GNOME panel, but you'll lose
14 that way the ability to interact with Awesome in various ways, such as
15 monitoring the current layout, sending Lua snippets to Awesome, etc.
16
17 Worry no more, cause **GNOME Awesome Applet** comes to the rescue.
18
19 GNOME Awesome Applet is an applet for the GNOME panel to enable interaction
20 with the Awesome window manager in a GNOME-ish way.
21
22 <div class="alert">
23   <p>Code is still heavily <strong>under development</strong>; no proper
24   release has been made yet, so your best chance is fetching code from Git and
25   running it. If you are on a Debian-based system, you can easily try out the
26   applet in a non-intrusive way by using the provided Debian packaging (look
27   into the "debian" branch).
28   </p>
29   <p>If you find the applet useful ... patches are welcome!</p>
30 </div>
31
32 ## Development
33
34 * [Git repository](http://git.upsilon.cc/cgi-bin/gitweb.cgi?p=gnome-awesome-applet.git)
35 * [BUGS](http://git.upsilon.cc/cgi-bin/gitweb.cgi?p=gnome-awesome-applet.git;a=blob_plain;f=BUGS;hb=HEAD)
36   are currently tracked in a
37   [plain text file](http://git.upsilon.cc/cgi-bin/gitweb.cgi?p=gnome-awesome-applet.git;a=blob_plain;f=BUGS;hb=HEAD)
38   in the Git repo. Please [mail me](mailto:zack@upsilon.cc) to report new bugs
39   / desired features, did I mention that patches are welcome?