# The Kscd Handbook

Bernd Johannes
Wuebben

    wuebben@kde.org

Version 0.8, Jan 17, 1997

This Handbook describes Kdscd Version 0.8

The KSCD Handbook

KDE
KSCD
CD player
CDDB

## Sissejuhatus

Kscd on kiire, CDDB võimalusega cd mängija Unixi platvormile. Kscd tähendab "The KDE Project's small/simple CD player".

Erilised tänud David White'ile kes kirjutas KSCD abidokumentatsiooni! Aitäh David!

New: workman2cddb.pl Perl script provided in order to facilitate transition for users of workman.

Loodan, et teile meeldib see cd-mängija,

`Bernd Johannes Wuebben`

`wuebben@kde.org`

## Toetatud platvormid

KSCD toetab otseselt järgmisi platvorme:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- Solaris (sisaldades cdda toetust)

- HPUX

- SGI Irix (sisaldades cdda toetust)

- Sony NEWS

- OSF/1

- Ultrix

ning peaks väheste modifikatsioonidega kompileeruma ka paljudel teistel.

## Installeerimine

### Kuidas omandada kscd'd

Kscd on osa kdemultimeedia paketist, mis on saadaval KDE projektist http://www.kde.org.

### Nõuded

Et edukalt kompileerida Kscd'd, on sul vaja viimaseid versioone KDE teekidest, samuti ka Qt C++ teekidest. Kõik nõutud teegid nagu ka Kscd ise, on saadaval ftp://ftp.kde.org/pub/kde/.

### Kompileerimine ja installeerimine

Et kompileerida ja installeerida Kscd'd oma süsteemi,trüki järgnev baaskataloogi Kscd distributsioonis:

    % ./configure
    % make
    % make install

Palun informeeriga mind igast modifikatsioonist, mille pidite ette võtma selleks, et KSCD kompileeruks teie platvormil.

## Ekraanil nähtavad põhiosad

### Põhiline toimimine

#### Põhiline aken

See on kscd põhiline aken.Sa peaks nägema midagi sellelaadset kui alustad kscd. Akent kontrollivad elemendid on tutvustatud allpool, mitte mingis täpses järjekorras.

#### Põhiline kontrollpaneel

See on kscd põhiline kontrollpaneel. Nende nuppude funktsioon peaks olema tuttav kõigile, kes kunagi CD mängijat kasutanud on. Kõige ülemine nuppülemise diagrammi lülitab CD mängu ja pausi vahel. Vasak nupp teises reas peatab CD mängu. Parem nupp teises reas lülitab sisse silmuse funktsiooni,mis tähendab, et CD hakkab otsast peale mängima, kui viimane audiolugu on lõppenud. Nupud kolmandas reas lasevad CD'd pöörata tagasi (vasak) või edasi (parem) 30 sekundit. Nupud neljandas reas liigutavad CD'd edasi(parem) või tagasi (vasak) kas järgneva või eelneva loo algusse.

#### Väljastamise nupp

See nupp väljastab CD. Pange tähele,et väljastamise nupp teie CD-ROM'il ei pruugi vastata, kui sees on audio CD ja kscd on aktiveeritud.Mõned väga vanad CD-ROM'id ei pruugi toetada CD tarkvaralist väljastamist.Võib juhtuda, et peate käsitsi sulgema CD-ROM'i peale uue CD sisestamist.

#### Olekunäidik

See on olekunäidik. Alustades ülalt, paremalt vasemale on põhiline ajanäidik (Vaata allpool erinevaid võimalikke ajanäitamise mooduseid), CD-ROMi draivi staatus, audio CD terve mänguaeg, hetkeline valjuse seadistus, käesolev ja maksimaalne lugude arv (käesol. / maks.).Alumised kaks rida teksti näitavad esitajat ja CD nimetust, loo pealkirja, eeldades, et sobivad sisendid eksisteerivad lokaalselt või võrgus CDDB (CD Data Base).

#### Aja näitamise rezhiimi nupp

