# &app; Manual (&manrevision;)

## Introduktion

&app; er en program til GNOME skrivebordet der muliggør downloade binære filer fra Usenet.

Usenet er et verdenspændende distribueret diskussionssystem fra før det første websider dukkede op på internettet. Foruden normale tekstbeskeder kan brugere også vedhæfte små filer og derfor er det normalt store filer er delt op på rigtig mange beskeder. For at gøre et nemt at hente og samle de filer, blev NZB filformatet udviklet af skaberne af Newzbin.com Usenet søgemaskinen. Disse indeholder informationerne om hvad der præcis skal downloades og genereres som ofte af Usenet søgemaskiner såsom før nævnte.

&app; bruger HellaNZB som sin hjælper til at indlæse NZB filer, downloade hvad de peger på og til slut validere og udpakke hvis det er nødvendig. Men &app; kan også:

- Bruges som en stand-alone NZB Usenet klient eller som en front-end til en HellaNZB daemon på en anden computer.

- Sætte flere NZB filer i kø på én gang, direkte fra dit filhåndteringsprogram og webbrowser.

- Omarrangere downloadkøen og tilføje NZB filer via træk og slip med musen,

- Angiv flere Usenet servere

- Begrænse båndbredden anvendt til downloads.

- Nemt konfigurere både HellaNZB og &app; uden behov for manuel redigering af konfigurationsfiler.

Tak til arbejdet fra brugerne a f&app; rundt omkring i verdenen. &app; er tilgængelig i Dansk, Nederlandsk, Fransk, Tysk og Spansk.

## Sådan begynder du

### At Starte &app;

Du kan starte &app; på følgende måder:

Programmer menu

- Vælg Internet LottaNZB automatiseret Usenet Klient .

Kommandolinje

- For at starte &app; fra kommandolinjen skriv følgende og tryk Enter:

  `lottanzb`

### Første opstart af &app;

Når du for første gang starter &app; er du nødsaget til at konfigurere det. Du vil blive spurgt om hvilken tilstand du ønsker at bruge.

&app; vil forsøge at finde den mest hensigtsmæssige tilstand for dig og viser i bunden af vinduet forklaringer, der vil hjælpe dig til at vælge. &app; har tre tilstande som er beskrevet herunder.

#### Stand-alone tilstand

Hvis du ikke ønsker HellaNZB daemon altid skal køre i baggrunden, eller hvis du ikke ønsker at konfigurere daemonen selv, er denne nok den bedste tilstand for dig. Når &app; startes vil HellaNZB automatisk også startes og lukkes ned når &app; lukkes. Hvis du ikke kender HellaNZB daemon vil denne tilstand være det bedste valg.

Hvis du vil bruge stand-alone tilstanden, skal du udfylde adressen og porten til din Usenet server. Normalt er porten 119. Når en server kræver autentifikation skal du også udfylde dit brugernavn og password. Nederst ved valget at tilstand kan du udfylde stien til HellaNZB daemon. Dog burde dette blive fundet automatisk.

Denne information er nødvendig for at kunne komme i gang med at downloade. Først og fremmest er dette vindue beregnet til den første gang &app; startes. Bagefter kan disse værdier ændres i vinduet for programindstllinger, hvor også flere servere og SSL kryptering kan slås til.

##### Tilstandsvalg dialog vindue

Viser dialogen hvorfra du kan opsætte stand-alone tilstanden.

#### Lokal front-end tilstand

Hvis du i forvejen har konfigureret HellaNZB daemon og vil have den til at altid køre i baggrunden, bør du vælge lokal front-end tilstand.

Hvis du vil benytte lokal front-end tilstand, skal du blot udpege den konfigurationsfil HellaNZB bruger. Den hedder hellanzb.conf og kan som regel findes enten i /etc, /usr/etc eller ~/.hellanzb.

Du vil ikke kunne ændre HellaNZB's indstillinger via &app; hvis du vælger denne tilstand.

##### Tilstandvalg dialog til lokal front-end

Viser dialog vinduet hvori du kan opsætte lokal front-end tilstanden.

#### Remote front-end tilstand

