1. Wymagania.

Aby korzystać z EKG, należy mieć dostęp do konta shellowego, jeśli nie ma na nim zainstalowanego EKG i libgadu, to wymagany jest dostęp do kompilatorów, zainstalowany ncurses lub readline.

2. Instalacja libgadu.

Korzystając z svn:

svn co http://toxygen.net/svn/libgadu/trunk libgadu
cd libgadu
./autogen.sh #(opcje jak przy ./configure)
make
make install

W przypadku braku uprawnień administratorskich, polecam zapoznać się z libgadu.txt – wyczerpującej informacji o instalacji libgadu

3. Instalacja EKG

svn co http://toxygen.net/svn/ekg/trunk ekg
cd ekg
./autogen
make make install

W przypadku braku uprawnień administratorskich, polecam zapoznać się z README – wyczerpującej informacji o instalacji EKG

4. Konfiguracja EKG

Po uruchomieniu EKG za pomocą polecenia ekg, przystępujemy do podstawowej konfiguracji programu.

Wszystkie opcje konfiguracyjne zmieniamy za pomocą polecenia set zmienna wartość

Najpierw określany nasz numer gadu:

set uin nasz_numer

Następnie wpisujemy hasło:

set password

Teraz możemy już połączyć się z serwerem za pomocą polecenia

connect

Polecam zapoznać się z listą zmiennych oraz ich opisem, i skonfigurować podstawowe parametry EKG.
Oczywiście, do komfortowej pracy z programem potrzebna jest też znajomość poleceń służących do obsługi programu, wpisanie help wyświetli listę wszystkich dostępnych poleceń, help polecenie wyświetli dokładne informacje o poleceniu.

README raz jeszcze przyjdzie z pomocą osobom niezaznajomionym z interfejsem ncurses.

5. Dostosowywanie EKG

Każdy użytkownik Gadu-Gadu wcześniej lub później zetknie się z zjawiskiem SPAM’u.
Dlaczego więc nie wykorzystać drzemiącego w EKG potencjału?
Wystarczy wykorzystać opcję -c, tworzącą nazwany potok, dzięki któremu możemy podpinać zewnętrzne skrypty/programy pod EKG, oraz skorzystać z wbudowanej obsługi zdarzeń, dzięki którym będzie możliwe wykonanie tychże zewnętrznych skryptów. Można też napisać własny skrypt w pythonie EKG posiada wbudowaną obsługę takich skryptów, ja jednak postanowiłem skorzystać napisać prosty skrypt w bashu.

Wyobraźmy sobie, że chcielibyśmy dla każdego użytkownika który przesyła nam jakiś link przesłać określoną wiadomość (”Nie lubię linków”) oraz zablokować jego numer.

Uruchamiamy więc EKG z opcją tworzącą nazwany potok:

ekg -c ~/potok

Tworzymy zdarzenie w ekg pozwalające sprawdzać każdą wiadomość pod kątem SPAM’u:

on -a msg,chat,query * ^exec bash ~/antypam.sh "%2 >> %4"

Tworzymy skrypt antyspam.sh sprawdzający czy w treści wiadomości znajduje się ‘http’, o treści:

#!/bin/bash
spam=`echo $*|grep -i -o 'http'`
if [ -n "$spam" ]
 then
  echo "/query `echo $*| gawk
  '{print $1}'` Nie lubię dostawać linków na GG." >> ~/potok
  echo "/block `echo $*| gawk '{print $1}'`";
fi

A jeśli mamy ochotę dostawać wiadomości z gadu smsem korzystając z powiadomienia o poczcie?

Dodajemy zdarzenie w ekg:

on -a msg,chat,query * ^exec bash ~/gg2sms.sh "%2 >> %4"

Tworzymy skrypt gg2sms.sh wysyłający emaila na skrzynkę z powiadamianiem sms o nowej poczcie:

To: #mail
From: #mail
Content-type: text/plain; charset=iso-8859-2

$*
XX

Możliwości wykorzystania potencjału EKG są praktycznie nieograniczone, ja osobiście korzystam z następującego skryptu służącego do filtrowania spamu oraz wysyłania wiadomości smsem przez konto email z obsługą powiadamiania o nowej poczcie

Kilka innych przydatnych skryptów mojego autorstwa można ściągnąć z działu EKG download na mojej stronie