1. Julien L.
  2. Xstat

Wiki

Clone wiki

Xstat / Home

(version française)

Introduction

Xstat is a statistics generator using GTK+. It analyses a log file and builds a web page with tables and charts. For now, 12 different sorts of statistics are availlable.

To launch Xstat, simply type:

xstat

A simple interface will appear allowing to configure the paramaters used to generate a web page of statistics. Each statsitic can be configured. Just select a statistic and click on the ‘Configure...’ button. A dialog will appear.

Then, a click on the ‘Generate web page’ button will analyse the log file and make a web page of statistics.

When you click on the ‘Generate web page’ button or when you exit the program, the configuration is saved in the file .xstat of your home directory, so that you don’t need to reconfigure all parameters once again.

A faster and easier method to generate a web page is to use the command statistic which doesn’t need the GTK+ librairy. To use it, simply type:

statistic

It will generate a web page of stastistics from the parameters saved in the .xstat file. So you must have launched Xstat once before using this command.

Screenshots

Sreenshot 1

Sreenshot 2

Examples

The first example shows a page with:

  • a background color;
  • a table of lines number;
  • a chart of the lines number;
  • a table of durations;
  • a table of nicks number;
  • a chart of the users number;
  • a table of sessions number.

The second example shows a page with:

  • a background image;
  • a table of actions number;
  • a chart of the lines number in a day;
  • a table of kicks number;
  • a table of kicked users number;
  • a chart of the users number in a day;
  • a table of topics number.

Requirements

  • A UNIX computer (Linux/BSD etc) and C/C++ compiler (gcc)
  • X11 (X Window System)
  • GTK+ 1.0.0+

Note: you can build statistic without GTK+.

Updates

Here are the last versions of Xstat:

  • xstat-1.2.tar.gz

    New makefile (thank you Charlie!); Fixes of some compilations errors and warnings.

  • xstat-1.1.tar.gz

    Add of the French language; Fixes of some bugs.

  • xstat-1.0.tar.gz

    Complete analyse of logs; Generation of a web page of statistics; Twelve statistics availlable; Automatic save and load of the configuration.

Installation

  1. Decompress the tarball:

    tar xvfz xstat-X.X.tar.gz

  2. Enter in the new directory named xstat-X.X:

    cd xstat-X.X

  3. Compile Xstat:

    make

  4. Intall the executables xstat and statistic:

    make install

Notes:

  • You can compile only xstat by typing make xstat.
  • You can compile only statistic by typing make statistic.

Icons and images

An icon (xstat.xpm) and a mini-icon (mini/xstat.xpm) are available in the directory icons/.

A vertical bar, a horizontal bar and a background are available in the directory images/ but you can create your own images to customize your web page.

Known bugs

No bugs have been reported so far but there are certainly a lot. :-)

To-do list

For now, Xstat identifies a person with his address. An identification by nickname could be added.

The possibility to save and load several configurations could be added via a menu bar.

License

Xstat is released under the GNU GPL (General Public License).

Updated