# &app;-Handbuch (&manrevision;)

2008
Sander Tuit
LottaNZB-Entwicklungsteam

            avirulence@lottanzb.org

&legal;

Sander
Tuit
LottaNZB-Entwicklungsteam

                avirulence@lottanzb.org

LottaNZB-Handbuch (&manrevision;)
&date;

Sander Tuit avirulence@lottanzb.org

LottaNZB-Entwicklungsteam

Dieses Handbuch beschreibt Version &appversion; von LottaNZB.

## Rückmeldungen

Um einen Fehler zu melden oder einen Vorschlag bezüglich &app; oder dieses Handbuchs machen möchten, folgen Sie bitte den Anweisungen auf der Fehlerverfolgungs-Seite auf Launchpad.

## Einführung

&app; ist eine Anwendung für den GNOME-Desktop, mit der Sie binäre News aus dem Usenet herunterladen können.

Das Usenet ist ein weltweites, verteiltes Internet-Diskussionssystem, das es schon lange vor den ersten Webseiten gab. Neben normalen Textnachrichten können Benutzer auch Dateien versenden, die meistens in verschiedene Nachrichten aufgeteilt werden. Um das Herunterladen solcher Dateien zu vereinfachen, haben die Macher der Usenet-Suchmaschine Newzbin.com das Dateiformat NZB entwickelt. Solche Dateien enthalten Informationen darüber, was genau heruntergeladen werden soll und werden in der Regel von Usenet-Suchmaschinen wie der bereits erwähnten erstellt.

&app; verwendet HellaNZB als Backend, um solche NZB-Dateien zu verarbeiten und die Dateien herunterzuladen, auf die sie verweisen und um die heruntergeladenen Dateien schliesslich zu überprüfen und gegebenenfalls zu entpacken. &app; kann aber noch mehr. Sie können:

- Es als eigenständigen NZB-Usenet-Client oder als Front-end für einen HellaNZB-Client, der auf einem beliebigen Rechner läuft, verwenden

- Mehrere NZB-Dateien gleichzeitig direkt aus Ihrem Datei-Manager oder Webbrowser heraus zur Warteschlange hinzufügen

- Mittels Drag 'n Drop die Download-Warteschlange anordnen und NZB-Dateien hinzufügen

- Mehrere Usenet-Server definieren

- Die Bandbreite, die zum Herunterladen verwendet wird, beschränken

- Auf einfache Art und Weise sowohl HellaNZB als auch &app; einrichten, ohne Konfigurationsdateien von Hand bearbeiten zu müssen

Dank &app;-Nutzern aus verschiedenen Ländern steht &app; in Dänisch, Holländisch, Französisch, Deutsch und Spanisch bereit.

## Erste Schritte

### Wie &app; gestartet wird

Sie können &app; folgendermassen starten:

Menü Anwendungen

  Wählen Sie Internet LottaNZB Automatisierter Usenet-Client.

Befehlszeile

  Um &app; von der Befehlszeile aus zu starten, geben Sie den folgenden Befehl ein und bestätigen Sie mit der Eingabetaste:

  `lottanzb`

### Der erste Start von &app;

Wenn Sie &app; zum ersten Mal starten, müssen Sie es konfigurieren. Sie werden gebeten, denjenigen Verwendungsmodus zu wählen, der Ihnen am besten passt.

&app; versucht herauszufinden, welcher Modus am passendsten für Sie ist und zeigt am unten im Fenster einen Tip an, der Ihnen bei der Entscheidung hilft. &app; hat drei Verwendungsmodi, die im folgenden beschrieben werden.

#### Selbstständiger Modus

Wenn Sie nicht möchten, dass der HellaNZB-Daemon die ganze Zeit im Hintergrund läuft oder wenn Sie den HellaNZB-Daemon nicht selber einrichten möchten, ist dies wahrscheinlich der beste Modus für Sie. Wenn &app; gestartet wird, führt es auch automatisch den HellaNZB-Daemon aus und beendet ihn, sobald &app; geschlossen wird. Auch wenn Sie nicht wissen, was ein HellaNZB-Daemon ist, ist dies die beste Wahl.