Hvis du ønsker at forbinde til en HellaNZB daemon der kører på en anden computer, skal du vælge denne tilstand. Det vil ikke være muligt at ændre indstillinger eller tilføje NZB filer i denne tilstand, men du kan overvåge status/fremgang af downloads.

Hvis du vil bruge remote front-end tilstand, skal du udfylde IP adressen for computeren HellaNZB daemon kører på, samt port og XML RPC password til HellaNZB daemon.

##### Tilstandsvalg dialog for remote front-end

Viser vinduet hvori du kan konfigurere remote front-end tilstanden.

### Hovedvindue

Når &app; er blevet konfigureret korrekt, vil &app;'s hovedvindue blive vist.

#### Hovedvindue

Viser &app; hovedvinduet. Indeholder titelbar, menubjælke, værktøjslinie, informationslinie og downloadområde. Menubjælken indeholder Fil, Rediger og Hjælp menuerne.

&app; vinduet indeholder følgende elementer:

Menubjælke.

- Punkterne på menubjælken indeholder kommandoer som bruges til at arbejde med &app;.

Værktøjslinie

- Værktøjslinien indeholder de kommandoer som man oftest har brug for.

Informationslinie

- Informationslinien viser informationer om det element der er ved at blive downloaded.

Downloadområde

- Downloadområdet viser de elementer der enten downloades, efter-behandles, er i kø eller er færdige.

## Anvendelse

Du kan bruge &app; til at udføre opgaverne beskrevet i følgende sektioner:

### Downloade et element

Der er flere måder man kan tilføje elementer til downloadkøen:

#### Direkte fra dit filhåndteringsprogram og web browser.

Når &app; er installeret vil det blive sat til at være standart program til at åbne NZB filer. Dette vil betyde at du kan tilføje NZB filer til downloadkøen, blot ved at dobbeltklikke på dem via dit filhåndteringsprogram. Ved download af NZB filer vil din web browser give dig mulighed for at åbne filen direkte i &app;.

Du kan endda vælge flere filer i dit filhåndteringsprogram og sætte dem alle i kø på én gang.

#### At bruge Fil menuen

Den første måde er at vælge Fil Tilføj NZB filer. Tilføj Filer vinduet (se screenshot forneden) vises herefter. Vælg filen du ønsker at tilføje (det er muligt at markere flere filer) og udfyld felterne med navn og kategori inden du klikker Tilføj.

##### Tilføj Filer vinduet

Viser Tilføj filer menuen.

#### At bruge Tilføj knappen.

Den tredje måde at tilføje NZB filer er at klikke Tilføj knappen i værktøjslinien. Dette åbner den samme Tilføj filer vindue som beskrevet før.

#### At bruge træk og slip

En anden måde er med træk og slip, hvor man kan trække en fil over til download køen og slippe den der. Dette vil åbne Tilføj filer vinduet med filen udvalgt fra start. Dette er også muligt at gøre dette med flere markerede filer på en gang. Disse vil automatisk blive tilføjet download køen.

#### At bruge Newzbin.com

Den endelige måde at tilføje NZB filer er kun mulig når en Newzbin.com konto er blevet konfigureret i Indstillinger vinduet. Hvis en Newzbin.com konto er blevet konfigureret, er det muligt at tilføje en download til downloadkøen ved at indtaste et Newzbin.com ID. For at gøre dette gå til Fil Tilføj fil fra Newzbin.com. Derefter vil Tilføj download vinduet dukke op. Indtast et Newzbin.com ID og klik Tilføj og download vil automatisk starte.

Efter at have klikket Tilføj kan det tage indtil flere sekunder før downloaden dukker op i downloadkøen. Dette skyldes at &app; først skal downloade NZB filen fra Newzbin.com. Så udøv en vis tålmodighed.

##### Tilføj en download fra Newzbin.com

Viser Tilføj download menuen.

### At overvåge download status

Når &app; er startet og nogle filer er tilføjet vil de blive vist i download område. I downloadområde er der fire kolonner:

- Navn: Denne kolonne viser navnet på elementet.

