# Справочное руководство по &kscd;

Jonathan
Singer

    jsinger@leeta.net

David
White

    a9403784@unet.univie.ac.at

Bernd
Johannes
Wuebben

    wuebben@kde.org

Разработчик
Dirk
Forsterling

    milliByte@gmx.net

Разработчик
Dirk
Foersterling

    milliByte@gmx.net

Разработчик
Lauri
Watts

    lauri@kde.org

Редактор
Константин
Питюл

    pkk2000@mail.ru

Перевод на русский
2000-2001
J Singer
&FDLNotice;
2001-07-19
1.03.02

&kscd; - это небольшой и быстрый аудио CD плеер для Unix с поддержкой CDDB.

KDE
kdemultimedia
kscd
music
CD
audio

## Введение

&kscd; - это быстрый &CD; плеер с поддержкой CDDB для Unix. &kscd; расшифровывается как The KDE Project's small/simple &CD; player.

Новое: Perl скрипт `workman2cddb.pl` облегчает переход пользователям workman.

Я надеюсь, что вам понравится этот &CD; плеер,

Bernd Johannes Wuebben

wuebben@kde.org

### Поддерживаемые платформы

&kscd; полностью поддерживает следующие платформы:

- Linux

- FreeBSD

- NetBSD

- BSD386

- Sun

- &Solaris; (включая поддержку cdda)

- &HP-UX;

- &SGI; Irix (включая поддержку cdda)

- Sony NEWS

- OSF/1

- Ultrix

и должен компилироваться на многих других с небольшими модификациями.

## Основы

### Основные операции

Интерфейс &kscd;
Интерфейс &kscd;

Это главное окно &kscd;. Вы должны увидеть что-то вроде этого после запуска &kscd;. Описание кнопок приведено ниже.

#### Панель управления

Панель управления
Панель управления

Это главная панель управления для &kscd;. Функции этих кнопок должны быть знакомы любому, кто хоть раз использовал &CD; плейер.

Верхняя кнопка переключает режим воспроизведения и паузы &CD;. Левая кнопка во втором ряду останавливает воспроизведение &CD;. Правая кнопка во втором ряду включает непрерывное воспроизведение, при достижении конца последней дорожки &CD; начнется воспроизведение диска с начала. Кнопки в третьем ряду перемещают воспроизведение &CD; назад (налево) или вперёд (направо) на 30 секунд. Кнопки в четвертом ряду устанавливают воспроизведение следующей дорожки (направо) или предыдущей (налево).

#### Кнопка Извлечь

Кнопка Извлечь
Кнопка извлечения диска

Эта кнопка извлекает &CD;. Заметьте, что кнопка извлечения CD на вашем &CD-ROM;е может не работать, если в нем находится аудио &CD; и запущен &kscd;. Некоторые очень старые &CD-ROM;'ы могут не поддерживать программную кнопку извлечения. Также, возможно, вам понадобится вручную закрыть &CD-ROM; после вставки нового диска.

#### Экран состояния

Экран состояния
Экран состояния

Это экран состояния. Вверху, справа налево, показывается основное время (см. ниже описание различных режимов показа времени), состояние &CD-ROM;'а, общее время воспроизведения аудио &CD;, текущая установка уровня громкости, номер текущей дорожки и общее число дорожек (текущ./общ.). На двух нижних рядах показывается: артист и название &CD;, название дорожки, если соответствующие записи будут найдены в локальной или сетевой базе CDDB (&CD; Data Base.)

#### Режимы показа времени

Кнопка переключения режимов показа времени
Кнопка переключения режимов показа времени

Эта кнопка переключает режимы показа времени. По умолчанию, &kscd; показывает оставшееся время текущей дорожки, если &CD; воспроизводится, и ––:–– или 00:00 если &CD; не воспроизводится. При нажатии на эту кнопку режимы показа переключаются в следующем порядке: оставшееся время дорожки, всего прошло времени и всего осталось времени.

#### Кнопка Настройка

Кнопка настройки
Кнопка настройки

Эта кнопка открывает панель настройки &kscd;. Здесь вы можете настроить &kscd; для работы на вашей машине. Прочитайте раздел настройка &kscd;, о подробностях настройки &kscd;

#### Кнопка CDDB

Кнопка CDDB
Кнопка CDDB

Эта кнопка открывает панель редактирования записей CDDB (Compact Disc Data Base).

CDDB может идентифицировать ваш &CD; и, обычно, скачать список дорожек для этого &CD; или загрузить его из локальной базы. Прочтите раздел редактор базы данных &CD; для получения более детальной информации по использованию этой утилиты.

#### Кнопка Сведения

Кнопка для получения сведений
Кнопка для получения сведений

