Provided by: manpages-ja_0.5.0.0.20221215+dfsg-1_all bug

名前

       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 ... | -

説明

       mpg123fileURL を読み込み(いずれも複数指定可。また``-'' を指定すると標準入力から読
       み込みます)、これらをオーディオデバイスで演奏するか(デフォルトの動作)、 標準出力に出力しま
       す。 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)