cdw ist ein ncurses-basiertes Programm zum Schreiben von CDs, welches cdrecord
und mkisofs fÃŒr die eigentliche Arbeit verwendet.
Dank an Sharad Mittal, der CDrecorder schrieb! Ich habe Threads und RegExs
von seinem Code gelernt!

Installation
------------
Kopiere cdw-0.2.x.tar.gz in dein Quellverzeichnis, z.B. /usr/local/src und
entpacke das Archiv. Kompiliere und installiere es! Tippe:
 
tar -xzf cdw-0.2.x.tar.gz
cd ./cdw-0.2.x
./configure
make
make install

Das configure-script wird alle fÃŒr cdw benÃ¶tigten oder optionalen Packete
aufspÃŒren. cdrecord und mkisofs werden immer zur Kompilierung benÃ¶tigt. Ohne
diese Programme ist cdw nutzlos. Cdw kann mit den folgenden Programmen
zusammenarbeiten:
cdda2wav: um Audio-CDs zu WAV-Dateien umzuwandeln.
lame: um einzelne Tracks direkt in MP3 zu speichern, statt WAV.
oggenc: um einzelne Tracks direkt in OggVorbis zu speichern, statt WAV.

configure spÃŒrt diese Programme automatisch auf, wenn sie vorhanden sein
sollten. Du kannst configure den Pfad zu den Programmen auch manuell angeben.
FÃŒr mehr Informationen, tippe './configure --help'

Das Programm erzeugt automatisch ~/.cdw.conf in deinem Heimatverzeichnis. Das
Distributionspaket enthÃ€lt eine Datei default.conf, welche als Vorlage
verwendet werden kann.
Das Programm erzeugt automatisch das Verzeichnis ~/.cdw und symbolische Links
von den ausgewÃ€hlten Dateien in dieses Verzeichnis.

Installation der GTK GUI
------------------------
Wenn du das GTK-Interface fÃŒr cdw benutzen mÃ¶chtest, musst du beim Aufruf von
configure den Parameter '--enable-gui' mitgeben, weil cdw in der
Standardeinstellung dieses Feature nicht enthÃ€lt. Es wird nur GTK in Version 2
unterstÃŒtzt. Danach kannst du cdw mit dem GTK-Interface benutzen, wenn du das
Programm mit 'cdw -g' startest.

Installation des CD-Katalogs
----------------------------
Wenn du den CD-Katalog (Disk catalog) nutzen mÃ¶chtest, musst du die Pakete
mysqlclient und mysqlclient-dev installieren, bevor du cdw kompilierst. In
Debian Woody heissen die entsprechenden Pakete: 'libmysqlclient10' und
'libmysqlclient10-dev'.
configure wird diese Pakete aufspÃŒren und der kompilierte Code wird dieses
Feature enthalten. In diesem wirst du ein neues Werkzeug, genannt 'cdwdic',
haben. WICHTIG! Das Verzeichnis /doc enthÃ€lt eine Datei 'cdw.sql'. Du musst
sie in deiner Datenbank installieren, um den CD-Katalog nutzen zu kÃ¶nnen.
Der Installationsprozess ist sehr einfach:

mysql < cdw.sql

Wenn du die Datei als ein anderer Nutzer installieren mÃ¶chtest, oder der
Nutzer ein Passwort hat oder vielleicht das Zielsystem auf einem anderen
Rechner liegt, kannst du die Datenbank mit der folgenden Methode installieren:

mysql -u nutzername -p password -h rechnername < cdw.sql

Dann musst du diese Daten aber auch in den Optionen eintragen (s.u.)


Programmparameter
-----------------
cdw akzeptiert folgende Parameter:
-c | --catalog : im CD-Katalog-Modus laufen.
-g | --gui     : mit GTK-Interface laufen.
-v | --version : zeigt die Versionsnummer von cdw.
-h | --help    : Hilfe anzeigen.

cdwdic kennt die folgende Parameter:
add <name> <no> <category> <date>: neue CD zum Katalog hinzufÃŒgen.
    <name> Name der CD
    <no> Nummer der CD (muss eine Zahl sein)
    <category> Name einer Kategorie (neue Kategorien werden automatisch erzeugt)
    <date> irgendein Datum, dass du speichern mÃ¶chtest, z.B. das Datum, wann
           die CD dem Katalog hinzugefÃŒgt wurde.
