1. Den Server installieren

Lade einfach die Datei runter und installiere sie. Ändere gegebenenfalls die Optionen in der XML Datei und starte das Programm. Der Server ist ein Kommandozeilenprogramm und läuft daher nur in einer Shell / Konsole / Terminal. Es erstellt Log-Einträge, die direkt auf die Konsole ausgegeben werden.

<?xml version="1.0" encoding="utf-8"?>
<Settings xmlnssi="http://www.w3.org/2001/XMLSchema-instance"
  xmlnssd="http://www.w3.org/2001/XMLSchema">
  <IRCName>anon1234</IRCName> <!-- Nickname vom IRC Client -->
  <TempPath>./tmp/</TempPath> <!-- relativer Pfad zum temporären Download Ordner -->
  <ReadyPath>./dl/</ReadyPath> <!--relativer Pfad zum Download Ordner -->
  <IrcRegisterPasswort>password123</IrcRegisterPasswort> <!-- geplant für später -->
  <IrcRegisterEmail>anon@ymous.org</IrcRegisterEmail> <!-- geplant für später -->
  <EnableMultiDownloads>true</EnableMultiDownloads> <!-- multi DL Feature einschalten -->
  <ClearReadyDownloads>false</ClearReadyDownloads> <!-- lösche fertige Downloads aus der DB -->
  <Password>xgisgreat</Password> <!-- Server Passwort -->
  <BackupDataTime>900000</BackupDataTime> <!-- Zeitspanne zum speichern der IRC Daten -->
  <FileHandler>
    <string>.*#mv %PATH% %FOLDER%/_%FILE%</string> <!-- Befehle für fertige Downloads -->
  </FileHandler>
  <StartTCPServer>true</StartTCPServer> <!-- starte den TCP Server -->
  <TcpServerPort>5555</TcpServerPort> <!-- Port vom TCP Server -->
  <StartWebServer>true</StartWebServer> <!-- starte den Webserver -->
  <WebServerPort>5556</WebServerPort> <!-- Port vom Webserver -->
  <StyleWebServer>blitzer</StyleWebServer> <!-- Stil vom Webserver (blitzer oder cupertino) -->
  <AutoJoinOnInvite>true</AutoJoinOnInvite> <!-- sollen invites automatisch betreten weden -->
  <LogLevel>Notice</LogLevel> <!-- LogLevel für die Debug Ausgabe -->
  <StartJabberClient>false</StartJabberClient> <!-- verbinde zum Jabber Server -->
  <JabberServer>jabber.org</JabberServer> <!-- Server des Jabber Benutzers -->
  <JabberUser>user</JabberUser> <!-- Name des Jabber Benutzers -->
  <JabberPassword>password</JabberPassword> <!-- Passwort des Jabber Benutzers -->
</Settings>

Der Jabber Client geht lediglich online und ändert seinen Status. Wenn du den Roster ändern willst, musst du das in einem anderen Client machen.

Der Datei-Handler Befehl ist in zwei Bereiche unterteilt:
Regex # Befehl
Der Teil vor dem Zeichen # ist ein Regex, der den Namen der Datei beschreibt. Für jede Datei auf die dieser Regex zutrift, wird der Teil nach dem Zeichen # ausgeführt.
Die folgenden Strings werden durch die Variablen ersetzt:

%PATH% = kompletter Pfad der Datei, z.B. /the/full/path/to/file_complete.rar
%FOLDER% = kompletter Pfad zum Ordner der Datei, z.B. /the/full/path/to
%FILE%” = kompletter Dateiname, z.B. file_complete.rar
%FILENAME% = nur der Dateiname, z.B. file_complete
%EXTENSION% = nur die Dateiendung, z.B. rar

Datei-Handler blockieren sich gegenseitig. Erst wenn ein Befehl fertig ist, wird der nächste ausgeführt. So kann man zum Beispiel einen Befehl benutzen der eine Datei entpackt und einen anderen der dann die Quelldatei löscht:

<FileHandler>
  <string>.*\.rar#unrar %PATH%</string> <!-- entpackt alle Dateien mit dem Regex: .*\.rar-->
  <string>.*\.rar#rm %PATH%</string> <!-- löscht alle Dateien mit dem Regex: .*\.rar-->
</FileHandler>

oder man kopiert einfach seine TV Sendungen in einen Order und setzt eine Mail ab:

<FileHandler>
  <string>.*Dr\. House.*\.avi#mv %PATH% /media/tv/shows/dr.house/%FILENAME%</string>
  <string>.*Dr\. House.*\.avi#send_mail_command '%FILENAME% ist fertig'</string>
</FileHandler>

2.1. Den Client installieren

Lade einfach die Datei runter und installiere sie. Starte das Programm und verbinde dich zu deinem Server. Du musst dein vorher definiertes Passwort eingeben – andernfalls wird sich der Client nicht verbinden. Wenn der Client verbunden ist, wird der Connect Button deaktiviert und der Disconnect Button aktiviert.