Wenn Sie den eigenständigen Modus verwenden möchten, müssen Sie die Adresse und den Port ihres Usenet-Servers eingeben. Der Port ist in der Regel 119. Falls der Server eine Authentifizierung benötigt, müssen Sie auch noch Ihrem Benutzernamen und Ihr Passwort eingeben. Im unteren Bereich des Fensters können Sie den Ort des HellaNZB-Daemons angeben, doch dies sollte normalerweise automatisch erkannt werden.

Diese Informationen sind nötig, damit danach gleich mit dem Herunterladen begonnen werden kann. Grundsätzlich sollte dieses Fenster nur beim ersten Start von &app; verwendet werden. Später können Sie diese Informationen im Einstellungs-Fenster verändern, wo Sie auch noch mehrere Server einrichten, die SSL-Verschlüsselung aktivieren können usw.

##### Der Dialog zum Auswählen des Verwendungsmodus

Zeigt den Dialog, mit dem Sie den eigenständigen Modus einrichten können.

#### Lokaler Front-end-Modus

Wenn Sie den HellaNZB-Daemon bereits eingerichtet haben und ihn die ganze Zeit im Hintergrund am Laufen haben möchten, sollten Sie den lokalen Front-end-Modus wählen.

Wenn Sie den lokalen Front-end-Modus verwenden möchten, brauchen Sie nur die von HellaNZB verwendete Konfigurationsdatei auszuwählen. Sie trägt den Namen hellanzb.conf und befindet sich in der Regel in /etc, /usr/etc oder ~/.hellanzb.

In diesem Modus können Sie die HellaNZB-Einstellungen nicht mit Hilfe von &app; verändern.

##### Der Dialog zur Auswahl eines Verwendungsmodus (lokales Front-end)

Zeigt den Dialog, mit dem Sie den lokalen Front-end-Modus einrichten können.

#### Entfernter Front-end-Modus

Wenn Sie eine Verbindung zu einem HellaNZB-Daemon herstellen möchten, der auf einem anderen Rechner läuft, sollten Sie diesen Modus wählen. In diesem Modus ist es nicht möglich, die Einstellungen zu verändern und NZB-Dateien hinzuzufügen, aber Sie können den Fortschritt der Downloads überwachen.

Wenn Sie den entfernten Front-end-Modus verwenden möchten, müssen Sie die IP-Adresse und den Port des Rechners, auf dem der HellaNZB-Daemon läuft, angeben und zusätzlich noch das Passwort des HellaNZB-Daemons.

##### Der Dialog zur Auswahl eines Verwendungsmodus (entferntes Front-end)

Zeigt den Dialog, mit dem Sie den entfernten Front-end-Modus einrichten können.

### Hauptfenster

Sobald &app; korrekt eingerichtet wurde, wird &app;s Hauptfenster angezeigt.

#### Hauptfenster

Zeigt das Hauptfenster von &app;. Es umfasst eine Titel-, Menü- und Werkzeugleiste, die Fläche mit der Download-Warteliste, sowie eine Informationsleiste. Die Menüleiste enthält die Menüs Datei, Bearbeiten und Hilfe.

Das &app;-Fenster enthält folgende Elemente:

Menüleiste.

  Die Menüs in der Menüleiste enthalten verschiedene Befehle zur Bedienung von &app;.

Werkzeugleiste.

  Die Werkzeugleiste enthält verschiedene nützliche Befehle.

Informationsleiste.

  Die Informationsleiste zeigt Informationen über die Elemente an, die gerade heruntergeladen werden.

Downloadbereich.

  Der Download-Bereich zeigt die Elemente an, die gerade heruntergeladen oder verarbeitet werden, sich noch in der Warteschlange befinden oder bereits fertig heruntergeladen worden sind.

## Verwendung