See nupp lülitab võimalike põhiliste aja näitamise rezhiimide vahel.Vaikimisi kscd näitab käesoleva loo mängitud aega, kui CD mängib või --:-- või 00:00 Kui CD ei mängi. Nupu vajutamisel lülitub kas loo järelejäänud aeg, terve mängitud aeg, või terve jäerelejäänud aeg.

#### Konfiguratsiooninupud

See nupp avab kscd konfiguratsioonipaneeli.See lubab sul konfigureeruda kscd töötamaks sinu arvutil.Vaata kscd konfigureerimine detailide kohta, et konfigureerida kscd'd.

#### CDDB redaktornupud

See nupp avab CDDB (Compact Disc Data Base) sisendi redaktori paneeli. CDDB suudab identifitseerida CD ja laadida sisse lugude nimekirja sellel CD või laadide selle failisüsteemist. Vaata CD Andmebaasi Redaktor selle tööriista detailide kasutamise kohta.

#### Info nupp

See nupp aitab sul otsida infot esitaja kohta Internetist. Võid teada saada esinemiskuupäevad, hinnainfot, ja muudki informatsiooni sellel nupule vajutades ja valides sobiva valiku ilmuvast hüpikmenüüst.

#### Sisse / välja nupp

See nupp sulgeb kscd.

#### Valjuse liugur

See liugur kontrollib CD audioväljundi valjust. Parem on valjem, Vasak on vaiksem. Kui mängid CDd CD läbi oma helikaardi, siis mõjutab kaardi mikser mängimise helivljust samamoodi.

#### Otsene loo valik

See liitboks võimaldab sul otseselt valida loo, mida soovid kuulata.

#### Juhusliku järjekorra nupp

See nupp mängib CD lood juhuslikus järjekorras.

### kscd konfigureerimine.

Primaarne konfiguratsiooniaken kscd jaoks on märgistatud dialoog kolmes põhilises sektsioonis.

- CDDB

- Kscd Valikud

- Järgnevast

#### The CDDB tab

CDDB tabel seadistab CDDB (Compact Disc Data Base) funktsioonid kscd'le. "Luba Kaug- CDDB" kontrollboks lülitab sisse ja välja CDDB otsingud üle Interneti.

"CDDB Baaskataloog"" tekstiväljad lasevad sul valida kataloogi, kus sa soovid CDDB sisendeid lokaalselt säilitada.

"Saada CDDB ülestähendused:" väli sisaldab E-maili aadressi kuhu CDDB sisendeid saata. Vaikimisi aadress on "xmcd-cddb@amb.org". Versiooni 8.0 puhul, CDDB sisendid kscd'st on vastuvõetavad andmebaasi kaasamiseks.

"CDDB Server" nimekirja boks näitab tuntud CDDB servereid. Vali sisend sellest nimekirjast ja see ilmub tekstiväljana ülalpool valikuboksi. Vajuta "Uuendus"nuppu uuendamaks CDDB servereid nimekirja boksis. Vajuta "Vaikimisi" nuppu sisestamaks vaikimisi väärtust, "cddb.cddb.com 888", mis lubab sul uuendada nimekirja uuega CDDB Serveritest mis asub põhilises CDDB saidis aadressil cddb.cddb.com.

"Abi" nupp avab kscd abi kodulehekülje.

#### Kscd Vlikute tabel

"LEDi Värv:" ja "Tausta Värv:" väljad näitavad värvi, mis on valitud esiplaanile ja taustale olekunäidikul. Vajuta "Muuda" nuppu värviboksi kõrval nende värvide muutmiseks.

"CDROM Seade" väli sisaldab CDROM seadme nime mida kasutatakse audio CDde mängimisel. Vaikimisi väärtus on "/dev/cdrom". Load sellele seadmele peab seadistama selle avamiseks vaid lugemiseks.Loa muutusi selle seadme failis nõuab peaaegu alati superuseri privileege ja on võimalik teha käsurealt või "Super User Mode" kfm'is.