2.2. oder den internen Webserver benutzen

Du musst den GTK Client nicht benutzen – der Server hat einen eingebauten Webserver. Man kann ihn in der Konfigurationsdatei aktivieren, seinen Browser öffnen und auf folgende Seite gehen: http://ip-of-the-server:webserver-port. Dort musst du dein Passwort eingeben und schon hast du die Möglichkeit den Server von deinem aus Browser zu steuern.

3. Server und Channels hinzufügen

Wenn du erst einmal verbunden bist, kannst du IRC Server und Channels hinzufügen. Die Bots und Pakete werden automatisch generiert und aktualisiert.

4. Pakete suchen

…

5. Pakete runter laden

Wenn du ein Paket doppelt anklickst, wird der Server versuchen es herunter zu laden und dir aktualisierte Paket Informationen zuschicken.

9 thoughts on “How to use”

Pingback: LarsFormella.de » Blog Archive » XG 0.2
Pingback: Projekt Homeserver: XDCC -Downloader mit Web-Client (XDCC Grabscher) | Slackblog
Stefano on 9. Januar 2011 at 14:16 said:

Hello, i’m getting always a n exception on Connect().
Moreover on ie the webgui doesn’t work but you already know it

Reply ↓
LANopop on 18. März 2011 at 02:02 said:

wird daran noch gearbeitet? kann zwar die webseite aufrufen, aber die oberfläche funktioniert nicht?

Reply ↓
- Lars on 18. März 2011 at 10:33 said:
  
  Ja wird es. Benutzt du den Internet Explorer? Damit geht es anscheinend nicht. Ich hab allerdings ausschließlich Linux im Einsatz und das macht es etwas komplizierter den Bug zu finden. Probiere mal den Firefox
  
  Reply ↓
LANopop on 18. März 2011 at 12:00 said:

habe chrome und ie 8 ausprobiert… beide zeigen folgendes an http://www7.pic-upload.de/18.03.11/p1cuzm5u95.png

wenn ich dann das gültige passwort eingebe kommt der fehler

EXCEPTION WebServer.OpenClient() read client request: The given key was not present in the dictionary.

bei einem nicht gültigen passwort

EXCEPTION WebServer.OpenClient() password: Password wrong!

und dann schickt er mich auf die url http://localhost:5556/?password=fun

Reply ↓
- Lars on 18. März 2011 at 15:24 said:
  
  Hab grad den Fehler gefunden warum es in Chrome nicht geht. Bei mir funktioniert es jetzt und ich denke mal daran wird es auch beim IE gelegen haben. Ich mach ein neues Release fertig und dann kannst du das nehmen
  
  Die GTK Gui ist eigentlich schon obsolet. Die hat unter Windows eh nie so richtig funktioniert und ich für meinen Teil nehm eh nur noch das Webfrontend.
  
  Reply ↓
LANopop on 18. März 2011 at 12:07 said:

clienten kann ich übrigends überhaupt nicht ausführen unter windows 7, da kackt es sofort ab

event properties:

Faulting application name: XG.Client.TCP.GTK.exe, version: 1.0.0.0, time stamp: 0x4d6b6b2b
Faulting module name: KERNELBASE.dll, version: 6.1.7601.17514, time stamp: 0x4ce7b8f0
Exception code: 0xe0434f4d
Fault offset: 0x0000b760
Faulting process id: 0x%9
Faulting application start time: 0x%10
Faulting application path: %11
Faulting module path: %12
Report Id: %13

falls dir das helfen sollte…

Reply ↓
darkside40 on 27. Oktober 2011 at 13:51 said:

Danke für das schöne Programm, bloss habe ich ein Problem.
Ich habe den XG Server auf meinen Debian Server installiert, er lässt sich ohne Probleme starten.
Bloss wenn ich jetzt einen Server und einen Channel anlege dann bekomme ich kein Botlisting, bentze die WebGui.

Stattdessen erscheint aif der Konsole diese Fehlermeldung:
10/27/2011 1:44:31 PM NOTICE ServerConnect(irc.otakubox.de:6667).JoinChannel(#s4u)
10/27/2011 1:44:31 PM NOTICE ServerConnect(irc.otakubox.de:6667).con_DataReceived() joined channel #s4u
10/27/2011 1:45:04 PM EXCEPTION Connection(irc.euirc.net:6667).Connect() reading: ResourceTemporarilyUnavailable
10/27/2011 1:45:04 PM NOTICE Connection(irc.euirc.net:6667).Connect() end

Ne Idee woran das liegen kann? Habe auch schon verschiedene IRC Server und Channel ausprobiert (Fehlermeldung oben ist von zwei Channeln, aber verhalten ist immer das gleiche).

Reply ↓