Sie können &app; für die in den folgenden Abschnitten beschriebenen Aufgaben einsetzen:

### Herunterladen eines Elements

Es bestehen mehrere Möglichkeiten, ein Element zur Download-Warteschlange hinzuzufügen:

#### Aus dem Datei-Manager und dem Webbrowser heraus

Wenn Sie &app; installieren, wird es als Anwendung registriert, die mit NZB-Dateien umgehen kann. Das bedeutet, dass Sie nun NZB-Dateien zur Download-Warteschlange hinzufügen können, indem Sie in Ihrem Datei-Manager darauf klicken. Wenn Sie eine NZB-Datei herunterladen, sollte Ihnen Ihr Webbrowser die Möglichkeit geben, die Datei direkt an &app; weiterzugeben.

Sie können sogar mehrere NZB-Dateien in Ihrem Datei-Manager auswählen und alle gleichzeitig zur Warteschlange hinzufügen.

#### Mit dem Menu Datei

Wählen Sie zunächst Datei NZB-Dateien hinzufügen. Der Dialog Dateien hinzufügen (zu sehen auf dem folgenden Bildschirmfoto) wird angezeigt. Wählen Sie die Datei aus, die Sie hinzufügen möchten (Sie können auch gleich mehrere Dateien auswählen) und wählen Sie dann im unteren Teil des Dialogs einen Namen und eine Kategorie und bestätigen Sie mit Hinzufügen.

##### Dialog zum Hinzufügen von Dateien

Das Menü Dateien hinzufügen.

#### Mit dem Schaltfläche Hinzufügen in der Werkzeugleiste

Die dritte Möglichkeit, NZB-Dateien zur Warteschlange hinzuzufügen besteht darin, die Schaltfläche Hinzufügen in der Werkzeugleiste zu verwenden. Diese Schaltfläche öffnet ebenfalls den Dialog Dateien hinzufügen, der oben beschrieben wurde.

#### Mittels Drag 'n Drop

Eine weitere Möglichkeit, NZB-Dateien zur Warteschlange hinzuzufügen, besteht darin, Sie direkt vom Datei-Manager oder dem Desktop in der Download-Warteschlange abzulegen. Der Dateien hinzufügen-Dialog wird angezeigt, und die abgelegte Datei ausgewählt. Sie können sogar mehrere Dateien gleichzeitig in der Download-Warteschlange mittels Drag 'n Drop ablegen. Diese werden dann automatisch zur Warteschlange hinzugefügt.

#### Mit Newzbin.com

Die letzte Möglichkeit, NZB-Dateien hinzuzufügen, ist steht nur zur Verfügung, wenn ein Newzbin.com-Konto im Fenster Einstellungen eingerichtet wurde. Wenn ein Newzbin.com-Konto eingerichtet wurde, ist es möglich, einen Download zur Download-Warteschlange hinzuzufügen, indem die Newzbin.com-ID eingegeben wird. Dazu muss der entsprechende Dialog mit Datei Datei von Newzbin.com hinzufügen geöffnet werden. Im Dialog Download hinzufügen kann nun die Newzbin.com-ID eingegeben werden. Nach einem Klick auf Hinzufügen wird automatisch mit dem Download begonnen.

Nach dem Klick auf Hinzufügen können einige Sekunden vergehen, bis der Download in der Download-Warteschlange erscheint. Der Grund dafür ist, dass &app; zunächst die NZB-Datei Newzbin.com herunterladen muss. Haben Sie also etwas Geduld.

##### Einen Download von Newzbin.com hinzufügen

Zeigt den Dialog Download hinzufügen.

### Download-Fortschritt überwachen

Wenn &app; ausgeführt wird und Sie ein paar Dateien zur Download-Warteschlange hinzugefügt haben, werden die Dateien im Downloadbereich angezeigt. Im Downloadbereich finden Sie vier Spalten:

- Name: Diese Spalte zeigt den Namen des Elements an.