- Kategori: Denne kolonne viser hvilken kategori elementerne tilhører. Når elementet er downloaded, behandlet og færdigt vil det ligge i Downloadmappen med kategorien vist først i navnet. Filer tilføjet køen med drag 'n drop vil altid have kategorien 'Anden'.

- Størrelse: Denne kolonne viser størrelsen på elementet.

- Status: Denne kolonneviser status for elementerne. Der er fem forskellige tilstande et element kan have:

  - Downloader: Når et element downloades vises status for denne i procent. I skærmbilledet herunder kan du se et element der er ved at blive downloaded.

    #### Downloader

    Viser en fil som er ved at blive downloaded.

  - I kø: Når et element er i kø ventes der på at de forgående elementer er hentet, før denne startes. Ved at klikke på Flyt op/ned kan man selv ændre på rækkefølgen i køen. Man kan også bruge musen til at trække rundt og ændre i rækkefølgen. I skærmbilledet herover er der to elementer der er i kø.

  - Behandler: Når et element behandles kontrolleres dataintegriteten og hvis der ingen fejl er, vil den blive udpakket til download mappen. På skærmbilledet herunder kan man se et element der er ved at blive behandlet.

    #### Behandler

    Viser en fil der er ved at blive behandlet

  - Reparerer: Når et element repareres skyldes det problemer med dataintegriteten efter download. Husk at reparation som regel vil tage en del tid.

  - Afslutet: Når et element er afsluttet, kan det fjernes fra downloadområdetved at klikke på Ryd afsluttede knapen.

### At omarrangere downloadkøen

Der er kan være situationer hvor det er nødvendig at omarrangere downloadkøen. Dette kan foregå på to måder:

- Den første måde at omarrangere elementer i køen, er at bruge knapperne Flyt op og Flyt ned i værktøjslinien. Vælg først elementet du vil flytte og brug knapperne til at flytte op eller ned på dette.

- Den anden måde er at bruge drag 'n drop. Vælg først elementet du vil flytte og brug musen til at trække det til den position du ønsker elementet skal have i køen. Skærmbilledet herunder viser et element (Ubuntu 7.10 DVD) som flyttes til en position længere nede i køen.

  #### Omarrangering med drag 'n drop

  Viser et element der flyttes rundt i køen

## Indstillinger

For at konfigurere &app;, vælg Rediger Indstillinger. Vinduet Indstillinger indeholder følgende faneblade:

### Generelle indstillinger

Herunder er der et skærmbillede af generelle indstillinger fanen.

#### Generelle indstillinger fanen

Generelle indstillinger fanen

Download indstillinger

- - Downloadmappe

    Når elementer er downloaded og behandlet flyttes de til denne mappe. Sørg for der er plads nok på den valgte lokation. For at ændre downloadmappen, klik på knappen og vælg enten en af lokationerne fra listen eller vælg Anden....

  - Max download hastighed

    Nogle ønsker at have båndbredde i overskud til at læse e-mails og websurfing. Har du ikke nok båndbredde til det hele, kan du begrænse den mængde HellaNZB daemon tager.

    Helt præcis kan HellaNZB deamon ikke direkte begrænse sit båndbredde forbrug, men pauser kort sin download og opnår derved at i gennemsnit holde sig til den max download hastigheden der er sat.

  - Download PAR gendannelses filer kun hvis nødvendig

    Hvis downloadede elementer er beskadiget, kan de repareres hvis nok PAR filer er tilgængelige. Med denne indstilling er sat vil &app; kun hente PAR filer når et element konstateres som beskadiget. Dette vil betydeligt nedsætte download størrelsen på elementer uden fejl, idet uden denne indstilling vil PAR filer altid blive hentet, selvom de ikke skal bruges.

Andre indstillinger

- - Start minimeret

    Med denne indstilling sat vil &app; ikke vise hovedvinduet efter start, men kun vise et ikon i notifikations området. Ved at højre-klikke på ikonet og vælge Vis hovedvindue kan du få dette frem igen. Denne indstilling er praktisk hvis &app; starter op sammen med skrivebordsmiljøet og man ikke ønsker at hovedvinduet vises efter hver opstart.

  - Benyt libnotify notifikationer

    Med denne indstilling sat, vil GNOME skrivebordsmiljøets libnotify notifikationer vise statusændringer for elementerne i download køen.

