.\" -*- coding: UTF-8 -*- .\" Process this file with .\" groff -man -Tascii ogg123.1 .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH ogg123 1 "24. März 2010" "Xiph.Org Foundation" "Vorbis Tools" .SH BEZEICHNUNG ogg123 \- spielt OGG\-Vorbis\-Dateien ab .SH ÜBERSICHT \fBogg123\fP [ \fB\-vqrzZVh\fP ] [ \fB\-k\fP \fISekunden\fP ] [ \fB\-x\fP \fIntes\fP ] [ \fB\-y\fP \fInmal\fP ] [ \fB\-b\fP \fIPuffergröße\fP ] [ \fB\-d\fP \fITreiber\fP [ \fB\-o\fP \fIOption:Wert\fP ] [ \fB\-f\fP \fIDateiname\fP ] ] \fIDatei\fP \fB…\fP | \fIVerzeichnis\fP \fB…\fP | \fIURL\fP \fB…\fP .SH BESCHREIBUNG \fBogg123\fP liest Ogg\-Vorbis\- und FLAC\-Dateien und gibt diese dekodiert an die in der Befehlszeile angegebenen Geräte aus. Als Vorgabe nutzt \fBogg123\fP das Standard\-Audiogerät, aber die Ausgabe kann an beliebig viele Geräte gesendet werden. Dateien können aus dem Dateisystem gelesen oder URLs als Datenstrom über HTTP verwendet werden. Falls ein Verzeichnis angegeben wird, werden alle darin oder in seinen Unterverzeichnissen enthaltenen Dateien wiedergegeben. .SH OPTIONEN .IP "\-\-audio\-buffer n" verwendet einen Audio\-Ausgangspuffer von etwa »n« Kilobyte. .IP "\-@ Wiedergabeliste, \-\-list Wiedergabeliste" Alle in der Datei »Wiedergabeliste« enthaltenen Dateien wiedergeben. Die Wiedergabeliste sollte einen Dateinamen, einen Verzeichnisnamen oder eine URL pro Zeile enthalten. Leerzeilen sind unzulässig. Verzeichnisse werden auf die gleiche Weise behandelt wie in der Befehlszeile. .IP "\-b n, \-\-buffer n" verwendet einen Audio\-Eingangspuffer von etwa »n« Kilobyte. Diese Option steht nur für HTTP zur Verfügung. .IP "\-p n, \-\-prebuffer n" verwendet »n« Prozent des Eingangspuffers als Vorpuffer. Die Wiedergabe beginnt erst, wenn dieser Vorpuffer vollständig gefüllt ist. Diese Option steht nur für HTTP zur Verfügung. .IP "\-d Gerät, \-\-device Gerät" gibt das Ausgabegerät an. Im Abschnitt \fBGERÄTE\fP finden Sie eine Liste der Geräte. Beliebig viele Geräte können angegeben werden. .IP "\-f Dateiname, \-\-file Dateiname" gibt die Ausgabedatei für ein Datei\-Gerät an, das vorher mit \fB\-\-device\fP angegeben wurde. Der Dateiname »\-« schreibt in die Standardausgabe. Falls die Zieldatei bereits existiert, wird diese durch \fBogg123\fP überschrieben. .IP "\-h, \-\-help" zeigt Hilfe zur Befehlszeile an. .IP "\-k n, \-\-skip n" überspringt die ersten »n« Sekunden. »n« kann auch in Minuten:Sekunden oder Stunden:Minuten:Sekunden angegeben werden. .IP "\-K n, \-\-end n" stoppt die Wiedergabe »n« Sekunden nach dem Beginn des Datenstroms. »n« kann auf die gleiche Weise wie in der Option \fI\-\-skip\fP formatiert werden. .IP "\-o Option[:Wert], \-\-device\-option Option[:Wert]" setzt die Option \fIOption\fP für das vorher benannte Gerät auf \fIWert\fP. Im Abschnitt \fBGERÄTE\fP finden Sie eine Liste gültiger Optionen für jedes Gerät. .IP "\-q, \-\-quiet" Stiller Modus. Es werden keine Meldungen angezeigt. .IP "\-V, \-\-version" Versionsinformationen anzeigen. .IP "\-v, \-\-verbose" zeit ausführlichere Informationen an. .IP "\-x n, \-\-ntes" spielt jeden »n«\-ten dekodierten Block ab. Dies hat den Effekt, dass die Wiedergabe gegenüber der Normalgeschwindigkeit »n«\-mal schneller erfolgt. .IP "\-y n, \-\-nmal" gibt jeden Block »n«\-mal wieder. Dies hat den Effekt, dass die Wiedergabe gegenüber der Normalgeschwindigkeit »n«\-mal langsamer erfolgt. Kann zusammen mit \-x verwendet werden, um nicht ganzzahlige Geschwindigkeiten zu erzielen. .IP "\-r, \-\-repeat" wiederholt die Wiedergabeliste endlos. .IP "\-z, \-\-shuffle" gibt Dateien in pseudozufälliger Reihenfolge wieder. .IP "\-Z, \-\-random" gibt Dateien endlos in pseudozufälliger Reihenfolge wieder. .SH GERÄTE \fBogg123\fP unterstützt eine Reihe von Audio\-Ausgabegeräten unter Nutzung von libao. Nur von der jeweiligen Zielplattform unterstützte Geräte werden verfügbar sein. Die Option \fB\-f\fP kann nur bei Geräten verwendet werden, die in eine Datei schreiben können. Von allen Geräten unterstützte Optionen: .RS .IP debug Wenn möglich, die Fehlerdiagnose\-Ausgabe für den gewählten Treiber aktivieren. .IP matrix:Wert Eine spezifische Anordnung der Ausgabekanäle für ein angegebenes Gerät erzwingen. \fIWert\fP ist eine durch Kommata getrennte Liste von Kanalnamen in AO\-Schreibweise, beispielsweise L,R,C,LFE,BL,BR,SL,SR. .IP verbose Die ausführliche Ausgabe für den gewählten Treiber aktivieren. Die Option \-v aktiviert diese Treiberoption ebenfalls. .IP quiet Den gewählten Treiber zwingen, sich vollkommen still zu verhalten. Selbst Fehlermeldungen werden in diesem Modus nicht ausgegeben. Die Option \-q aktiviert diese Treiberoption ebenfalls. .RE .IP \fBaixs\fP AIX\-Live\-Ausgabetreiber. Optionen: .RS .IP dev:Wert setzt das AIX\-Ausgabegerät auf \fIWert\fP. .RE .IP \fBalsa\fP Advanced\-Linux\-Sound\-Architecture\-Live\-Ausgabetreiber. Optionen: .RS .IP buffer_time:Wert Überschreibt die vorgegebene Größe des Hardwarepuffers (in Millisekunden). .IP dev:Wert Die Bezeichnung des zu verwendenden ALSA\-Geräts. Beispiele dafür sind »hw:0« für die erste Soundkarte und »hw:1« für die zweite. Der ALSA\-Treiber wählt normalerweise automatisch »surround71«, »surround51«, »surround40« oder »default«, in Abhängigkeit von der Anzahl der Ausgabekanäle. Weitere Informationen finden Sie unter http://alsa.opensrc.org/ALSA+device+labels. .IP period_time:Wert Überschreibt die vorgegebene Periodengröße der Hardware (in Mikrosekunden). .IP period_time:Wert Überschreibt die vorgegebene Periodengröße der Hardware (in Mikrosekunden). .IP use_mmap:Wert \fIWert\fP wird auf »yes« oder »no« gesetzt, um das einkompilierte Vorgabeverhalten zur Nutzung von mmap\-Gerätezugriffen zu überschreiben. In der Vergangenheit arbeiteten einige fehlerbehaftete ALSA\-Treiber besser ohne mmap\-Zugriff, mit dem Nachteil einer etwas höheren Auslastung des Prozessors. .RE .IP \fBarts\fP aRts\-Sound\-Daemon\-Live\-Ausgabetreiber. Optionen: .RS .IP multi:Wert setzt \fIWert\fP auf »yes« oder »no«, um das Öffnen des aRts\-Wiedergabegerätes für mehrere, voneinander unabhängige Wiedergabevorgänge zu ermöglichen. Obwohl der Treiber in diesem Multi\-Modus sauber arbeitet, kann es bekanntermaßen zu gelegentlichen Abstürzen des aRts\-Servers selbst kommen. Die Vorgabe ist »no«. .RE .IP \fBau\fP Sun\-Audioausgabe in eine Datei im AU\-Format. Dieses Format unterstützt das Schreiben in nicht durchsuchbare Dateien, wie die Standardausgabe. In diesen Fällen geben die AU\-Headerinformationen nur das Samplingformat, aber nicht die Spieldauer der Aufnahme an. .IP \fBesd\fP Enlightened\-Sound\-Daemon\-Live\-Ausgabe. Optionen: .RS .IP host:Wert \fIWert\fP gibt den Namen des Rechners an, auf dem esd läuft. Das Anhängen einer Portnummer nach einem Doppelpunkt ist möglich, wie in »whizbang.com:555«. (Vorgabe = localhost) .RE .IP \fBirix\fP IRIX\-Live\-Ausgabetreiber. .IP \fBmacosx\fP MacOS\-X\-AUHAL\-Live\-Ausgabetreiber. Dieser Treiber unterstützt MacOS X 10.5 und neuer (10.4 und dessen Vorgängerversionen nutzen eine ältere, inkompatible Schnittstelle). Optionen: .RS .IP buffer_time:Wert Setzt die hardwareseitige Puffergröße auf den Gegenwert von \fIWert\fP Millisekunden. .RE .IP \fBnas\fP Network\-Audio\-Server\-Live\-Ausgabetreiber. Optionen: .RS .IP buf_size:Wert legt die Größe des Audiopuffers auf dem Server in Bytes fest. .IP host:Wert gibt den Ort des NAS\-Servers an. In nas(1) finden Sie Hinweise zur Formatierung. .RE .IP \fBnull\fP Null\-Treiber. Alle Audiodaten werden verworfen. (Achtung: Die Audiodaten werden nicht nach \fB/dev/null\fP geschrieben!) Sie können diesen Treiber verwenden, um die unverfälschte Dekodierungsgeschwindigkeit ohne die Belastung durch die Ausgabe zu testen. .IP \fBoss\fP Open\-Sound\-System\-Treiber für Linux und FreeBSD in den Versionen 2, 3 und 4. Optionen: .RS .IP dsp:Wert DSP\-Gerät für die Soundkarte. Vorgabe ist \fB/dev/dsp\fP. .RE .IP \fBpulse\fP Pulseaudio\-Live\-Ausgabetreiber. Optionen: .RS .IP server:Wert gibt den Ort des entfernten oder alternativen Pulseaudio\-Servers an. .IP sink:Wert gibt ein nicht als Standard festgelegtes Pulseaudio\-Ziel für den Audio\-Datenstrom an. .RE .IP \fBraw\fP Ausgabe der Rohdaten in eine Datei. Die Audiodaten werden in unbearbeiteter Form in eine Datei geschrieben. Optionen: .RS .IP byteorder:Wert wählt Big Endian (»big«), Little Endian (»little«) oder die native (»native«) Byte\-Reihenfolge. Vorgabe ist die native Reihenfolge. .RE .IP \fBroar\fP Roar\-Audio\-Daemon\-Live\-Ausgabetreiber. Optionen: .RS .IP host:Wert gibt den Ort des zu verwendenden entfernten Roar\-Servers an. .RE .IP \fBsndio\fP OpenBSD\-SNDIO\-Live\-Ausgabetreiber. Optionen: .RS .IP dev:Wert gibt das Audiogerät für die Wiedergabe an. .RE .IP \fBsun\fP Sun\-Audio\-Live\-Ausgabetreiber für NetBSD, OpenBSD und Solaris. Optionen: .RS .IP dev:Wert Audiogerät für die Soundkarte. Vorgabe ist \fB/dev/audio.\fP .RE .IP \fBwav\fP Ausgabe in WAV\-Datei. Schreibt die Audiodaten in nicht komprimierter Form auf das Speichergerät. Wenn mehrere Dateien wiedergegeben werden, so werden diese zu einer WAV\-Datei zusammengeführt. Es ist nicht möglich, WAV\-Daten in nicht durchsuchbare Dateien zu schreiben, wie beispielsweise die Standardausgabe. Verwenden Sie in diesem Fall das AU\-Format. .IP \fBwmm\fP Windows\-MultiMedia\-Live\-Ausgabetreiber für Win98 und neuer. Optionen: .RS .IP dev:Wert wählt das für die Wiedergabe zu verwendende Audiogerät nach dem Gerätenamen aus. .IP id:Wert wählt das Audiogerät für die Wiedergabe anhand der Gerätekennung (Kartennummer) aus. .RE .SH BEISPIELE Die Befehlszeile von \fBogg123\fP ist recht flexibel, aber vielleicht etwas verwirrend. Nachfolgend finden Sie einige Beispiele mit Erklärungen, was diese bewirken. .PP Über die Standard\-Soundkarte wiedergeben: .RS \fBogg123 test.ogg\fP .RE .PP spielt alle Dateien im Verzeichnis ~/Musik und dessen Unterverzeichnissen ab. .RS \fBogg123 ~/Musik\fP .RE .PP Eine Datei mit dem OSS\-Treiber wiedergeben: .RS \fBogg123 \-d oss test.ogg\fP .RE .PP Die »dsp«\-Option an den OSS\-Treiber übergeben: .RS \fBogg123 \-d oss \-o dsp:/dev/mydsp\fP .RE .PP Den ESD\-Treiber verwenden: .RS \fBogg123 \-d esd test.ogg\fP .RE .PP Den WAV\-Treiber für »test.wav« als Ausgabedatei verwenden: .RS \fBogg123 \-d wav \-f test.wav test.ogg\fP .RE .PP Eine Datei wiedergeben, während diese gleichzeitig in eine WAV\-Datei geschrieben wird: .RS \fBogg123 \-d oss \-d wav \-f test.wav test.ogg\fP .RE .PP Beachten Sie, dass die Optionen auf das links angegebene Gerät angewendet werden: .RS \fBogg123 \-d oss \-o dsp:/dev/mydsp \-d raw \-f test2.raw \-o byteorder:big test.ogg\fP .RE .PP Belastungstest für Ihre Festplatte: .RS \fBogg123 \-d oss \-d wav \-f 1.wav \-d wav \-f 2.wav \-d wav \-f 3.wav \-d wav \-f 4.wav \-d wav \-f 5.wav test.ogg\fP .RE .PP Einen Echoeffekt mit esd auf einem weniger leistungsstarken Rechner erzeugen: .RS \fBogg123 \-d esd \-d esd test.ogg\fP .RE .PP .SH UNTERBRECHUNG Sie können \fBogg123\fP jederzeit durch Drücken von Strg\-C abbrechen. Wenn mehrere Dateien wiedergegeben werden, dann wird die Wiedergabe der aktuellen Datei abgebrochen und mit der nächsten fortgesetzt. Wenn Sie die Wiedergabe vollständig beenden wollen, statt nur zur nächsten Datei zu springen, dann drücken Sie Strg\-C während der ersten Sekunde der Wiedergabe der neuen Datei. .P Beachten Sie, dass die Reaktion auf das Drücken von Strg\-C möglicherweise nicht sofort hörbar ist, da die wiedergegebenen Daten im Audiogerät gepuffert werden. Die Verzögerung ist systemabhängig, beträgt aber in der Regel nicht mehr als ein oder zwei Sekunden. .SH DATEIEN .TP /etc/libao.conf Kann dazu verwendet werden, das Standard\-Ausgabegerät für alle libao\-Programme festzulegen. .TP ~/.libao Benutzerdefinierte Konfigurationsdatei, welche die systemweiten Einstellungen für das Ausgabegerät überschreibt. .PP .SH FEHLER Über eine Pipe weitergeleitete WAV\-Dateien können seltsames Verhalten anderer Programme hervorrufen. Das rührt daher, dass WAV\-Dateien die Datenlänge (Spieldauer) in den Headerinformationen speichern. Allerdings weiß der Ausgabetreiber nichts über die Länge, wenn die Header geschrieben werden, und es gibt keinen Wert, der auf »Länge unbekannt« verweisen könnte. Verwenden Sie deshalb den Raw\- oder AU\-Ausgabetreiber, wenn Sie ogg123 in einer Pipe nutzen wollen. .SH AUTOREN .TP Programmautoren: .br Kenneth Arnold .br Stan Seibert .br .TP Autor der Handbuchseite: .br Stan Seibert .SH "SIEHE AUCH" .PP \fBlibao.conf\fP(5), \fBoggenc\fP(1), \fBvorbiscomment\fP(1), \fBogginfo\fP(1) .SH ÜBERSETZUNG Die deutsche Übersetzung dieser Handbuchseite wurde von Frank Stähr und Mario Blättermann erstellt. Diese Übersetzung ist Freie Dokumentation; lesen Sie die .UR https://www.gnu.org/licenses/gpl-3.0.html GNU General Public License Version 3 .UE oder neuer bezüglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG übernommen. Wenn Sie Fehler in der Übersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die .MT debian-l10n-german@\:lists.\:debian.\:org Mailingliste der Übersetzer .ME .