search <string>
    Suche die Zeichenkette <string> in den Namen der Dateien und
    Verzeichnisse; beachtet nicht Gross-/Kleinschreibung!
show <name>
    Zeige den Inhalt der CD <name>.
list [-c <category>]
    Zeige den Namen und die Nummern der gespeicherten CDs. Mit -c als
    optionalem Parameter werden nur die CDs in Kategorie <category> angezeigt.


Nutzung:
--------
Das MenÃŒ:

Add files: WÃ€hle Dateien und Verzeichniss fÃŒr das Image der CD. DrÃŒcke <LEER>,
           um eine Datei oder ein Verzeichnis auszuwÃ€hlen oder <ESC> um den
           Dialog zu verlassen.

Delete files: Der Auswahldialog befindet sich auf der rechten Seite des
              Schirms. Wenn du Dateien aus dem Image entfernen mÃ¶chtest,
              benutze diesen Dialog. DrÃŒcke <ENTF> (<DEL>) um eine Datei zu
              entfernen oder <ESC> um den Dialog zu verlassen.

Create image: Erzeuge aus den gewÃ€hlten Dateien eine Image-Datei. Siehe 
              Optionen weiter unten.

Copy CD image: Erzeuge ein Image aus der CD in deinem Laufwerk.

Write image: Wenn "Write from image" aktiviert ist, wird cdw das Image auf die
             CD schreiben. Wenn diese Option nicht aktiv ist, werden die
             gewÃ€hlten Dateien direkt, ohne Erzeugen eines Images,
             geschrieben.

Copy data CD: Kopiere eine existierende Daten-CD (ein GerÃ€t zum Lesen und eins
              zum Schreiben werden empfohlen).

Blank CD-RW: LÃ¶sche die Daten von einer CD-RW (wiederbeschreibbare CD). In den
             Optionen kannst du wÃ€hlen, welcher LÃ¶schtyp verwendet werden soll:
             'schnell' oder 'vollstÃ€ndig'.

Options: s.u.

Quit:    :)) Rate mal...


Optionen
--------
Hier kannst du die Nutzung von cdrecord, mkisofs, cdda2wav, lame, oggenc und
MySQL konfigurieren, je nach VerfÃŒgbarkeit. Benutze die Reiter fÃŒr General
und Other. Alle Optionen sind mit einer Taste verknÃŒpft. Du kannst die Optionen
durch Druck der entsprechenden Taste verÃ€ndern. Du kannst die Eingabefelder mit
<ENTER> oder mit <ESC> (beenden ohne zu speichern) verlassen.

General properties (1):

SCSI device:
scsibus,target,lun. (FÃŒr ein SCSI-emuliertes IDE CD-RW: 0,0,0)

Speed:
Schreibgeschwindigkeit

Imagefile:
Lesen/Schreiben des Images von/zu dieser Datei

CD-ROM:
LesegerÃ€t (fÃŒr das Kopieren von Daten-CDs oder zum Erzeugen von CD-Images)

Logfile:
mkisofs & cdrecord schreiben Logs in diese Datei

Volume ID:
Passe die ID der CD an

Blank fast:
'cdrecord -blank=fast || all' (schnelles oder vollstÃ€ndiges LÃ¶schen)

Eject when done:
Wirf die CD-Schublade aus, wenn mit dem Schreiben fertig

Disk at once:
Fixiere CD nach dem Schreiben

Joliet information:
Erzeuge Verzeichnisinformationen nach Joliet

Rock Ridge:
Erzeuge Verzeichnisinformationen nach Rock Ridge

Dummy write:
Schreibe im Dummy-Modus

Show log after write:
Zeige den Inhalt des Logs nach dem Schreiben.

Auto show vol.:
Zeige den Dialog zum Bearbeiten der ID der CD vor der Erzeugung des Images.

PAD:
FÃŒge Stille zwischen die Audio-Tracks ein. Siehe cdrecord(1) fÃŒr mehr
Informationen.

Multi-session:
Du kannst zu einer existierenden CD neue Tracks hinzufÃŒgen. Die zuvor
gespeicherten Daten werden nicht verlorengehen. WICHTIG! Du kannst
Multi-Session CDs erzeugen, indem du den ersten Track im Multi-Session-Modus
schreibst.

