Next Previous Contents

## 4. Anwendung

## 4.1 Die GUI zum ersten Mal benutzen

Die GUI starten: Aus historischen Gründen heisst das GUI Programm 'ed2k_gui' (aber der Name des Projekts ist 'ed2k-gtk-gui'). Es gibt mehrere Wege die GUI zu starten: Auf der Befehlszeile, in einer Konsole oder einem Terminal Fenster (wie xterm, konsole etc.), tippe einfach

> `

>     %ed2k_gui

> `

So musst du die GUI auch starten, wenn etwas nicht funktioniert (weil dann zusätzliche Fehlermeldungen auf der Konsole ausgegeben werden).

Alternativ kann man in Gnome oder KDE auch Alt+F2 drücken und 'ed2k_gui' in dem Dialog eingeben. Das sollte die GUI auch starten.

Falls du die GUI zum ersten Mal benutzt wirst du keine Server in deiner Serverliste haben. Navigiere zur Server Seite, klick auf den 'Serverliste holen' Knopf und warte ein paar Sekunden. Wenn du Glück hast wirst du eine Liste von Servern sehen. Falls das nicht geklappt hat wirf einen Blick auf die Status Seite, um zu sehen, was schief gelaufen ist. Wenn du gezwungen bist einen Http Proxy Server zu benutzen, schau dir den Fragen und Antworten Abschnitt an, um herauszufinden, wie man das einstellt.

Da du jetzt Server hast, klick auf den 'Verbinden' Knopf, um dich mit einem der Server zu verbinden.

## 4.2 Dateien tauschen

eDonkey2000 ist ein Programm zum Tauschen von Dateien, also solltest du ein paar Dateien zur Verfügung stellen. Es ist nicht möglich keine Dateien bereitzustellen. eDonkey2000 kann Teile von Dateien, die gerade heruntergeladen werden bereitstellen, bevor diese komplett geladen sind. Also auch wenn du nichts zum Tausch anbietest wirst du immer die Dateien, die du gerade runterlädst auch zum Download anbieten.

Es ist nicht möglich einzelne Dateien anzubieten, das geht nur mit Verzeichnissen oder ganzen Verzeichnisbäumen. Wenn du auf die Shared Seite klickst wirst du links die Verzeichnisse und rechts die Dateien sehen, die du dem Rest der Welt anbietest. Um etwas hinzuzufügen musst du im Pfad Fenster rechtsklicken und entweder Verzeichnis in Share oder Verzeichnisbaum in Share auswählen. Das zweite fügt ein Verzeichnis mit allen Unterverzeichnissen hinzu.

Wenn du Verzeichnisse mit Dateien, die du noch nie mit eDonkey angeboten hast hinzufügst werden die Dateien 'gehasht' (eine Checksumme - Hash - wird berechnet), um sie zu identifizieren. Das wird auf alten Computern einige Minuten dauern, aber weder die GUI noch den Core blockieren

Bitte gib auch Dateien frei!

### Wie viele Dateien soll ich freigeben?

Zuerst mußt du wissen, daß deine Downloads automatisch freigegeben sind. Wie viel du zusätzlich freigeben solltest hängt von deiner Upload Bandbreite ab.

Wenn du grosse Dateien (mehrere Hundert MB) anbietest, die bis jetzt noch nicht im eDonkey Netzwerk zu haben sind, stell dich bitte darauf ein diese Datei einen längeren Zeitraum anzubieten, damit die anderen auch eine Chance haben die Datei ganz runterzuladen. Wenn du dir da nicht sicher bist: Bitte biete keine solchen grossen Dateien an! Es ist schon sehr frustrierend, wenn man eine grosse Datei runterlädt, die dann plötzlich aus dem Netz verschwindet kurz bevor man sie komplett hat.

## 4.3 Konfiguration

Es gibt ein paar Einstellungen, die du auf dein Bedürfnisse abstimmen solltest.