"Unixi meili käsk" väli näitab käsku, mida kasutati uute CDDB sisendite saatmisel andmebaasi. Vaikimisiväärtus on "mail -s "&percnt;s"". Sa peab kindlaks tegema et käsk saadab ka tegelikult meili mittelokaalsesse süsteemi , kui sa tahad lisada andmeid CDDB andmebaasi, eriti kui su ligipääs Internetile on on läbi modemiühenduse.Kontrolli dokumentatsiooni oma Linuxi distributsiooni üksikasjade kohta. Mõned Linuxi distributsioonid, mis kasutavad sendmail'i e-meili jaoks nõuavad vaid meili hosti sisestamist ""Smart'i" relay host" väli /etc/sendmail.cf.Lisaks, CDDB sait soovib võimalust tagasi meilimiseks; seetõttu võib vajalik olla redakteerida /etc/sendmail.cf kindlustamaks, et sinu meiliaadress on kehtiv. Sinu puhul võib olla muidugi teisiti.

"WWW-Brauser" sektsioon laseb sul valida, millist brauserit kasutada Web'i saitide ligipääsuks info nupp menüüs. Sa võid valida kas kfm või oma brauseri. Vaikimisi "Kasuta Oma Brauserit" väli sisaldab "netscape "&percnt;i"", kasutamiseks Netscape Navigator või Communicator.

"Näita Tööriista Nõuandeid" Kontrollboks lülitab tööriista nõuanded (väikesed aknad,mis hüppavad välja kui hiir "peatub" ) sisse või välja.

"Abi"nupp avab kscd'i abi kodulehekülje.

#### Info tabel

"Info" tabel annab infot autorite, kscd kasutatava versiooni ja autoriõiguse kohta.

### CD andmebaasi redaktor

CD Andmebaasi redaktor lubab sul modifitseerida, laadida, salvestada, annoteerida, ja üles laadida CDDB (Compact Disc Data Base) sisendeid. Kui on olemas sisend su lokaalses CDDB puus (vaata CDDB Tabel kscd konfiguratsiooni aknas) CDle sinu CD-ROMi draivis,või kui plaat on leitav CDDBs,näed sa esitaja nime ja CD tiitlit järgnevas: "Plaat Esitaja / Tiitel"välja ja nimekirja lugude pealkirjades järgnevast: "Lugu / Aeg / Pealkiri " valikuboksis.Muidu näed sa lugude nimekirja ja esitusaegu ilma pealkirjadeta.

Sa või teha sissekande tervele plaadile käsuga "Lained. info" nupuga, mis asub "Plaadi esitaja / Pealkiri" välja kõrval, või valitud loo "Lugu / Aeg /Pealkiri" valikuboksile lisaks "Laiend.info" nupp.

Kui sa valid loo "Lugu / Aeg /Pealkiri" valikuboksis, siis olemasolu korral, ilmub pealkiri the "Edit Track Title" field below. You can type a title for the pealkiri boksi, kus on võimalik vastavalt vajadustele seda redigeerida. Vajuta the "Enter" klahvi klaviatuuril ja tekst ilmub vastavalt ühel real valikuboksis.

Kui kõigile lugudele on antud pealkirjad ja "Plaadi esitaja / Pealkrir" väli on täidetud, siis võid vajutada "Saada" nuppu, et saata oma sissekanne e-maili teel CDDBsse.Sul palutakse valida sissekande kategooria.

"Plaadi ID" sektsioon näitab 32 bitist ID koodi, mida CDDB kasutab CD identifitseerimiseks. ID koodi kohal asub CDDB sisendi kategooria. Need kategooriad vastavad alamkataloogide puule valitud kataloogist "CDDB Baas Kataloogis", CDDB tabel kscd konfiguratsiooniaknas.

"Mänguaeg:" näidik näitab terve CD mänguaega kokku.

The "Play List Editor" lets you change the play order of a disc. Enter a comma seperated list of track numbers to define a new play order.