Burnproof:
Buffer Underrun-sicheres Schreiben. Wenn dein Brenner dieses Feature
unterstÃŒtzt, solltest du es auch mittels dieser Option aktivieren. In diesem
Fall wartet das Programm auf Daten, falls der Puffer leer laufen sollte.


Other properties (2):

CD mount point:
Der CD-Katalog benutzt diese Eigenschaft. Der CD-Katalog wird den Inhalt der
CDs aus diesem Verzeichnis lesen. Es wird vorgeschlagen, das Verzeichnis zu
verwenden, welches bereits in der /etc/fstab fÃŒr den Brenner benutzt wird.
WICHTIG!!! In der /etc/fstab muss der Brenner aufgefÃŒhrt sein, weil cdw die CD
im dort angegebenen Verzeichnis mounten wird.

Auto disk catalog:
FÃŒge die CD nach dem Schreiben zum Katalog hinzu.

MySQL host:
Der Name des Rechners, wo die Datenbank von cdw installiert ist. Es ist
mÃ¶glich, verschiedene Computer fÃŒr die Datenbank und das eigentliche Programm
zu benutzen. Hier musst du den Namen oder die IP-Addresse des Rechners
angeben, wo du die Datenbank installiert hast. Wenn Datenbank und Programm auf
dem gleichen Rechner laufen, dann benutze 'localhost' (default).

MySQL user:
Der Name des Benutzers, der auf die Datenbank von cdw zugreifen darf.

Audio directory:
cdw wird Tracks von den Audio-CDs in dieses Verzeichnis rippen.

Stereo:
Audio-Tracks im Stereo-Modus rippen.

Bit per channel:
8 oder 16 Bits pro Kanal

Echo to sound device:
WÃ€hrend du die Audio-Tracks von der CD "kopierst", wird der Sound auch zur
Soundkarte "kopiert". So kannst du parallel zum Rippen die CD anhÃ¶ren, die
Geschwindigkeit wird aber bei 1x liegen.

Encode to Ogg:
Die Ausgabe-Dateien werden in das Format OggVorbis in Echtzeit enkodiert.

High quality:
Erzeuge VBR-enkodierte Dateien.

Encode to MP3:
Die Ausgabe-Dateien werden in das Format MP3 in Echtzeig enkodiert.

Bitrate:
Konstante Bitrate: 128, 192 oder 256 sind mÃ¶gliche Werte.


DrÃŒcke <F10> zum Speichern und Beenden oder <ESC> zum Beenden ohne zu
speichern.

Die in grau dargestellten Eigenschaften sind deaktiviert. Wenn z.B. die
Eigenschaften von MP3 ausgegraut sind, sollte das Programm 'lame' aktiviert
werden, um sie verfÃŒgbar zu machen.


Tastenbelegung
--------------
<F1>     Zeige Hilfe
<F2>     Zeige und bearbeite "Volume ID"
<F3>     Bearbeite zusÃ€tzliche Paramater, die an cdrecord gegeben werden
         sollen, z.B. -overburn