Maximale Download Geschwindigkeit und maximale Upload Geschwindigkeit: wahrscheinlich erklären sich diese beiden von selbst. Wie auch immer; du solltest wissen, dass eDonkey ein Verhältnis System benutzt, was bedeutet: die maximale Download Geschwindigkeit hängt von der eingestellten maximalen Upload Geschwindigkeit ab. Wenn für den Upload 10kB/s oder mehr eingestellt sind, kannst du so schnell wie möglich runterladen (Download mit 0kB/s = ohne Beschränkung). Wenn du weniger als 10kB/s Upload erlaubst, wird dein max. Download automatisch auf `max. Upload * 3` oder `max. Upload * 4` (von der Geschwindigkeit abhängig) gesetzt.

Wenn du eine DSL/Cable Verbindung hast, wird die Bandbreite für Download und Upload normalerweise kilobit pro Sekunde (kbps) angegeben, zum Beispiel 786/128. Teile diese Zahlen durch acht, um deine Verbindungsgeschwindigkeiten in kiloByte pro Sekunde (kB/s) zu erhalten. In unserem Beispiel wären das 96kB/s Download und 16kB/s Upload. Das sind die technisch maximalen Geschwindigkeiten deiner Verbindung. Aber es gibt einen gewissen Overhead (zusätzliche Daten die gesendet werden müssen) wegen den verschiedenen Netzwerkschichten und -protokollen die benutzt werden, also sind die tatsächlichen Geschwindigkeiten wohl ein wenig niedriger. Ausserdem sollte beachtet werden, dass für jedes empfangene Paket eine Bestätigung an den Sender geschickt werden muss. Also solltest du deinen max. Upload niedriger als den max. Verbindungsupload einstellen (ziehe mindestens 3-6kB/s ab). Andernfalls wird auch dein Download in den Keller sinken und du kannst dann auch nicht mehr im Internet surfen!

Maximale Anzahl von Verbindungen: Das ist die maximale Anzahl von Verbindungen (Sockets) die von eDonkey genutzt werden soll. Das ist aber nur eine 'Empfehlung' an eDonkey, manchmal könnte die tatsächliche Anzahl diesen Wert für kurze Zeit übertreffen. Die Voreinstellung ist 45 Verbindungen. Da du aber ein *nix System betreibst und kein besch****nes System aus Redmond solltest du hier irgendwas zwischen 350-550 einstellen.

'Incoming' Verzeichnis: in dieses Verzeichnis werden deine Dateien verschoben, wenn sie komplett heruntergeladen sind. Es ist nicht empfehlenswert ein Netzlaufwerk dafür zu benutzen.

'Temp' Verzeichnis: hier werden deine Dateien gelagert während sie runtergeladen werden. Wenn du genug Plattenplatz hast, kannst du das 'Incoming' und das 'Temp' Verzeichnis in die selbe Partition legen. 'Incoming' und 'Temp' sollten verschiedene Verzeichnisse sein.

Es gibt noch viel mehr Optionen, aber das sind die wichtigsten. Mehr Optionen findest du in den über Rechtsklicks zugänglichen Pop-Up Menüs auf der Download und der Server Seite.

## 4.4 Die Serverliste pflegen (nur eDonkey2000) Dieser Abschnitt bezieht sich nur auf eDonkey2000. Overnet ist ein Netzwerk ohne Server.

Im eDonkey Netzwerk gibt es keine zentralen Server wie im alten Napster System oder anderen File-Sharing System(Tausch-Systeme), aber es funktioniert (noch) nicht ganz ohne Server wie Gnutella). Jeder kann einen eDonkey Server betreiben und viele davon benutzen dynamische IPs, die regelmässig wechseln.

Das bedeutet, dass du dich um deine Serverliste kümmern und sie regelmässig aktualisieren musst.

Wenn du mit der rechten Maustaste in das Serverlisten Fenster klickst, erhältst du ein Menü, mit dem du über HTTP neue Server von Webseiten mit Serverlisten holen kannst. Diese werden zu deiner eigenen Serverliste hinzugefügt.

Es sind immer mehrere hundert Donkey-Server im Netz.

TODO:

Serverlisten Optionen --- immer verbunden bleiben --- tote Server

## 4.5 Suchen

Wenn du auf die Suchen Seite klickst kannst du auswählen, was du suchen möchtest (Alles, Audio, Video...). Tipp deine Suchanfrage ein und drück Enter.

