Go to file
2019-12-30 05:32:14 +01:00
data Import the latest scripts from DeforaOS configure 2019-12-18 05:15:03 +01:00
doc Register settings(1) 2019-12-18 05:16:17 +01:00
include Update the copyright notice 2018-02-14 19:14:39 +01:00
po Update the translations 2019-12-18 05:06:05 +01:00
src Let the applet names be translated 2019-12-30 05:32:14 +01:00
tests Register a couple more tests 2019-12-18 05:15:50 +01:00
tools Import the latest scripts from DeforaOS configure 2019-12-18 05:15:03 +01:00
.gitignore Add config.{h,sh} 2015-04-04 17:03:22 +02:00
COPYING Added GPL version 3 license terms 2010-07-25 07:59:02 +00:00
project.conf About to release Panel 0.4.0 2019-12-18 06:00:47 +01:00
README.md Add a title for the "Documentation" section 2017-09-15 00:21:49 +02:00

DeforaOS Panel

About Panel

This program is meant to display an arbitrary number of desktop panels, with support for one per edge of the screen at the moment. Each panel can then host a number of applets, implemented as plug-ins to the main program.

A number of additional utilities is also available, allowing tighter integration of external applications, as well as when responding to system events (notifications...).

Documentation

Each of these tools, as well as Panel itself, are documented in a series of manual pages. They are also available in the HTML format.

Compiling Panel

The current requirements for compiling Panel are as follows:

  • Gtk+ 2.4 or later, or Gtk+ 3.0 or later
  • DeforaOS libDesktop
  • DeforaOS Browser
  • an implementation of make
  • gettext (libintl) for translations
  • docbook-xsl for the documentation (optional)

With these installed, the following command should be enough to compile Panel on most systems:

$ make

On some systems, the Makefiles shipped can be re-generated accordingly thanks to the DeforaOS configure tool.

The compilation process supports a number of options, such as PREFIX and DESTDIR for packaging and portability, or OBJDIR for compilation outside of the source tree.

Extending Panel

Applets for the Panel program can be written according to the API definitions installed and found in <Desktop/Panel.h> (here in include/Panel.h).

A sample applet can be found in src/applets/template.c.

Further applets can also be found in the DeforaOS Integration project.

Distributing Panel

DeforaOS Panel is subject to the terms of the GPL license, version 3. Please see the COPYING file for more information.