Эта кнопка поможет вам найти информацию об артисте в интернете. Вы можете найти информацию о датах выступления артиста, о ценах и другое, нажав эту клавишу и выбрав соответствующую опцию в всплывающем меню.

#### Кнопка выхода

Кнопка выхода
Кнопка выхода

Эта кнопка закрывает &kscd;.

#### Уровень громкости

Уровень громкости
Уровень громкости

Этим регулятором громкости настраивается выход аудио &CD;. Направо - громче, налево - тише. Если вы слушаете ваш &CD; через звуковую карту, то микшер звуковой карты тоже будет влиять на уровень громкости.

#### Кнопка случайного выбора

Кнопка случайного выбора
Кнопка случайного выбора

Эта кнопка воспроизводит дорожки &CD; в случайном порядке.

#### Выбор дорожки

Выбор дорожки
Выбор дорожки

Эта кнопка поможет вам непосредственно указать дорожку для воспроизведения.

## Настройка &kscd;

### Главное окно настройки

Главное окно настройки &kscd; представляет собой четыре закладки с основными разделами.

- freedb

- Настройки SMTP

- Параметры Kscd

- О программе

### Закладка freedb

Закладка freedb
Закладка freedb

Закладка freedb позволяет настроить функцию CDDB для &kscd;.

Опция Разрешить доступ к freedb включает или выключает просмотр CDDB в Интернете. Можно задать время, в течение которого программа будет пытаться искать запись в Интернете. Для использования &HTTP;-прокси, отметьте Доступ к freedb через HTTP-прокси и введите &URL; в поле ниже.

Текстовое поле Локальный каталог для хранения данных freedb: позволяет вам выбрать каталог, где бы вы хотели хранить записи CDDB.

Раскрывающийся список Сервер freedb: показывает список известных freedb серверов. Выберите запись из этого листа, и она появится в текстовом поле под раскрывающимся списком. Нажмите кнопку Обновить для обновления списка серверов. Нажмите кнопку По умолчанию чтобы ввести значение по умолчанию, `freedb.freedb.org cddbp 888 -`, которое позволит вам обновить список cddb серверов, перечисленных на главном сайте freedb freedb.freedb.org. Нажмите кнопку - для удаления выбранной записи из списка.

Поле Адрес для отправки дополнений freedb: содержит e-mail адрес для отправки записей CDDB. Адрес по умолчанию freedb-submit@freedb.org. Как и в версии 0.8, записи CDDB из &kscd; принимаются для добавления в базу данных. Нажмите клавишу - для удаления выбранной записи из списка. Кнопка По умолчанию устанавливает все значения заданными по умолчанию.Кнопка Помощь открывает файл помощи по &kscd; (этот документ).

Кнопка OK сохраняет текущие настройки и закрывает окно; Кнопка Отмена закрывает окно без сохранения.

### Закладка Настройки SMTP

Закладка Настройки SMTP

Закладка настроек SMTP служит для настройки соединения с почтовым сервером, чтобы отправлять новые записи CDDB. Это полезно, если ваша система не является сервером. Отметьте флажок Отправлять дополнения по почте для включения этой функции. Введите адрес SMTP-сервера в верхнем левом текстовом поле, а номер порта (обычно `25`) в верхнем правом поле. Введите адрес вашей электронной почты в нижнем текстовом поле.

### Закладка Параметры KSCD

Закладка Параметры KSCD
Закладка Параметры KSCD

Поля Цвет индикатора: и Цвет фона: показывают цвета выбранные для индикатора и фона дисплея. Нажмите кнопку Изменить рядом с полем цвета для выбора нужного цвета.

Поле Устройство CDROM: содержит наименование устройства &CD-ROM; используемого для проигрывания аудио &CD;. Значение по умолчанию - `/dev/cdrom`. Данное устройство должно быть доступно только для чтения. Изменение прав доступа к этому устройству потребует прав администратора и может быть сделано из командной строки или в режиме администратора в &konqueror;.

Поле Команда для отправки почты: показывает команду, используемую для отправки новой записи в базу данных CDDB. Значение по умолчанию - ``mail` `-s %s``. Вам нужно убедиться, что эта команда действительно отправляет почту на нелокальные системы, если вы хотите отправлять записи CDDB, особенно если вы соединяетесь с Интернетом по модему. Обратитесь к документации по вашему дистрибутиву Linux. Некоторые дистрибутивы Linux, которые используют sendmail для доставки e-mail, требуют только ввода вашего почтового сервера в поле "Smart" relay host в `/etc/sendmail.cf`. Дополнительно, поскольку сайт CDDB захочет отправить вам ответ; возможно, будет необходимо отредактировать `/etc/sendmail.cf`, чтобы удостовериться, что обратный адрес верен. Возможно настройка вашей системы может несколько отличаться от описанной. Если ничего не получается, то используйте SMTP.