### Server indstillinger

Herunder vises et skærmbilede af fanen server indstillinger.

#### Server instillinger fanen

Server instillinger fanen

Som skærmbilledet viser herover, er der tre knapper der kan benyttes:

- lottanzb-server-add

- Rediger den valgte servers indstillinger

- Slet den valgte server

#### Tilføj en ny Usenet server

Når Tiljøj knappen klikkes under server indstillinger fanen, vises tilføj server dialogvinduet som vist i skærmbilledet herunder. Dette vindue er det samme som vinduet Rediger server.

##### Tilføj/rediger server vinduet

Tilføj/rediger server vinduet

Generelt

- Følgende indstillinger er nødvendige, når en Usenet server tilføjes:

  - Servernavn

    Dette er navnet på serveren, men ikke selve serveradressen. Navnet er valgfrit men skal være unikt.

  - Adresse

    Usenet serverens adresse. Husk at udelade port nummeret fra adressen.

  - Port

    Port nummeret for Usenet serveren. Som standart er det 119.

Autentifikation

- - Serveren kræver autentifikation

    Benyt denne indstilling hvis Usenet serveren kræver at der logges ind.

  - Brugernavn

    Hvis Usenet serveren kræver at man logger ind, skal du indtaste dit brugernavn som er udleveret til dig.

  - Adgangskode

    Hvis Usenet serveren kræver at man logger ind, skal du indtaste dit password som er udleveret til dig.

Forbindelseindstillinger

- - Benyt SSL kryptering

    Benyt kun denne indstilling hvis din Usenet server tillader SSL kryptering. For de fleste Usenet servere er dette en betalt ekstra service. Virker downloads ikke med denne indstilling sat, er det højest sandsynlig fordi den valgte server ikke understøtter SSL kryptering.

  - Max antal forbindelser

    De fleste Usenet servere har en grænse for hvor mange forbindelser hver bruger kan have åben. Man bør sætte grænsen til hvad ens Usenet udbyder har sat af max tilladt.

    Har du en langsom internet forbindelse bør du sætte dette tal lavt, for at få en mere optimal download hastighed.

### Newzbin indstillinger

Newzbin.com websiden tilbyder on et katelog over NZB filer der alle kan bruges af &app; kan nu tilf

Newzbin.com har et lukket registreringssystem, hvilket betyder i forvejen skal du kende en med en konto for at kunne få adgang til denne service. Noget lige så vigtigt er at dette er en betalingsservice og derfor koster penge at benytte.

Hvis du søger en gratis kilde til NZB filer prøv evt. binsearch.info. Denne webside lade dig søge efter og lave NZB filer.

#### Newzbin.com indstillinger

Newzbin.com indstillinger

Autentifikation

- Når du vil bruge Newzbin funktionaliteten skal følgende oplysninger angives:

  - Brugernavn

    Brugernavnet Newzbin.com forsynede dig med.

  - Adgangskode

    Passworded Newzbin.com forsynede dig med.

## Om &app;

Den første version af &app; blev skrevet af Sander (aVirulence). Primo i 2008 tilgik Severin (Lantash) udviklingsteamet, som omskrev det meste af koden og gjorde &app; til den attraktive applikation som den er idag. Lidt senere tilgik Stéphane også teamet som &app;'s faste tester og oversætter. Efter release af 0.2 blev Andrew en del af teamet hvor han rettede fejl og implementerede nye features. For at finde mere information om &app;, besøg venligst &app;'s hjemmeside.

For at indrapportere en programfejl (bug) eller komme med et forslag til &app; eller denne manual, følg blot instruktionerne på Launchpad bug tracker siden.

Dette program er distribueret under licensbetingelserne af GNU General Public License version 3, som publiceret af Free Software Foundation. En kopi af denne licens er tilgængelig på dette link, eller i filen LICENSE inkluderet i kildekoden til dette program.