eDonkey2000: Der Server, mit dem du verbunden bist, wird nach wenigen oder auch vielen Sekunden antworten (einige Server sind überlastet und brauchen ihre Zeit zum Antworten, meistens wegen Bandbreite), also hab Geduld. Nachdem du ein Ergebnis erhalten hast (keine Dateien ist auch eins) kannst du auf 5x erweitern klicken, um die Suchanfrage an 5 weitere Server zu stellen. Um noch mehr Server zu fragen klickst du einfach öfter.

Overnet: Overnet benutzt zwar keine Server, wird aber dein Zeug trotzdem finden. Overnet ist ein dezentralisiertes Netzwerk und deshalb können aufeinanderfolgende Suchläufe unterschiedliche Ergebnisse liefern.

Mit einem Doppelklick oder das Rechtsklick-Menü startest du einen Download.

Anmerkung: Es gibt keinen auf alle Server erweitern Knopf und es wird auch keinen geben, weil die von Donkey Benutzern verwalteten Server die Menge von Anfragen nicht verarbeiten können, die enstehen würden, wenn jeder Benutzer jeden Server nach Ergebnissen fragen würde, wie es der Bot (für Windoze) getan hat. Zu der Zeit war das Netzwerk stark belastet und viele Server Admins wurden wirklich böse, weil sie die Anzahl maximaler Benutzer jeden Tag senken mussten. Frag nicht nach dieser Option; es wird sie nicht geben!

Wenn du nach etwas suchst, was sehr viele Ergebnisse liefert (z.B. 'mp3'), wirst du herausfinden, dass du nur 200 Ergebnisse auf einmal von deinem Hauptserver bekommst. Falls es mehr Ergebnisse gibt, wird der 'mehr' Knopf aktiviert und du kannst die nächsten 200 Ergebnisse erhalten, wenn du draufklickst.

Du kannst Dateien in eine 'Blacklist' schreiben. Diese Dateien werden dann in Zukunft nicht mehr unter den Suchergebnissen angezeigt. Die GUI benutzt dafür die Datei 'gui_blacklist' im '.ed2k_gui/' Unterverzeichnis deines Heimatverzeichnisses.

Die GUI kann Dateien filtern, die bestimmte Wörter oder Zeichenfolgen enthalten. Dafür musst du eine Datei 'gui_filters' im Verzeichnis ' /.ed2k_gui' erstellen (Das ist ein verstecktes Verzeichnis, es ist also möglich, dass dein Dateimanager es nicht anzeigt, bis du dies einstellst). Diese Datei sollte genau einen zu filterndern Ausdruck pro Zeile enthalten. Wenn eine Zeile mit einem '*' (Stern) beginnt, wird die GUI alle Ergebnisse filtern, die den Ausdruck als ganzes Wort enthalten. Wenn die Zeile nicht mit einem Stern beginnt, wird die GUI alle Ergebnisse filtern, die die Zeichenfolge in ihrem Dateinamen haben. Zum Beispiel:

> `

>     deutsch
>     german
>     *de
>     *sex

> `

in deinem Filter wird alle Ergebnisse filtern, die 'de' und 'sex' als Wort enthalten (z.B. 'sex in the bathroom (de).avi'), aber Ergebnisse wie 'fun in essex.avi' oder 'deranged band - deranged song.mp3' anzeigen.

### Andere Methoden, um Dateien zu finden und Freunden von den Dateien zu erzählen, die du anbietest

Ein Weg, um Dateien im eDonkey Netzwerk zu finden, ist, wie oben beschrieben, das Netzwerk zu durchsuchen. Das ist aber nicht immer der beste Weg, weil...

- Dateien ein Fake sein können (der Name der Datei entspricht nicht dem Inhalt)
- man nicht immer alles Wissenswerte über eine Datei erfährt (z.B. Qualität oder Sprache eines Films)
- die Server manchmal überlastet sind und suchen schrecklich langsam werden kann

Die gute Nachricht ist, dass jede Datei im eDonkey200 Netzwerk eindeutig identifiziert werden kann. Das geht mit einem 'Hash' (im Prinzip eine sehr grosse Zahl), der für jede Zahl einmalig ist, und der Dateigrösse. Diese beiden Informationen reichen aus, um eine bestimmte Datei im Netzwerk zu finden. Mit diesen Informationen kannst du beispielsweise einem Freund mitteilen, was für Dateien du anbietest, und er kann die Datei finden ohne die Suche zu benutzen. Normalerweise werden die Dateien als so genannter 'ed2k-link' weitergegeben. ed2klinks sehen so aus:

> `

>     ed2k://|file|nur_ein_Beispiel.mp3|3949232|ab349abf7b531c21980a0f22eeef7e21|

> `

Der erste Parameter ist der Dateiname, der zweite die Grösse der Datei in Byte und der dritte Parameter ist der Hash in hexadezimaler Form mit genau 32 Stellen, die 16 Werte annehmen können: 0-9 und a-f.

In der Downloadliste, den Suchergebnissen und den Dateien im Share kannst du über das Rechtklick-Menü die Option 'ed2k-link in Status und Zwischenablage schreiben' auswählen. Das wird die ed2k-links der gewählten Dateien in die Zwischenablage schreiben.

Der Fragen und Antworten Abschnitt enthält mehr Informationen darüber, wie man ed2k-links von anderen Leuten benutzt.

Es gibt Webseiten, die sich dem Sammeln und Veröffentlichen von ed2k-links widmen. Der Vorteil diese Links zu benutzen liegt darin, dass die entsprechenden Dateien oft gut verbreitet und deswegen leicht und schnell runterzuladen sind und dass auf den Webseiten meistens zusätzliche Informationen zu den Dateien erhältlich sind.

Ein paar Seiten für den Anfang:

- ShareReactor
- FileNexus
- google for 'ed2k links'
- music donkey

Ein Wort der Warnung: wiederstehe der Versuchung, treibs nicht zu wild(e).

Ausserdem gibt es Suchmaschinen für das eDonkey2000 Netzwerk, die dir die Verfügbarkeit einer Datei verraten können. Versuche Jigle oder Filedonkey.

## 4.6 Downloads pflegen

Was die Farben der 'Punkte'auf der linken Seite bedeuten:

> `

>        weiss   die Datei ist angehalten, eingereiht, oder der Hash wird berechnet.

>        grün    diese Datei ist im Netzwerk komplett verfügbar
>                und wird entweder runtergeladen oder wartet
>                auf einen freien Slot irgendwo (Suche).

>        rot     diese Datei ist im Moment nicht im Netzwerk verfügbar
>                (oder wir konnten keine Quellen finden), oder es gibt
>                irgendwelche Probleme mit der Datei
>                (zuwenig Speicherplatz, Fehler beim Laden, etc.).

>        pink    diese Datei ist im Moment nicht komplett verfügbar
>                im Netzwerk, aber wir haben Quellen von Teilen,
>                die uns noch fehlen.

>        gelb    diese Datei ist im Moment nicht komplett verfügbar
>                und wir haben bereits alle Teil, die im Netzwerk
>                verfügbar sind.

> `

Was die Farben der Fortschrittsbalken bedeuten:

> `

>        schwarz diesen Teil haben wir schon (gut)

>        grün    diesen Teil haben wir noch nicht, aber
>                es gibt wenigstens eine Quelle die ihn hat (gut).
>                Je dunkler, desto mehr Quellen.

>        rot     diesen Teil haben wir nicht, und es konnte keine Quelle
>                dafür gefunden werden (schlecht).
>                Abwarten ist die einzige Möglichkeit.

>        weiss   bedeutet nichts Besonderes. Wenn die Datei angehalten wurde
>                sind die Teile, die du noch nicht hast weiss.

> `

Was die verschiedenen Download Zustände bedeuten:

