Man page - mpg123(1)

Manual

mpg123

名 前
書 式
説 明
オ プ シ ョ ン
オ ペ ラ ン ド
HTTP の サ ポ ー ト
割 り 込 み
関 連 情 報
注 意
バ グ
作 者

---

名 前

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

---