Секция WWW-броузер позволяет вам выбрать, какой броузер использовать для доступа к сайтам в меню информации. Вы можете выбрать &konqueror; или любой другой броузер нажав соответствующую кнопку. По умолчанию, поле Использовать другой броузер: содержит ``kfmclient` `openURL %s``.

Флажок Показывать подсказки включает или выключает подсказки (маленькие окна, которые появляются, когда курсор мыши останавливается над каким-либо элементом окна на некоторое время).

Флажок Встраивать пиктограмму в панель позволяет вставлять управление &kscd; в панель &kicker;.

Флажок Начинать воспроизведение при вставке CD позволяет воспроизводить &CD; сразу после вставки, без необходимости нажимать кнопку Воспроизвести.

Флажок Останавливать воспроизведение при выходе позволяет останавливать воспроизведение &CD; при выходе из &kscd;.

Флажок Извлечь CD по окончании воспроизведения позволяет извлечь &CD; по окончании воспроизведения.

Случайное воспроизведение без повтора дорожек Означает что, когда используется режим Случайная дорожка, каждая дорожка будет воспроизводится только один раз.

Кнопка Помощь открывает справочник по &kscd;.

Кнопка OK сохраняет текущие настройки и закрывает окно; Кнопка Отмена закрывает окно без сохранения.

### Закладка О программе

Закладка О программе показывает сведения о версии &kscd;, которую вы используете, и информацию об авторских правах.

## Редактор базы данных CD

Редактор базы данных CD
Редактор базы данных CD

Редактор базы данных &CD; позволяет вам изменять, скачивать, сохранять и отправлять записи CDDB (Compact Disc Data Base).

Если существует запись в вашей локальной базе данных CDDB (смотрите подраздел CDDB в главе Настройка) для &CD; находящемся в &CD-ROM;, или, если диск будет найден в CDDB, вы увидете имя артиста и название &CD; в поле Артист / название диска и список дорожек с названиями в поле Дорожка / время / название. Иначе, вы увидете список дорожек и время воспроизведения без названий.

Вы можете добавить комментарий для всего диска, нажав на кнопку Комментарий рядом с полем Артист / название диска, или для выбранной дорожки в поле Дорожка / время / название нажав на кнопку Комментарий, находящуюся рядом. Если вы выберете дорожку в поле Дорожка / время / название, название, если оно есть, появится в поле Название выделенной дорожки. Вы можете написать название дорожки в этом поле или отредактировать запись так, как вам хочется. Нажмите кнопку Ввод на клавиатуре, и текст появится в соответствующей линии списка дорожек.

Когда будут даны названия всем дорожкам и поле Артист / название диска будет заполнено, вы можете нажать кнопку Отправить для отправки вашей записи по электронной почте на freedb.

Вас попросят выбрать категорию записи. Раздел ID диска: показывает 32 битный ID код, используемый freedb для идентификации компакт-диска. Над ID кодом находится категория записи CDDB. Эти категории соответствуют дереву подкатологов в каталоге выбранном вЛокальный каталог для хранения данных CDDB: в закладке CDDB окна настройки &kscd;.

Экран Полное время: показывает общее время воспроизведения &CD;.

Редактор списка воспроизведения позволяет изменить порядок воспроизведения диска. Введите номера дорожек в нужном порядке, разделенные запятыми.

Кнопка Сохранить сохраняет запись на диск. Укажите категорию, под которой сохранить запись. Выберите каталог и нажмите Ok.

Кнопка Загрузить позволяет указать каталог для поиска записей CDDB, отличных от находящихся на сервере CDDB или в локальной базе данныхCDDB. Кнопка Закрыть закрывает редактор базы данных &CD; без сохранения.

## Использование &kscd; в панели &kde;

Использование &kscd; в панели &kde;
Использование &kscd; в панели &kde;

Когда флажок Встраивать пиктограмму в панель отмечен, маленький аплет &kscd; появится на Панели KDE. В отличие от главного окна &kscd;, этот аплет доступен на любом рабочем столе. При нажатии правой кнопки мыши на аплете появляется меню управления воспроизведением &CD;. При нажатии левой кнопки мыши на аплете открывается главное окно &kscd;. Если главное окно свернуто, то оно развернется.

Если быть более точным, то аплет находится в системном лотке на панели. Если аплет не появляется, когда &kscd; свернут, то вы, возможно, удалили лоток. Для того, чтобы добавить его, нажмите правую клавишу мыши на пустом месте в панели и выберите Добавить Аплет Системный лоток

## Поддержка CDDB