- Kategorie: Diese Spalte zeigt an, zu welcher Kategorie das Element gehört. Wenn das Element heruntergeladen und verarbeitet wird, wird es im Download-Verzeichnis mit voranstehender Kategorie erscheinen. Wenn das Element mittels Drag 'n Drop zur Download-Warteschlange hinzugefügt worden ist, wird es in der Kategorie 'Sonstiges' zu finden sein.

- Grösse: Diese Spalte zeigt die Grösse des Elements an.

- Fortschritt: Diese Spalte zeigt den Fortschritt des Elements in der Warteschlange an. Ein Element, das gerade heruntergeladen wird, kann insgesamt fünf verschiedene Stati haben:

  - Am herunterladen: Wenn ein Element gerade heruntergeladen wird, wird der bereits heruntergeladene Teil in Prozent in dieser Spalte angezeigt. Auf dem Bildschirmfoto unten können Sie ein Element, das gerade heruntergeladen wird, erkennen.

    #### Am Herunterladen

    Zeigt eine Datei, die gerade heruntergeladen wird.

  - In der Warteschlange: Wenn sich ein Element in der Warteschlange befindet, wird gewartet, bis der aktive Download abgeschlossen und alle Elemente in der Warteschlange über dem betreffenden Element heruntergeladen worden sind. Wenn Sie auf Nach oben/Nach unten klicken, können Sie die Reihenfolge der Warteschlange verändern. Sie können auch Elemente mit der Maus verschieben, bis die Warteschlange nach Ihren Wünschen angeordnet ist. Im Bildschirmfoto oben sehen Sie zwei Elemente, die noch heruntergeladen werden müssen.

  - Am verarbeiten: Wenn ein Element verarbeitet wird, wird seine Integrität überprüft und im Erfolgsfall entpackt und in das Download-Verzeichnis verschoben. Auf dem folgenden Bildschirmfoto sehen Sie ein Element, das gerade verarbeitet wird.

    #### Am Verarbeiten

    Zeigt eine Datei, die gerade verarbeitet wird.

  - Am reparieren: Wenn ein Element repariert wird, bedeutet dies, dass Probleme beim Herunterladen aufgetreten sind. Dieser Vorgang kann eine Weile dauern.

  - Fertig: Wenn der Download eines Elements abgeschlossen ist, kann es vom Download-Bereich mit einem Klick auf Fertige entfernen entfernt werden.

### Anordnen der Download-Warteschlange

In manchen Situationen kann es vorkommen, dass Sie bestimmte Elemente vor anderen herunterladen möchten. Dafür gibt es zwei verschiedene Vorgehensweisen:

- Die erste Möglichkeit, Elemente in der Warteschlange neu anzuordnen, ist, die Schaltflächen Nach oben und Nach unten zu verwenden. Wählen Sie das zu verschiebende Element zuerst an und klicken Sie dann auf die entsprechende Schaltfläche in der Werkzeugleiste.

- Die zweite Möglichkeit, Elemente in der Warteschlange neu anzuordnen, besteht darin, sie mittels Drag 'n Drop zu verschieben. Wählen Sie das zu verschiebende Element zuerst an und ziehen Sie es an die gewünschte Position. Das Bildschirmfoto (Ubuntu 7.10) unten zeigt ein Element, das gerade in der Download-Warteschlange nach unten verschoben wird.

  #### Umordnen mittels Drag 'n Drop

  Zeigt ein Element, das gerade verschoben wird.

## Einstellungen

Um &app; zu konfigurieren, wählen Sie Bearbeiten Einstellungen. Der Dialog Einstellungen enthält folgende Bereiche:

### Allgemeine Einstellungen

Auf dem folgenden Bildschirmfoto können Sie den Reiter Allgemeine Einstellungen.

#### Die allgemeinen Einstellungen

Die allgemeinen Einstellungen

