Provided by: manpages-ja_0.5.0.0.20221215+dfsg-1_all 
名前
mpg123 - MPEG 1.0/2.0 形式のオーディオファイルの演奏 (レイヤ 1, 2, 3 対応)
書式
mpg123 [ -tscvqy01m24 ] [ -b size ] [ -k num ] [ -n num ] [ -f factor ] [ -r rate ] [ -g gain ] [ -a dev
] [ -o s | -o h | -o l ] [ -d n ] [ -h n ] [ -p proxy ] [ -@ file ] file ... | URL ... | -
説明
mpg123 は file や URL を読み込み(いずれも複数指定可。また``-'' を指定すると標準入力から読 み込みます)、こ
れらをオーディオデバイスで演奏するか(デフォルトの動作)、 標準出力に出力します。 file/URL は MPEG-1/2 の
オーディオビットストリームであるものとします。
オプション
mpg123 のオプションは、伝統的な POSIX 形式でも GNU 形式の長いオプション名でも 指定できます。POSIX 形式の
オプションは ``-'' で始まり、GNU 形式の オプションは ``--'' で始まります。
-t, --test
テストモード。オーディオストリームをデコードしますが、出力は行いません。
-s, --stdout
デコードしたオーディオのサンプル音を標準出力に出力します。 オーディオデバイスを使った演奏は行いま
せん。 お使いのハードウェアが mpg123 でサポートされていなければ、このオプションを使わなければなり
ません。 出力フォーマットは raw (ヘッダ無し)形式、16 ビット、ステレオの PCM オー ディオデータであ
り、そのバイト順はホストに従います。
-c, --check
フィルタレンジの違反をチェックし、これが起こるとフレームごとに報告しま す。
-v, --verbose
詳しいメッセージを出力するようにします。例えば、デコード中に フレーム番号を表示します。
-q, --quiet
静かに動作するようにします。診断メッセージを表示しなくなります。
-y, --resync
入力ファイルでエラーが起きた場合に、再び同期を取ってデコートを継続しよ うと試みます。ヘッダが特定
の壊れ方をしている場合にも回復を試みます。 このオプションは、 mpg123 が通常 `Illegal header' と表
示して処理をあきらめる壊れた MPEG ファイル がある場合に役に立ちます。ただし、このオプションは慎重
に使ってください。 MPEG ファイルに壊れた位置情報があると鋭い音や激しい音が鳴ることがある ので、ボ
リュームが大きすぎるとスピーカーを傷めてしまうかもしれません。
-0, --single0; -1, --single1
チャンネル 0 (左)またはチャンネル 1 (右)だけをデコードします。 これらのオプションが使えるのは、ス
テレオの MPEG ストリームの場合だけで す。
-m, --singlemix
両方のチャンネルを合成します。このオプションが使えるのは、ステレオの MPEG レイヤ-3 ストリームの場
合だけです。CPU に負荷がかかる負荷は フルステレオでデコードするよりも小さくなります。
-2, --2to1; -4, --4to1
2:1 (22kHz) または 4:1 (11kHz) の割合で出力ストリームの ダウンサンプリングを行います。CPU の負担は
小さくなりますが、少なくとも 4:1 のダウンサンプリングを行うとまともに聞けない音になります。
-b size, --buffer size
オーディオの出力バッファを size K バイト使用します。これは一時的にシステム動作が重くなった時の影響
を回 避する際に便利です。というのも、このような状況ではオーディオ出力に割り 込みが入ることが通常だ
からです。 バッファのサイズには少なくとも 1024 (つまり 1MB。これは 6 秒分のオーディ オデータに相当
します)を指定すべきです。300 以下だとほとんど意味があり ません。 デフォルト値は 0 (バッファリング
が無効)です。
-k num, --skip num
最初の num フレームを飛ばします。デフォルトではデコードは最初のフレームから行われ ます。
-n num, --frames num
num フレームだけをデコードします。デフォルトでは、フレーム全てをデコードし ます。
-f factor, --scale factor
スケール係数を変更します(デフォルト値は 32768)。
-r rate, --rate rate
サンプリングレートを設定します(デフォルトでは自動設定)。MPEG の ストリームレートとは独立の固定の
ビットレートが必要ならば、この設定を変 更するとよいでしょう。mpg123 は自動的にレートを変換します。
このオプションは --stereo または --mono と組み合わせるべきでしょう。
-g gain, --gain gain
オーディオハードウェアの出力ゲインを設定します (デフォルトでは変更を行いません)。
-a dev, --audiodevice dev
使用するオーディオデバイスを指定します。デフォルト値はシステム依存です (普通は /dev/audio または
/dev/dsp)。複数のオーディオデバイスがあり、 デフォルトのデバイスを使いたくない場合にこのオプション
を使ってください。
-o s, --speaker
オーディオ出力をスピーカーに送ります。
-o h, --headphones
オーディオ出力をヘッドフォン端子に送ります。
-o l, --lineout
オーディオ出力をラインアウト端子に送ります。
-d n, --doublespeed n
n フレームおきにしか再生を行いません。これにより MPEG ストリームの再生は n 倍速になり、特殊な効果
を出すことができます。 --halfspeed オプションと組み合わせて 4 フレーム中の 3 フレームを演奏すると
いったこ ともできます。ただし、このオプションを使う時は音質には期待しないでくだ さい。
-h n, --halfspeed n
各フレームを n 回演奏します。これにより、MPEG ストリームの再生速度は 1/n になります(n 倍遅くなりま
す)。これを使って特殊な効果を出すことができま す。 --doublespeed オプションと組み合わせて 3 つごと
のフレームの長さを倍にするといったこ とが可能です。 ただし、このオプションを使う時は音質には期待し
ないでください。
-p URL | none, --proxy URL | none
HTTP のリクエストの際に、指定された proxy を用います。 これは完全な URL (``http://ホスト名.ドメイ
ン:ポート番号/'' の形式)で指 定しなければなりませんが、``http://'' プレフィックスとポート番号、最
後 のスラッシュは省略してもかまいません(ポート番号のデフォルト値は 80)。 none を指定すると、プロキ
シを使わずにそれぞれのサーバから直接ファイルを取得 します。``HTTP のサポート'' セクションも参照し
てください。
-u auth, --auth auth
HTTP 経由でファイルを取得する際に用いる HTTP 認証を指定します。 指定は「ユーザ名:パスワード」の形
式で行います。
-@ file, --list file
コマンドラインで指定したファイルまたは URL (もしあれば)に加え、 file に記述されているファイルや
URL のオーディオストリームを読み込みます。 file は通常ファイルでも適切なリストファイルを指す URL
でも構いませんし、 ファイル名や URL のリストを標準入力から読み込むことを示す ``-'' を指 定すること
もできます。 注意: -@ オプションは 1 回しか指定することができません(複数回指定すると、最後に 行っ
た指定だけが認識されます)。
-z, --shuffle
シャッフル演奏を行います。コマンドラインとリストファイルで指定された ファイルをランダムにシャッフ
ルします。
--stereo
強制的にステレオ出力にします。
--reopen
1 曲ごとにオーディオデバイスをオープンし直します。
--8bit 強制的に 8 ビット出力にします。
-Z, --random
完全にランダムな演奏を行います。
オペランド
mpg123 は以下のオペランドをサポートしています:
file(複数可)
入力ファイルのパス名(複数個指定することもできます)。これは MPEG-1/2 オーディオのレイヤ-1, 2, 3 の
正しいビットストリームでなければ なりません。 ``-'' を指定すると MPEG データは標準入力から読み込
まれます。また、 ``http://'' で始まる名前は全て URL として認識されます(次のセクションを参照してく
ださい)。
HTTP のサポート
mpg123 は通常ファイルや標準入力から MPEG オーディオストリームを読み込むだけで なく、HTTP プロトコル経由で
の MPEG オーディオファイルの取得もサポート しています。このプロトコルは World Wide Web (WWW)で使われてい
ます。こ のようなファイルはいわゆる URL (Universal Resource Locator) を用いて指 定します。URL は
``http://'' で始まります。このプレフィックスを持つ ファイルがあると、 mpg123 はこのファイルを取得してデ
コードおよび再生を行うために、サーバに対する HTTP 接続をオープンしようとします。
WWW のキャッシュ、つまりいわゆるプロキシを通してファイルを取得すると便 利なこともよくあります。これを行う
ために、 mpg123 は環境変数 MP3_HTTP_PROXY, http_proxy, HTTP_PROXY をここに挙げた順番で調べます。設定され
ている最初の変数の値がプロキシの 指定として使われます。これを上書きするには、コマンドラインオプションの
-p を用います(``オプション'' セクションを参照)。 -p none を指定すると、たとえ先に述べた環境変数が設定され
ていても、プロキシを全 く使わずに直接サーバと接続します。
WWW サーバから取り寄せた MPEG オーディオを再生するには、サーバとの接続 が十分高速でなければならない点に注
意してください。例えば 128k ビット/秒 の MPEG ファイルは、プロトコルのオーバーヘッドに加えて 少なくとも
128k ビット/秒(16k バイト/秒)のネットワーク接続を必要としま す。ネットワークが一時的に止まることが原因で
問題が起きる場合には、 -b オプション(バッファ容量設定)でネットワーク停止を避けてみましょう。 ネットワーク
接続の全体的な速度が MPEG オーディオファイルのリアルタイム 演奏に十分でなければ、最初に( lynx(1) 等を用い
て)ファイルをローカルのハードディスクにダウンロードしてからファ イルを再生してください。
-u user:pass. WWW サーバ上のファイルにアクセスするために認証が必要ならば、 -u ユーザ名:パスワード を使っ
て指定することができます。
割り込み
mpg123 は Ctrl-C を押すことにより、いつでも中断させることができます。複数のファ イルの再生中であれば、現
在のファイルの再生が止まり、次のファイルの再生 が始まります。次のファイルにスキップせずに即座に全ての再生
を終えるには、 Ctrl-C を (約 1 秒以内に)2 回連続で押します。
Ctrl-C を押しても聞こえる音がすぐ変わるわけではない点に注意してくださ い。これはオーディオデバイス内に
オーディオデータがバッファリングされて いるためです。この遅れはシステムによって違いますが、普通は 1, 2 秒
以内 です。
関連情報
lynx(1), sox(1), intro(1)
注意
MPEG オーディオ(特にレイヤ-3)のデコードにはかなりの CPU 性能が必要です。 これをリアルタイムでデコードする
には、少なくとも Pentium, Alpha, SuperSparc あるいはこれらと同等のプロセッサでなければなりません。 です
が、 -singlemix オプションを用いてモノラルのみの再生を行う方法もあります。このオプショ ンを使うとレイヤ-3
ストリームに対する CPU 負荷がある程度小さくなります。 -2 オプションと -4 オプションも参照してください。
これ以外の問題が起きた場合には、 -s オプションを使ってデコード結果を標準出力に出力し、これをファイルに リ
ダイレクトしてください。そしてこのファイルを適切なユーティリティを使っ て再生してください。 mpg123 の出力
をお使いのオーディオプレイヤーで再生できるように変換するには、 sox(1) 等のツールが必要となるかもしれませ
ん。
mpg123 は必ず 16 ビットステレオのデータを生成する点にも注意してください( -single* オプション群のいずれか
を使った場合でも、全く同じステレオチャンネルが 2 つ生成されます)。お使いのハードウェアがこれ以外のフォー
マット(例えば 8 ビットモノラル)を要求するのなら、やはり sox(1) 等のコンバータが必要となります。
お使いのシステムが普段は十分リアルタイム再生ができる速さでも、一時的に システム負荷が高くなり(cron のジョ
ブやユーザのリモートログイン、 「巨大な」プログラムの起動など)、オーディオ出力に割り込みがかかるよう な場
合には、 -b オプションを使って最低 1000K バイトのバッファを確保すべきです。
バグ
既知のバグと制限事項:
MPEG-2 のレイヤ 1, 2 のテストは行っていません。動作しないかもしれませ ん。(レイヤ 3 は動作するはず
です。)
フリーフォーマットのストリームには対応していません。
レイヤ 1 対応のテストは十分ではありません。
CRC エラーのチェックは行っていません。
現在は DEC Digital Unix, Ultrix, IBM AIX のオーディオハードウェアには 対応していません。したがっ
て、これらのプラットフォームでは -s オプションを使わなければなりません。
作者
リーダー:
Michael Hipp <hippm@informatik.uni-tuebingen.de>
以下のコード(または少なくともアイディア)を利用しています:
MPEG Software Simulation Group (基本パッケージ)
Philipp Knirsch <phil@mpik-tueb.mpg.de> (DCT36/manual の展開)
Tobias Bading <bading@cs.tu-berlin.de> (副バンドの合成)
Jeff Tsay <ctsay@pasteur.eecs.berkeley.edu> (DCT36)
Thomas Woerner (SGI のオーディオへの対応)
Damien Clermonte <clermond@esiee.fr> (HP-UX のオーディオ用の修正)
Oliver Fromme <oliver.fromme@heim3.tu-clausthal.de>
インターネット上での参照ページ:
http://www.sfs.nphil.uni-tuebingen.de/~hipp/mpg123.html
http://www.heim3.tu-clausthal.de/~olli/mpg123/
(mpg123 メーリングリストに関する情報があります)
最新版は以下の場所からも入手できます:
ftp.tu-clausthal.de:/pub/unix/audio/mpg123
http://ftp.tu-clausthal.de/pub/unix/audio/mpg123
21 Apr 1997 mpg123(1)