freedb Data Base - это распределенная сетевая база данных, доступная через Интернет, которая содержит информацию практически обо всех аудио CD. Если у вас есть доступ к Интернету, очевидно, вам не придется вводить вручную информацию о ваших CD, конечно, если вы все правильно настроили. См. подраздел Закладка freedb в главе о конфигурации &kscd; для получения информации по настройке этого сервиса и раздел Редактор базы данных CD для получения информации по редактированию записей CDDB.

Использование CDDB свободное. Поощряются дополнения от пользователей.

Когда вы подготавливаете записи для CDDB, помните следующее:

- Используйте стандартные латинские буквы в записях. Некоторые специальные символы поддерживаются, но, например, кириллица или греческие символы недопустимы.

- Используйте только символ / в поле Артист / название диска редактора базы данных &CD;.

  Для &CD; с классикой, поставьте имя композитора в разделе Артист (перед наклонной чертой) и имя исполнителя в разделе Название диска (после наклонной черты).

- Если вы отправляете запись, которая уже существует в базе данных, то любая дополнительная информация, которую вы введете, может быть добавлена к существующей записи.

По умолчанию &kscd; устанавливает стандартные категории CDDB в `$KDEDIR/share/apps/kscd/cddb`. Вы можете создать столько категорий, сколько вам нужно. Однако, когда вы отправляете запись, будут показаны только общеупотребительные категории CDDB. Адрес для отправки по умолчанию - это freedb-submit@freedb.org. Для получения более детальной информации по freedb посетите домашнюю страницу freedb.

Локальная запись CDDB для обычного &CD; хранится в файле `название категории/ID диска` в каталоге локальной базы CDDB. Эти файлы могут быть отредактированы любым текстовым редактором, если вам не жалко своего времени :-).

## Вопросы и ответы

Я вижу этот диалог после старта &kscd;. Что неправильно?

Диалог ошибок
Диалог ошибок

Это означает, что &kscd; не смог открыть ваше устройство &CD-ROM;. Имя устройства в поле Устройство CDROM в Настройка Kscd должно соответствовать блочному устройству, связанному с вашим &CD-ROM; приводом. Чаще всего, это ссылка на соответствующее IDE (`/dev/hdx`) или SCSI (`/dev/sdx`) устройство.

Файл устройства обычно принадлежит пользователю root в группе root, и обычный пользователь не имеет права открывать его для чтения, записи или исполнения непосредственно. Это не имеет ничего общего с SUID-программой (Set User ID программы используют функцию `setuid()` в стандартной библиотеке Un*x, oтвечающую за идентификацию пользователя) `mount`, которая не имеет проблем с правами доступа; &kscd; должен иметь возможность получать дескриптор файла только для чтения при обращении к &CD; устройству для управления &CD-ROM; привода и читать raw-данные с диска.

Если вы знаете root-пароль, это можно легко исправить. Станьте администратором и введите ``chmod` `a+r` `/dev/cdrom`` чтобы позволить любому пользователю в вашей системе читать из `/dev/cdrom`. Если ваше устройство &CD-ROM; называется как нибудь еще, смените права доступа к этому устройству с помощью той же процедуры. Если у вас нет пароля администратора, попросите вашего системного администратора дать вам доступ на чтение с привода &CD-ROM;.

Также, см. раздел Настройка KSCD

Я не могу заставить работать CDDB. Могу я получить более детальную информацию, что работает не так, как надо?

Если у вас есть проблемы с работой CDDB, попробуйте запустить &kscd; из командной строки с опцией `-d` и просмотрите вывод отладочной информации.

## Разработчики и лицензирование

&kscd; Copyright 1997,1998 Bernd Johannes Wuebben wuebben@kde.orgwuebben >

&kscd; содержит код из:

- workman 1.4 beta 3 Copyright (c) Steven Grimm koreth@hyperion.com

Благодарность Ti Kan и Steve Scherf, разработчикам концепции базы данных CDDB. Посетите http://www.cddb.com для сведений о CDDB.

Особенная благодарность David White, написавшему документацию по &kscd;. Отлично, David!

Документация обновлена для KDE 2.0, и авторские права на нее имеет Jonathan Singer jsinger@leeta.net.

Перевод на русский - Константин Питюл pkk2000@mail.ru

&underFDL; &underGPL;

## Установка

### Где взять &kscd;

&install.intro.documentation;

### Требования

Для успешной компиляции &kscd;, вам необходима последняя версия библиотек KDE, а также библиотека &Qt; C++. Все требуемые библиотеки и сам &kscd; могут быть найдены на &FTP; сайте &kde;, ftp://ftp.kde.org/pub/kde/.

### Сборка и установка

&install.compile.documentation;

Пожалуйста информируйте текущего разработчика, Dirk Foersterling, по адресу milliByte@gmlx.net о любых модификациях, которые вы сделаете для компиляции &kscd; на вашей платформе.

&documentation.index;