> `

>        Download      macht genau das :)

>        Suche         eDonkey lädt diese Datei gerade nicht runter,
>                      aber sucht nach Quellen und wartet in den
>                      Warteschlangen der Leute, die die Datei haben,
>                      bis du mit dem Runterladen an der Reihe bist.
>                      Das ist normal und der häufigste Zustand.
>                      Erwarte keine sofortigen Downloads. Normalerweise
>                      muss man warten, bevor man etwas runterladen kann,
>                      weil auch andere das Gleiche wollen.

>         Eingereiht   Diese Datei ist lokal in der Warteschlange, was
>                      bedeutet, das nicht runtergeladen, nach Quellen
>                      gesucht oder auf einen freien Slot gewartet wird.
>                      Das kommt vor, wenn:

>                      (a) eDonkey bereits viele Verbindungen für andere
>                          Dateien verwendet und momentan nicht genug übrig
>                          sind für diese Datei.
>                          Erhöhen der Option 'max. Verbindungen' könnte hier
>                          helfen (Optionen Seite -> Core).

>                      (b) es sind viele Downloads aktiv, und nach mehr
>                          Quellen zu suchen macht keinen Sinn.
>                          Erhöhen der Priorität eines eingereihten
>                          Downloads sollte ihn recht bald in den Zustand
>                          'Suche' ändern (funktioniert natürlich nur, wenn
>                          die meisten anderen Downloads eine niedrigere
>                          Priorität haben).

>        (Hashing...)  Bedeutet, das wir den Zustand der Datei nicht kennen.
>                      Normalerweise direkt nachdem die GUI mit dem Core
>                      verbunden wird, oder für ein paas Sekunden, wenn ein
>                      Block fertig geladen ist. Diesen Zustand (_mit_ den
>                      Klammern!) solltest du nicht all zu lange sehen.

>        Hashing...    Das (ohne Klammern) bedeutet, dass den Hash deiner Dateien
>                      berechnet, um sicher zu stellen, dass nichts fehlerhaft ist.
>                      Dass passiert wenn du den Core startest und kann eine Weile
>                      dauern (abhängig von deinem System).

>        Pause         Die Datei wurde angehalten. Sie momentan nicht aktiv und
>                      wird nicht runterladen. Um weiter runter zu laden musst
>                      die Datei wiederaufnehmen.

>        zuwenig       Bedeutet, dass entweder in 'temp' oder 'icoming' nicht genug
>         Platz        Speicherplatz zur Verfügung steht. Beachte, dass eDonkey eine
>                      Minute oder so brauchen kann, um zu bemerken, dass du mehr
>                      Platz freigeschaufelt hast.

> `

TODO: downloading --- pausing --- resuming --- download priority --- x.part filenames --- and the temp directory

## 4.7 Uploads pflegen

Hier gibt es nichts zu tun. Du kannst nur zusehen und stolz auf dich sein, dass du anderen ermöglichst die Dateien zu bekommen.

In eDonkey können keine Uploads abgebrochen werden und es ist nicht möglich keine Dateien anzubieten. Denk immer daran, dass alles, was du runterlädst von einem anderen heraufgeladen werden muss. Wenn keiner etwas hochlädt, kann auch niemand etwas herunterladen.

In einem geschlossenen Netzwerk wie eDonkey is die rechnung ziemlich einfach: UPLOAD = DOWNLOAD

Das Uploaden zieht nichts von deiner Downloadgeschwindigkeit ab. Upload und Download Geschwindigkeiten sind mit einer breitbandigen Verbindung (DSL/Cable) mehr oder wenig unabhängig voneinander.

## 4.8 Tricks mit 'erweiterten Befehlen'

'Erweiterte Befehle' sind Befehlszeilenanweisungen, die von der GUI an den Core geschickt werden können. Das geht mit der Toolbar, der Eingabeleiste.

Wenn der Donkey nach dem Start versucht sich mit irgendeinem Server zu verbinden, obwohl du einen bestimmten Server möchtest. Auf 'Trennen' zu klicken bringt nichts. Wenn du aber ein 'x' in der Toolbar eingibst kannst du dich innerhalb weniger Sekunden mit dem Server deiner Wahl verbinden, obwohl die Option 'immer verbunden bleiben' eingestellt ist.

Wenn du für eine andere Anwendung mehr Bandbreite brauchst, kannst du dumax 1 1 eingeben, um den Up- und Download auf 1kB/s zu beschränken. Wenn du dann fertig bist, kannst du mit dumax 0 10 die Download Geschwindigkeit auf 0 (unbegrenzt) und die Upload Geschwindigkeit auf 10kB/s (oder alten Werte) stellen.

## 4.9 ed2k-links

Wenn du einen ed2k-link an die GUI übergibst startet automatisch der Download der dazugehörigen Datei. Dafür (und für ed2k-Server-Links) gibt es mehrere Möglichkeiten.

### Drag'n'Drop

