spacetray/README.md

spacetray
=========

A panel Applet using GTK2 for showing the Status of a Hackerspace. Compatible with the SpaceAPI version >= 0.13.


Installation:
-------------

Requirements:

- Standard tools like gcc, pkg-config etc.
- curl
- gtk+-2.0
- json-c
- libnotify - Only needed when compiling with libnotify support.

Use the following command for getting the sources:

    git clone https://github.com/hanez/spacetray.git

Change into the new directory:

    cd spacetray

To compile the sources just run:

    make

This will compile dooris with libnotify support.

If you don't want notifications run the following command:

    make nonotify

Installation
------------

Just copy "spacetray" to a folder in your $PATH. I do:

    cp ./spacetray ~/bin/

You can copy the file to /usr/bin to make it available to all users but I don't. If you want that just run:

    sudo cp ./spacetray /usr/bin/

Configuration:
--------------

Configuration needs to be done before compiling. There are some parameters you can set in the head of the spacetray.c file where variables are declared. A configuration file will at this point make no sense.

Usage:
------

Run spacetray with:

    ./spacetray &

Or if in your $PATH:

    spacetray

Status Icon "Pesthoernchen" colors:

- Red = Door closed
- Yellow = Door open

Themes:
-------

You can create your own icon theme by generating a C header file containing the icons as "static const GdkPixdata" data structure.

This can be done using the following commands:

    gdk-pixbuf-csource --struct PATH_TO_OPEN_IMAGE > ./themes/THEME_NAME.h

    gdk-pixbuf-csource --struct PATH_TO_CLOSED_IMAGE >> ./themes/THEME_NAME.h

Afterwards you need to rename the first generated struct to:

    icon_open_pixbuf

The second must be renamed to:

    icon_closed_pixbuf

in:

    ./themes/THEME_NAME.h

You can then use your custom icon theme when changing the line:

    #include "themes/lock.h"

to:

    #include "themes/THEME_NAME.h"

in:

    ./spacetray.c