<F4>     WÃ€hle die GrÃ¶sse der CD
<F5>|<L> Betrachte das letzte Log
<F6>     Informationen ÃŒber das rohe CD-Material (cdrecord -atip)
         (ÃŒberschreibt das letzte Log:( )
<F10>    Zeige die GPL
<E>      CD(-Schublade) auswerfen
<C>      Zeige CD-Katalog
<A>      FÃŒge CD dem Katalog hinzu (falls installiert)
<G>      Rippe Audio-CD
<Q>      Beenden


Audio-CDs rippen
----------------
Wenn du das Interface des Rippers aufrufst, sucht cdw nach einer Audio-CD.
Wenn eine gefunden wurde, zeigt es die Anzahl der Audio-Tracks. Rufe das
Interface erneut auf, wenn du die CD in der Schublade gewechselt haben
solltest. Das Feld 'start track' enthÃ€lt die Tracknummer des ersten zu
rippenden Tracks und cdw wird die Tracks bis 'last track' rippen. Wenn du
z.B. nur den 5. Track rippen mÃ¶chtest, dann mÃŒssen 'start track' und
'last track' beide auf 5 eingestellt sein. Die Ãnderungen werden gespeichert,
wenn du das Rippen mit der Taste <G> beginnst.

CD-Katalog
----------
Der CD-Katalog ist ein eigenstÃ€ndiger Teil von cdw. FrÃŒher haben wir 'dic'
benutzt, was aber nicht interaktiv genug war, weshalb wir unseren eigenen
Katalog entwickelt haben. Dieser CD-Katalog basiert auf MySQL. Das Katalog-
Interface kann auf zwei Arten genutzt werden: Durch das DrÃŒcken von <C> im
HauptmenÃŒ oder durch das Starten von cdw mit dem Parameter -c (oder --catalog).
Du kannst mit den Links- und Rechtspfeilen auf dem Tastenblock zwischen den
MenÃŒs und den kategorisierten Dateien navigieren. Die Hauptebene zeigt immer
die Namen der Kategorien. In diesen Listen findest du die einzelnen CDs,
Verzeichnisse und Dateien. Du kannst zu den Kategorien, CDs oder
Verzeichnissen mittels <ENTER> wechseln. Eine Ebene hÃ¶her geht es mit
<BACKSPACE>. Am unteren Rand des Schirms erscheinen Informationen zum aktuell
ausgewÃ€hlten Element.

CD-Katalog-MenÃŒ:
Show all disk: Zeige alle CDs ohne Kategorien in Sortierung nach CD-Nummern.
               ZurÃŒck mit <BACKSPACE>.

Add disk: FÃŒge CD zum Katalog hinzu.
          1. Lege eine CD in das Laufwerk.
          2. Gib den NAMEN der CD ein.
          3. Gib die NUMMER der CD ein.
          4. Gib den Namen der KATEGORIE ein.
          Du kannst die Prozedur verlassen, indem du <ESC> drÃŒckst. Wenn die
          Kategorie noch nicht existieren sollte, wird sie von cdw erzeugt. cdw
          wird die CD mounten, wenn du die entsprechende Option (/etc/fstab)
          korrekt eingerichtet hast.

Search: Du kannst in den Namen der Dateien und Verzeichnisse suchen. Gib die
        Zeichenkette, die du finden mÃ¶chtest, ein und das Resultat der Suche
        wird angezeigt. cdw sucht in allen Kategorien, CDs und Verzeichnissen.
        Am Ende der Suche kannst du alle CDs, die den Suchbegriff enthielten,
        sehen. Das Programm wird solange die Suchergebnisse zeigen, bis
        "Show all disk" gewÃŒnscht wird. Der obere Rand des Schirms (die
        Suchmarke) informiert dich ÃŒber die Art auf dem Schirm. Wenn aktiviert,
        kannst du das Ergebnis der Suche sehen, ansonsten siehst du alles.

Delete: LÃ¶sche eine CD oder Kategorie aus dem Katalog. Wenn eine CD oder
        Kategorie gelÃ¶scht wird, werden alle untergeordneten Elemente
        ebenfalls gelÃ¶scht! Wenn du eine Kategorie lÃ¶schst, werden alle CDs
        in der Kategorie ebenfalls gelÃ¶scht!
        Das Programm fragt dich vorher, ob du dir wirklich sicher bist, dass
        dieses Element lÃ¶schen willst.

Quit: Beende den CD-Katalog. Wenn du cdw mit -c oder --catalog gestartet
      hattest, wird das Programm beendet, anderenfalls geht es zurÃŒck zum
      HauptmenÃŒ von cdw.

Tasten:
F1     - Zeige Hilfe.
->     - Rufe Fenster mit katalogisierten Dateien auf.
<-     - Rufe HauptmenÃŒ des CD-Katalogs auf.
ENTER  - Wechsel zwischen Kategorie, CD oder Verzeichnis.
BSPACE - Geh eine Ebene hÃ¶her.
DEL    - LÃ¶sche CD oder Kategorie.
A      - FÃŒge CD dem Katalog hinzu.
S      - Zeige alles.
Q      - Beende den CD-Katalog.


Kontakt
-------
Schicke Fehlermeldungen per Elektropost an <vbali@linuxforum.hu>
(in englisch oder ungarisch)
Neueste Version: http://cdw.sourceforge.net

06. Okt. 2003