The "Save" button writes the displayed record to disk. You will be prompted to select a category under which to save the record. Select a directory and press "Ok" to finish saving.

The "Load" button will prompt you for a location to look for a CDDB entry other than a remote CDDB server or the local CDDB entries in the file system.

The "Close" button closes the CD Database Editor.

## CDDB Support

The Compact Disc Data Base is a distributed network database accessible over the Internet that contains information about most audio CDs in circulation. If you have Internet access, you will likely never have to manually enter track information for your CDs if you have this set up properly. See the the CDDB tab of the Configuration window for detailed instructions on how to configure this service, and The CD Database Editor for instructions on how to edit CDDB entries.

Use of the CDDB is free. Submissions from users are encouraged.

When preparing entries for the CDDB, please keep the following points in mind:

- Use "standard" latin characters in the entries. Some special characters are supported, but Cyrillic or Greek alphabet submissions, for example, cannot be accepted.

- Use only one "/" character in the "Disc Artist / Title" field in the "CD Database Editor". For classical CDs, it is standard practice to put the composer's name in the Artist section (before the slash) and the performer's name in the Title section (after the slash).

- If you send an entry that already exists in the database, any additional information you provide may be added to the existing entry.

By default, kscd installs the standard CDDB categories in $KDEDIR/share/apps/kscd/cddb. You can create as many category subdirectories as you like. However,when uploading only the offical CDDB categories are displayed. The default upload address is "xmcd-cddb@amb.org". For more information about CDDB visit the CDDB homepage.

The local CDDB entry for a particular CD is stored in the file <category name>/<disc ID> under the "CDDB Base Directory". These files can be edited with any text editor if you have nothing better to do with your spare time.

## Questions and answers

- Q. I see this dialog when I start kscd. What's wrong?

  A. This means that kscd couldn't open your CDROM drive. The name of the device in the "CDROM Device" field of the "kscd Configuration" must actually refer to the block device associated with your CD-ROM drive. This will often be a hardlink to the appropriate IDE (/dev/hdx) or SCSI (/dev/sdx) device. The device file normally belongs to user root in group root, and does not allow normal users to open it for reading, writing, or execution directly. This has *nothing* to do with the SUID (Set User ID programs use the setuid() function in the standard Un*x library to assume the identity of another user) mount command, which has no problems with permissions; kscd must be able to get a read-only file descriptor referring to the CD device to control the CDROM drive and read raw data off the disk.

  If you have the root password, you can fix this quickly and easily. Become root and type chmod a+r /dev/cdrom to allow any user on your system to read from /dev/cdrom. If your CDROM device is called something else, change the permissions on that device with the same procedure. If you don't have the root password, ask your system administrator nicely to give you read permission for the CDROM device.

  See also section Configuring kscd.

- Q. I can't get the CDDB to work. Can I get any detailed information about what may be going wrong?

  A. If you experience trouble with the CDDB functionality try to starting kscd from the command line with the `-d` switch and observe the debug output.

## Thanks

Special thanks to Ti Kan and Steve Scherf, the inventors of the CDDB database concept. Visit www.cddb.com for more information on CDDB.

Thanks also to Paul Harrison pfh@yoyo.cc.monash.edu.au for writing Synaesthesia on which KSCD Magic is based.

A very special thank you also to David White who wrote the KSCD help documentation. Great Job David!

## Copyright

    Kscd Copyright (c) 1997,1998  Bernd Johannes Wuebben
    wuebben@kde.org

    kscd contains code from:
    workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com
    Synaesthesia 1.3 Copyright (c) Paul Harrison pfh@yoyo.cc.monash.edu.au

    This program is free software; you can redistribute it and/or modify
    it under the terms of the GNU General Public License as published by
    the Free Software Foundation; either version 2 of the License, or
    (at your option) any later version.

    This program is distributed in the hope that it will be useful,
    but WITHOUT ANY WARRANTY; without even the implied warranty of
    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
    GNU General Public License for more details.

    You should have received a copy of the GNU General Public License
    along with this program; if not, write to the Free Software
    Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.