Applets
From AWN Wiki
[edit] About Applets
Applets are small programs that live on your dock and provide you with instant access to the information you want. You can control your music player, receive notification on new mail, or see the weather forecast. Applets allow you to have control of your computer, right from the dock.
Applets can be found in the Applet Gallery, where you can browse a list of all the available applets. Many applets are found in awn-extras. These applets have been included into the core distribution of AWN and are considered stable and useful. Many others, however, are made by third party developers. These developers can list their applets in the gallery. Remember that the AWN team itself supports only the applets in awn-extras and all other applets are installed at your own risk. For support of third-party applets, contact the applet's developer.
Once downloaded, most applets are installed pressing the Install button on the applets page of awn-manager and selecting the package you would like to install. Alternatively they can be installed by dragging the package into the 'Available Applets' area of the applets section in AWN Manager. Note that Python applet packages are normally distributed in "applet.awn" or "applet.tar.gz" form. Using the buttons on that page you can 'activate', 'deactivate', and 'delete' the applets of your choice. Other applets may have different instruction for installation. In general, follow any README or INSTALL file if one is available.
[edit] Applet Development
Applets can be developed in C, Python, or Vala. Python development is, however, recommended, as it's easier for those who aren't used to C, the applets generated are less likely to crash, and allows for easy packaging and shipping. Applets developed in C or Vala must be compiled, while Python applets are already ready to be automatically installed by awn-manager.
[edit] Related Pages
- AWN API: Documentation of the API that AWN applets can use.
- Applet Development Guidelines: A guide for developers to follow when writing Awn applets.
- Awnlib: A library that wraps around the default API.
- Writing Applets With awnlib: A tutorial for developing with awnlib.
- Example Python Applet: A simple Python applet for AWN.
- Applet Preferences Dialog: A generic applet preferences dialog.