Download-Einstellungen

  - Download-Verzeichnis

    Wenn heruntergeladene Elemente fertig verarbeitet sind, werden Sie in dieses Verzeichnis verschoben. Stellen Sie sicher, dass an diesem Ort genug freier Festplattenplatz zur Verfügung steht. Um das Download-Zielverzeichnis zu ändern, klicken Sie auf die Verzeichnis-Schaltfläche. Wählen Sie entweder ein Ort aus der Liste oder wählen Sie Andere....

  - Maximale Download-Geschwindigkeit

    Manche Nutzer möchten etwas Bandbreite für E-Mails und das Surfen im Internet freihalten. Wenn Sie nicht über genügend Bandbreite verfügen, können Sie die von HellaNZB verwendete Bandbreite beschränken.

    Der HellaNZB-Daemon beschränkt die Download-Geschwindigkeit beschränkt nicht wirklich, sondern nur die durchschnittliche Download-Geschwindigkeit erreicht, indem es den Download jeweils für eine kurze Zeit unterbricht, sodass die Geschwindigkeit ungefähr dem entspricht, was Sie in diesem Feld eingegeben haben.

  - PAR-Wiederherstellungsdateien nur wenn nötig herunterladen

    Wenn heruntergeladene Elemente beschädigt sind, können Sie gegebenenfalls mit Hilfe von PAR-Dateien repariert werden. Wenn Sie diese Funktion aktiviert ist, lädt &app; nur Wiederherstellungsdateien herunter, wenn die heruntergeladenen Elemente beschädigt sind. Dies kann die Grösse der zu herunterladenden Dateien deutlich verringern.

Andere Einstellungen

  - Minimiert starten

    Wenn diese Option gewählt ist, wird &app; das Hauptfenster nicht anzeigen, wenn es gestartet wird, sondern nur als Symbol im Infobereich erscheinen. Mit einem Rechtsklick auf das Symbol und einem Klick auf Hauptfenster anzeigen, können Sie das Hauptfenster einblenden. Diese Option kann nützlich sein, wenn Sie &app; zusammen mit der Desktopumgebung starten, das Hauptfenster aber nicht jedes Mal geöffnet haben möchten, wenn Sie sich anmelden.

  - libnotify-Meldungen verwenden

    Wenn diese Option ausgewählt ist, werden libnotify-Meldungen auf Ihrem GNOME-Desktop angezeigt, zum Beispiel wenn ein Download abgeschlossen wurde.

### Server-Einstellungen

Auf dem folgenden Bildschirmfoto sehen Sie den Reiter Server-Einstellungen.

#### Server-Einstellungen

Server-Einstellungen

Wie das Bildschirmfoto oben zeigt, stehen drei verschiedene Schaltflächen zur Auswahl:

- Bearbeiten der Einstellungen des gewählten Servers

- Den gewählten Server löschen

#### Einen neuen Usenet-Server hinzufügen

Wenn Sie im Reiter 'Server-Einstellungen' auf die Schaltfläche Hinzufügen klicken, wird der im folgenden Bildschirmfoto sichtbare Dialog Server hinzufügen angezeigt. Es ist das gleiche Fenster wie beim Dialog Server bearbeiten.

##### Server-Dialog zum Hinzufügen/Bearbeiten

Server-Dialog zum Hinzufügen/Bearbeiten

Allgemein

  Beim Hinzufügen eines neuen Usenet-Servers werden folgende Informationen benötigt:

  - Server-Name

    Dieses Feld enthält den aktuellen Namen des Servers. Dieser Name ist nicht besonders wichtig. Er dient nur als Bezeichnung des Servers in der Serverliste. Beachten Sie jedoch dass Sie jedem Server einen einmaligen Namen geben.

  - Adresse

    Die Adresse des Usenet-Servers. Beachten Sie, dass dies nicht die Port-Nummer umfasst.

  - Port

    Der Port des Usenet-Servers. Der Standardport ist bei den meisten Servern 119.

