ogg123(1) Vorbis Tools ogg123(1) BEZEICHNUNG ogg123 - spielt OGG-Vorbis- und Flac-Dateien ab UBERSICHT ogg123 [ -vqrzZVh ] [ -k Sekunden ] [ -x ntes ] [ -y nmal ] [ -b Puffergrosse ] [ -d Treiber [ -o Option:Wert ] [ -f Dateiname ] ] Datei | Verzeichnis | URL BESCHREIBUNG ogg123 liest Ogg-Vorbis-, Ogg/Speex-, Ogg/Opus-, Ogg/FLAC- und native FLAC-Dateien und gibt diese dekodiert an die in der Befehlszeile angegebenen Gerate aus. Als Vorgabe nutzt ogg123 das Standard-Audiogerat, aber die Ausgabe kann an beliebig viele Gerate gesendet werden. Dateien konnen aus dem Dateisystem gelesen oder URLs als Datenstrom uber HTTP verwendet werden. Falls ein Verzeichnis angegeben wird, werden alle darin oder in seinen Unterverzeichnissen enthaltenen Dateien wiedergegeben. OPTIONEN --audio-buffer n verwendet einen Audio-Ausgangspuffer von etwa >>n<< Kilobyte. -@ 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 unzulassig. Verzeichnisse werden auf die gleiche Weise behandelt wie in der Befehlszeile. -b n, --buffer n verwendet einen Audio-Eingangspuffer von etwa >>n<< Kilobyte. Diese Option steht nur fur HTTP zur Verfugung. -p n, --prebuffer n verwendet >>n<< Prozent des Eingangspuffers als Vorpuffer. Die Wiedergabe beginnt erst, wenn dieser Vorpuffer vollstandig gefullt ist. Diese Option steht nur fur HTTP zur Verfugung. -d Gerat, --device Gerat gibt das Ausgabegerat an. Im Abschnitt GERATE finden Sie eine Liste der Gerate. Beliebig viele Gerate konnen angegeben werden. -f Dateiname, --file Dateiname gibt die Ausgabedatei fur ein Datei-Gerat an, das vorher mit --device angegeben wurde. Der Dateiname >>-<< schreibt in die Standardausgabe. Falls die Zieldatei bereits existiert, wird diese durch ogg123 uberschrieben. -h, --help zeigt Hilfe zur Befehlszeile an. -k n, --skip n uberspringt die ersten >>n<< Sekunden. >>n<< kann auch in Minuten:Sekunden oder Stunden:Minuten:Sekunden angegeben werden. -K n, --end n stoppt die Wiedergabe >>n<< Sekunden nach dem Beginn des Datenstroms. >>n<< kann auf die gleiche Weise wie in der Option --skip formatiert werden. -o Option[:Wert], --device-option Option[:Wert] setzt die Option Option fur das vorher benannte Gerat auf Wert. Im Abschnitt GERATE finden Sie eine Liste gultiger Optionen fur jedes Gerat. -q, --quiet Stiller Modus. Es werden keine Meldungen angezeigt. -V, --version Versionsinformationen anzeigen -v, --verbose zeit ausfuhrlichere Informationen an. -x n, --ntes spielt jeden >>n<<-ten dekodierten Block ab. Dies hat den Effekt, dass die Wiedergabe gegenuber der Normalgeschwindigkeit >>n<<-mal schneller erfolgt. -y n, --nmal gibt jeden Block >>n<<-mal wieder. Dies hat den Effekt, dass die Wiedergabe gegenuber der Normalgeschwindigkeit >>n<<-mal langsamer erfolgt. Kann zusammen mit -x verwendet werden, um nicht ganzzahlige Geschwindigkeiten zu erzielen. -r, --repeat wiederholt die Wiedergabeliste endlos. -z, --shuffle gibt Dateien in pseudozufalliger Reihenfolge wieder. -Z, --random gibt Dateien endlos in pseudozufalliger Reihenfolge wieder. GERATE ogg123 unterstutzt eine Reihe von Audio-Ausgabegeraten unter Nutzung von libao. Nur von der jeweiligen Zielplattform unterstutzte Gerate werden verfugbar sein. Die Option -f kann nur bei Geraten verwendet werden, die in eine Datei schreiben konnen. Von allen Geraten unterstutzte Optionen: debug Wenn moglich, die Fehlerdiagnose-Ausgabe fur den gewahlten Treiber aktivieren. matrix:Wert Eine spezifische Anordnung der Ausgabekanale fur ein angegebenes Gerat erzwingen. Wert ist eine durch Kommata getrennte Liste von Kanalnamen in AO-Schreibweise, beispielsweise L,R,C,LFE,BL,BR,SL,SR. verbose Die ausfuhrliche Ausgabe fur den gewahlten Treiber aktivieren. Die Option -v aktiviert diese Treiberoption ebenfalls. quiet Den gewahlten Treiber zwingen, sich vollkommen still zu verhalten. Selbst Fehlermeldungen werden in diesem Modus nicht ausgegeben. Die Option -q aktiviert diese Treiberoption ebenfalls. aixs AIX-Live-Ausgabetreiber. Optionen: dev:Wert setzt das AIX-Ausgabegerat auf Wert. alsa Advanced-Linux-Sound-Architecture-Live-Ausgabetreiber. Optionen: buffer_time:Wert Uberschreibt die vorgegebene Grosse des Hardwarepuffers (in Millisekunden). dev:Wert Die Bezeichnung des zu verwendenden ALSA-Gerats. Beispiele dafur sind >>hw:0<< fur die erste Soundkarte und >>hw:1<< fur die zweite. Der ALSA-Treiber wahlt normalerweise automatisch >>surround71<<, >>surround51<<, >>surround40<< oder >>default<<, in Abhangigkeit von der Anzahl der Ausgabekanale. Weitere Informationen finden Sie unter http://alsa.opensrc.org/ALSA+device+labels. period_time:Wert Uberschreibt die vorgegebene Periodengrosse der Hardware (in Mikrosekunden). period_time:Wert Uberschreibt die vorgegebene Periodengrosse der Hardware (in Mikrosekunden). use_mmap:Wert Wert wird auf >>yes<< oder >>no<< gesetzt, um das einkompilierte Vorgabeverhalten zur Nutzung von mmap-Geratezugriffen zu uberschreiben. In der Vergangenheit arbeiteten einige fehlerbehaftete ALSA-Treiber besser ohne mmap-Zugriff, mit dem Nachteil einer etwas hoheren Auslastung des Prozessors. arts aRts-Sound-Daemon-Live-Ausgabetreiber. Optionen: multi:Wert setzt Wert auf >>yes<< oder >>no<<, um das Offnen des aRts-Wiedergabegerates fur mehrere, voneinander unabhangige Wiedergabevorgange zu ermoglichen. Obwohl der Treiber in diesem Multi-Modus sauber arbeitet, kann es bekanntermassen zu gelegentlichen Absturzen des aRts-Servers selbst kommen. Die Vorgabe ist >>no<<. au Sun-Audioausgabe in eine Datei im AU-Format. Dieses Format unterstutzt das Schreiben in nicht durchsuchbare Dateien, wie die Standardausgabe. In diesen Fallen geben die AU-Headerinformationen nur das Samplingformat, aber nicht die Spieldauer der Aufnahme an. esd Enlightened-Sound-Daemon-Live-Ausgabe. Optionen: host:Wert Wert gibt den Namen des Rechners an, auf dem esd lauft. Das Anhangen einer Portnummer nach einem Doppelpunkt ist moglich, wie in >>whizbang.com:555<<. (Vorgabe = localhost) Client-Name:Wert gibt den Client-Namen fur den neuen Audio-Datenstrom an. Die Vorgabe ist >>libao client<<. irix IRIX-Live-Ausgabetreiber. macosx MacOS-X-AUHAL-Live-Ausgabetreiber. Dieser Treiber unterstutzt MacOS X 10.5 und neuer (10.4 und dessen Vorgangerversionen nutzen eine altere, inkompatible Schnittstelle). Optionen: buffer_time:Wert Setzt die hardwareseitige Puffergrosse auf den Gegenwert von Wert Millisekunden. nas Network-Audio-Server-Live-Ausgabetreiber. Optionen: buf_size:Wert legt die Grosse des Audiopuffers auf dem Server in Bytes fest. host:Wert gibt den Ort des NAS-Servers an. In nas(1) finden Sie Hinweise zur Formatierung. null Null-Treiber. Alle Audiodaten werden verworfen. (Achtung: Die Audiodaten werden nicht nach /dev/null geschrieben!) Sie konnen diesen Treiber verwenden, um die unverfalschte Dekodierungsgeschwindigkeit ohne die Belastung durch die Ausgabe zu testen. oss Open-Sound-System-Treiber fur Linux und FreeBSD in den Versionen 2, 3 und 4. Optionen: dsp:Wert DSP-Gerat fur die Soundkarte. Vorgabe ist /dev/dsp. pulse Pulseaudio-Live-Ausgabetreiber. Optionen: server:Wert gibt den Ort des entfernten oder alternativen Pulseaudio-Servers an. sink:Wert gibt ein nicht als Standard festgelegtes Pulseaudio-Ziel fur den Audio-Datenstrom an. raw Ausgabe der Rohdaten in eine Datei. Die Audiodaten werden in unbearbeiteter Form in eine Datei geschrieben. Optionen: byteorder:Wert wahlt Big Endian (>>big<<), Little Endian (>>little<<) oder die native (>>native<<) Byte-Reihenfolge. Vorgabe ist die native Reihenfolge. roar Roar-Audio-Daemon-Live-Ausgabetreiber. Optionen: server:Wert, host:Wert gibt den Ort des zu verwendenden entfernten RoarAudio-Servers an. id:Wert, dev:Wert gibt einen nicht als Standard festgelegten Mixer innerhalb eines RoarAudio-Servers fur den Audio-Datenstrom an. role:Wert gibt die Rollen-Einstellung fur den Audio-Datenstrom an. Client-Name:Wert gibt den Client-Namen fur den neuen Audio-Datenstrom an. Die Vorgabe ist >>libao client<<. sndio OpenBSD-SNDIO-Live-Ausgabetreiber. Optionen: dev:Wert gibt das Audiogerat fur die Wiedergabe an. sun Sun-Audio-Live-Ausgabetreiber fur NetBSD, OpenBSD und Solaris. Optionen: dev:Wert Audiogerat fur die Soundkarte. Vorgabe ist /dev/audio. wav Ausgabe in WAV-Datei. Schreibt die Audiodaten in nicht komprimierter Form auf das Speichergerat. Wenn mehrere Dateien wiedergegeben werden, so werden diese zu einer WAV-Datei zusammengefuhrt. Es ist nicht moglich, WAV-Daten in nicht durchsuchbare Dateien zu schreiben, wie beispielsweise die Standardausgabe. Verwenden Sie in diesem Fall das AU-Format. wmm Windows-MultiMedia-Live-Ausgabetreiber fur Win98 und neuer. Optionen: dev:Wert wahlt das fur die Wiedergabe zu verwendende Audiogerat nach dem Geratenamen aus. id:Wert wahlt das Audiogerat fur die Wiedergabe anhand der Geratekennung (Kartennummer) aus. BEISPIELE Die Befehlszeile von ogg123 ist recht flexibel, aber vielleicht etwas verwirrend. Nachfolgend finden Sie einige Beispiele mit Erklarungen, was diese bewirken. Uber die Standard-Soundkarte wiedergeben: ogg123 test.ogg spielt alle Dateien im Verzeichnis ~/Musik und dessen Unterverzeichnissen ab. ogg123 ~/Musik Eine Datei mit dem OSS-Treiber wiedergeben: ogg123 -d oss test.ogg Die >>dsp<<-Option an den OSS-Treiber ubergeben: ogg123 -d oss -o dsp:/dev/mydsp Den ESD-Treiber verwenden: ogg123 -d esd test.ogg Den WAV-Treiber fur >>test.wav<< als Ausgabedatei verwenden: ogg123 -d wav -f test.wav test.ogg Eine Datei wiedergeben, wahrend diese gleichzeitig in eine WAV-Datei geschrieben wird: ogg123 -d oss -d wav -f test.wav test.ogg Beachten Sie, dass die Optionen auf das links angegebene Gerat angewendet werden: ogg123 -d oss -o dsp:/dev/mydsp -d raw -f test2.raw -o byteorder:big test.ogg Belastungstest fur Ihre Festplatte: ogg123 -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 Einen Echoeffekt mit esd auf einem weniger leistungsstarken Rechner erzeugen: ogg123 -d esd -d esd test.ogg UNTERBRECHUNG Sie konnen ogg123 jederzeit durch Drucken von Strg-C abbrechen. Wenn mehrere Dateien wiedergegeben werden, dann wird die Wiedergabe der aktuellen Datei abgebrochen und mit der nachsten fortgesetzt. Wenn Sie die Wiedergabe vollstandig beenden wollen, statt nur zur nachsten Datei zu springen, dann drucken Sie Strg-C wahrend der ersten Sekunde der Wiedergabe der neuen Datei. Beachten Sie, dass die Reaktion auf das Drucken von Strg-C moglicherweise nicht sofort horbar ist, da die wiedergegebenen Daten im Audiogerat gepuffert werden. Die Verzogerung ist systemabhangig, betragt aber in der Regel nicht mehr als ein oder zwei Sekunden. DATEIEN /etc/libao.conf Kann dazu verwendet werden, das Standard-Ausgabegerat fur alle libao-Programme festzulegen. ~/.libao Benutzerdefinierte Konfigurationsdatei, welche die systemweiten Einstellungen fur das Ausgabegerat uberschreibt. FEHLER Uber eine Pipe weitergeleitete WAV-Dateien konnen seltsames Verhalten anderer Programme hervorrufen. Das ruhrt daher, dass WAV-Dateien die Datenlange (Spieldauer) in den Headerinformationen speichern. Allerdings weiss der Ausgabetreiber nichts uber die Lange, wenn die Header geschrieben werden, und es gibt keinen Wert, der auf >>Lange unbekannt<< verweisen konnte. Verwenden Sie deshalb den Raw- oder AU-Ausgabetreiber, wenn Sie ogg123 in einer Pipe nutzen wollen. AUTOREN Programmautoren: Kenneth Arnold Stan Seibert Autor der Handbuchseite: Stan Seibert SIEHE AUCH libao.conf(5), oggenc(1), vorbiscomment(1), ogginfo(1) UBERSETZUNG Die deutsche Ubersetzung dieser Handbuchseite wurde von Frank Stahr und Mario Blattermann erstellt. Diese Ubersetzung ist Freie Dokumentation; lesen Sie die GNU General Public License Version 3 oder neuer bezuglich der Copyright-Bedingungen. Es wird KEINE HAFTUNG ubernommen. Wenn Sie Fehler in der Ubersetzung dieser Handbuchseite finden, schicken Sie bitte eine E-Mail an die Mailingliste der Ubersetzer . Xiph.Org Foundation 24. Marz 2010 ogg123(1)