Du kannst Drag'n'Drop benutzen, um ed2k-links von deinem Browser in das GUI Fenster zu ziehen. Server Links werden zur Serverliste hinzugefügt. Dateilinks werden abhängig von deinen Einstellungen die Datei sofort zur Downloadliste hinzufügen oder den Link in das Eingabefeld auf der Suchen Seite schreiben. Drag'n'Drop sollte mit jedem Browser funktionieren (von lynx einmal abgesehen).

### Clipboard

Man kann auch einen oder mehrere Links in die Zwischenablage kopieren und sie entweder mit Strg+v oder der mittleren Maustaste in der Toolbar einfügen.

### Pipe (für erfahrene Benutzer)

Eine Pipe ist etwas ähnliches wie eine Datei. Sie erscheint, wie auch Dateien in einem Verzeichnis, aber sie ist direkt mit der GUI verbunden. Diese wird sofort jeden Inhalt, der in diese Datei geschrieben wird empfangen. Das ermöglicht es sowohl über System Befehle oder ein anderes Programm einen ed2k-link an die GUI zu schicken. Zum Beispiel:

> `

>        %echo "ed2k://|file|blödes_Beispiel.txt|42321|abababababababababababababababab|" > ~/.ed2k_gui/pipe

> `

Diese Pipe wird auch von anderern Programmen, wie dem Linkhandler für KDE oder GNOME (siehe unten) verwendet. (Anmerkung: bei älteren Versionen der GUI heisst die Pipe /tmp/.ed2k_gui_socket)

### Linkhandler für KDE und GNOME

Seit der GUI Version 0.5.0 ist es möglich die GUI als Linkhandler für KDE oder GNOME einzutragen. Diese Möglichkeit findet man bei den Optionen. Anmerkung: Auch wenn du GNOME2 verwendest kann es nötig sein den Linkhandler für GNOME1 zu installieren, weil noch nicht alle Anwendungen an GNOME2 angepasst sind (z.B. Galeon).

Wenn du jetzt in dem Browser deiner Desktopumgebung (KDE: Konqueror, GNOME: Galeon) auf einen ed2k-link klickst, wird die GUI mit dem ed2k-link als erstem Befehlszeilenparameter gestartet.

Das funktioniert aber nicht mit einem Browser, den deine Desktopumgebung nicht interessiert. Also musst du mit Mozilla, Opera oder Safari Drag benutzen.

## 4.10 Tastenkürzel

Einige der wichtigsten Pop-Up Menüfunktionen können auch mit Tastenkürzeln ausgeführt werden. Diese Tastenkürzel sind nur aktiviert, wenn eine oder mehrere Zeilen einer Liste (z.B. Downlads) den Fokus haben (wenn du also gerade ein paar Zeilen markiert hast).

### Tastenkürzel der Downloadliste

> `

>     Kürzel             Funktion
>     ======             ========

>       l                Priorität auf niedrig setzen
>       n                Priorität auf normal setzen
>       h                Priorität auf hoch setzen

>       p                gewählte Downloads anhalten
>       r                gewählte Downloads wiederaufnehmen

>       a                alle auswählen
>       u                alle abwählen

>      <delete>          gewählte Downloads abbrechen

> `

### Tastenkürzel der Suchergebnissliste

> `

>     Kürzel             Funktion
>     ======             ========

>       b                gewählte Suchergebnisse zur Blacklist hinzufügen
>       d                gewählte Suchergebnisse runterladen
>       c                gewählte Suchergebnisse mit anderem Dateinamen runterladen
>       n, s, a          Fokus auf das Eingabefeld setzen
>      <enter>           gewählte Suchergebnisse runterladen
>      <shift>+<enter>   gewählte Suchergebnisse mit anderem Dateinamen runterladen

> `

### Tastenkürzel der Serverliste

> `

>     Kürzel             Funktion
>     ======             ========

>       c                mit einem der gewählten Server verbinden

>       l                Priorität auf niedrig setzen
>       n                Priorität auf normal setzen
>       h                Priorität auf hoch setzen

>       a                alle auswählen
>       u                alle abwählen

> `

### Tastenkürzel der Uploads, Status, Optionen, Shared und Statistik Seiten

Für diese Seiten gibt es noch keine Tastenkürzel.

Next Previous Contents