Authentifizierung

  - Server benötigt Authentifizierung

    Wählen Sie diese Option, wenn beim Usenet-Server eine Anmeldung erforderlich ist.

  - Benutzername

    Wenn Sie sich beim Usenet-Server anmelden müssen, geben Sie hier bitte Ihren Benutzernamen ein.

  - Passwort

    Wenn Sie sich beim Usenet-Server anmelden müssen, geben Sie hier bitte Ihr Passwort ein.

Verbindungseinstellungen

  - SSL-Verschlüsselung aktivieren

    Aktivieren Sie diese Option, wenn Ihr Usenet-Server SSL-Verschlüsselung anbietet. Die meisten Usenet-Server bieten dies gegen einen Aufpreis an. Wenn der Download von diesem Server nicht klappt, können Sie versuchen, diese Option abzuschalten, da Ihr Server höchstwahrscheinlich SSL-Verschlüsselung nicht unterstützt.

  - Maximale Anzahl Verbindungen

    Bei den meisten Usenet-Servern kann nur eine bestimmte Anzahl Verbindungen von Ihren Kunden verwendet werden. Sie sollten hier die maximal mögliche Anzahl Verbindungen eingeben.

    Wenn Sie eine langsame Internetverbindung haben, sollten Sie die Verbindungsanzahl verringern, um eine bessere Download-Geschwindigkeit zur erhalten.

### Newzbin.com-Einstellungen

Die Webseite Newzbin.com stellt kategorisierte NZB-Dateien bereit, die von &app; verwendet werden können. &app; ermöglicht es Ihnen nun, einen Download nur durch Eingabe der von Newzbin.com angegebenen ID hinzuzufügen.

Newzbin.com hat momentan ein geschlossenes Registrierungssystem, was bedeutet, dass Sie jemanden mit einem Konto kennen müssen, um diesen Dienst nutzen zu können. Ausserdem ist es wichtig zu wissen, dass kostenpflichtige Premium-Credits benötigt werden, um Newzbin.com verwenden zu können.

Eine kostenlose Quelle für NZB-Dateien ist beispielsweise binsearch.info. Auf dieser Webseite können Sie nach NZB-Dateien suchen und diese herunterladen.

#### Newzbin.com-Einstellungen.

Newzbin.com-Einstellungen.

Authentifizierung

  Wenn Sie die Newzbin.com-Unterstützung aktivieren, müssen Sie die folgenden Angaben machen:

  - Benutzername

    Der Benutzername, den Sie auf Newzbin.com gewählt haben.

  - Passwort

    Das Password, das Sie auf Newzbin.com gewählt haben.

## Über &app;

Die ersten Versionen von &app; wurden von Sander (aVirulence) geschrieben. Anfang 2008 ist Severin (Lantash) dem Entwicklungsteam beigetreten und hat den Code zu grossen Teilen umgeschrieben und &app; zu der tollen Anwendung gemacht, die sie heute ist. Etwas später ist Stéphane dem Team als Tester und Übersetzer beigetreten. Nach der Veröffentlichung von &app; 0.2 ist Andrew dem Team beigetreten, korrigierte Fehler und implementierte neue Funktionen. Mehr über &app; erfahren Sie auf der &app;-Webseite.

Um Fehler zu melden und Vorschläge bezüglich der Anwendung oder dieses Handbuchs zu machen, besuchen Sie bitte die Launchpad-Seite von &app;.

Dieses Programm ist freie Software. Sie können es unter den Bedingungen der GNU General Public License, wie von der Free Software Foundation veröffentlicht, weitergeben und/oder modifizieren, entweder gemäß Version 3 der Lizenz oder (nach Ihrer Option) jeder späteren Version. Die Veröffentlichung dieses Programms erfolgt in der Hoffnung, dass es Ihnen von Nutzen sein wird, aber OHNE IRGENDEINE GARANTIE, sogar ohne die implizite Garantie der MARKTREIFE oder der VERWENDBARKEIT FÜR EINEN BESTIMMTEN ZWECK. Details finden Sie in der GNU General Public License. Sie sollten ein Exemplar der GNU General Public License zusammen mit diesem Programm erhalten haben. Falls nicht, siehe link.