audtool - コマンドラインからAudaciousを制御するための小さなツール。
audtool [instance] command [parameter ...] ...
audtool は、実行中の Audacious インスタンスにコマンドを送信します。
プレイリスト内の次の曲にスキップするなど、多くの一般的なコマンドを送信したり、現在の曲のタイトルなどのステータス情報を出力したりすることもできます。
インスタンスは、-1、-2 など (最大 -9) として指定して、どのインスタンスを指定するかを指定できます。 Audacious のインスタンスを使用して、複数のインスタンスが開始されたときを制御します。
現在の曲のフォーマットされたタイトルを出力します。 Audacious の設定によっては、アーティストやアルバム名などの情報が含まれる場合があります。曲のタイトルのみを出力するには、代わりに --current-song-tuple-data title を使用します。
現在の曲のファイル名 (フルパスまたは URI) を出力します。
現在の曲の長さを M:SS 形式で出力します。
現在の曲の長さを秒単位で出力します。
現在の曲の長さをミリ秒単位で出力します。
再生時間カウンターを M:SS 形式で出力します。
再生時間カウンターを秒単位で出力します。
再生時間カウンターをミリ秒単位で出力します。
ストリーミング ビットレートをビット/秒で出力します。
ストリーミング ビットレートをキロビット/秒 (1 キロビット=1000 ビット) で出力します。
サンプリング レートをヘルツ単位で出力します。
サンプリング レートを kHz 単位で出力します。
オーディオチャンネルの数を出力します。
現在の曲の名前付きフィールド (アーティスト、年、ジャンルなど) の値を出力します。フィールド名を省略すると、許可されたフィールドのリストが出力されます。
ストリーミング ビットレート、サンプリング レート、およびオーディオ チャネルの数を出力します。
再生を開始します。一時停止した場合は、同じポイントから再生が再開されます。すでにアクティブで一時停止していない場合は、曲の最初から再開されます。
再生を一時停止するか、すでに一時停止している場合は再開します。
再生がアクティブな場合は --playback-pause 、それ以外の場合は --playback-play と同等です。
再生を停止します。
再生がアクティブな場合は、終了コード 0 (true) を返します。
再生が一時停止されている場合は、終了コード 0 (true) を返します。
再生がアクティブでない場合は、終了コード 0 (true) を返します。
再生ステータス (「再生中」、「一時停止」、または「停止」) を出力します。
曲の先頭からの相対的な秒単位で指定された時間をシークします。
現在の時間カウンターを基準にして、指定された時間 (秒単位) までシークします。
出力ストリームの記録を切り替えます (FileWriter を使用)。
ストリーム記録が有効な場合は、終了コード 0 (true) を返します。
どのプレイリストが再生されているかに関係なく、後続のプレイリスト コマンドが Audacious によって現在表示されているプレイリストに適用されるように指定します。この設定は、--select-playing によって上書きされるか、Audacious が再起動されるまで有効です。
次のコマンドも影響を受けます。
--current-song --current-song-filename --current-song-length[-seconds,-frames] --current-song-tuple-data
再生がアクティブなときに、後続のプレイリスト コマンドが現在再生中のプレイリストに適用されるように指定します。再生が停止すると、動作は --select-displayed と同じになります。この設定がデフォルトです。
プレイリスト内の次の曲にスキップします。
プレイリスト内の前の曲にスキップします。
プレイリストの最後に曲を追加します。 URI またはローカル ファイル パス (絶対または相対) を指定できます。
プレイリスト内の指定された位置 (1 から始まる) に曲を挿入します。
「再生中」プレイリストに曲を追加し、必要に応じてプレイリストを作成し、曲の再生を開始します。 Audacious の設定によっては、プレイリストが最初にクリアされる場合があります。
指定された位置にある曲をプレイリストから削除します。
プレイリスト内の曲の数を出力します。
プレイリスト内の曲のフォーマットされたタイトルを印刷します。
プレイリスト内の曲のファイル名 (フルパスまたは URI) を出力します。
プレイリスト内の曲の長さを M:SS 形式で出力します。
プレイリスト内の曲の長さを秒単位で出力します。
プレイリスト内の曲の長さをミリ秒単位で出力します。
プレイリスト内の曲の名前付きフィールドの値を出力します。
プレイリスト内のすべての曲のタイトルを出力します。
プレイリスト内の現在の曲の位置を出力します。
プレイリスト内の指定された位置にある曲にスキップします。
プレイリストをクリアします。
プレイリストの自動進行のステータス (「オン」または「オフ」) を出力します。
プレイリストの自動進行を切り替えます。
プレイリストのリピートのステータス (「オン」または「オフ」) を出力します。
プレイリストのリピートを切り替えます。
プレイリストのシャッフルのステータス (「オン」または「オフ」) を出力します。
プレイリストのシャッフルを切り替えます。
「現在の曲の後に停止」オプション (「オン」または「オフ」) を出力します。
「現在の曲の後で停止」オプションを切り替えます。
開いているプレイリストの数を出力します。
現在のプレイリストの番号を出力します。ここで、「current」は--select-displayed または --select-playing に従って解釈されます。
現在のプレイリストで再生を開始し、可能であれば最後に再生したポイントから再開します。 --select-displayed が有効な場合、このコマンドを使用して、表示されているプレイリストに再生を切り替えることができます。
指定されたプレイリストを表示します。 --select-playing が有効で、別のプレイリストが再生中の場合、このコマンドは指定されたプレイリストに再生を切り替えます。 --select-displayed オプションは、この動作を無効にします。
現在のプレイリストのタイトルを出力します。
現在のプレイリストのタイトルを設定します。
現在のプレイリストの後に新しいプレイリストを挿入し、--set-current-playlist が使用されたかのようにそれに切り替えます。
現在のプレイリストを削除します。
指定されたプレイリストの位置にある曲をキューに追加します。
指定されたプレイリストの位置にある曲をキューから削除します。
指定されたプレイリスト位置の曲がキューにある場合は、終了コード 0 (true) を返します。
指定されたプレイリストの位置にある曲のキューの位置を出力します。
指定されたキュー位置にある曲のプレイリストの位置を出力します。
キュー内の曲の数を出力します。
キュー内のすべての曲のタイトルを出力します。
キューをクリアします。
現在の音量レベルをパーセントで出力します。
現在の音量レベルをパーセントで設定します。
イコライザーを有効または無効にします。
イコライザー設定 (すべてのバンドのプリアンプとゲイン) をデシベル単位で出力します。
イコライザー設定 (すべてのバンドのプリアンプとゲイン) をデシベル単位で設定します。
イコライザーのプリアンプをデシベル単位で出力します。
イコライザーのプリアンプをデシベル単位で設定します。
指定されたイコライザー バンド (0 ～ 9) のゲインをデシベル単位で出力します。
指定されたイコライザー バンド (0 ～ 9) のゲインをデシベル単位で設定します。
Audacious ウィンドウを表示または非表示にします。
「ファイルの追加」ウィンドウを表示または非表示にします。
「ソングにジャンプ」ウィンドウを表示または非表示にします。
設定ウィンドウを表示または非表示にします。
「バージョン情報」ウィンドウを表示または非表示にします。
バージョン情報を出力します。
指定されたプラグインが有効な場合は、終了コード 0 (true) を返します。プラグインは、インストールされているファイル名からフォルダー パスとサフィックスを除いたものを使用して指定します。たとえば、lib/audacious/Effect/crossfade.so の場合は crossfade となります。
指定されたプラグインを有効または無効にします。インターフェイスおよび出力プラグインは、それぞれの 1 つが常にアクティブである必要があるため、直接無効にすることはできないことに注意してください。インターフェイスまたは出力プラグインを有効にすると、以前のプラグインは自動的に無効になります。
構成設定の値を出力します。このコマンドの使用は完全にサポートされていません。特定の設定のセクションと名前を見つける方法は、読者の演習として残されています。
構成設定の値を変更します。このコマンドはサポートされておらず、危険です。予期しない副作用 (Audacious のクラッシュなど) が発生する場合もあれば、まったく効果がない場合もあります。ご自身の責任でご使用ください。
Audacious をシャットダウンします。
audtool コマンドの簡単な概要を出力します。
コマンドにはプレフィックス「--」(GNU スタイルの長いオプション) を付けるか付けないかは任意です。
現時点では、audtool に既知のバグはありません。見つけた場合は、https://redmine.audacious-media-player.org/projects/audacious で報告してください。
audtool は、George Averill nhjm@nhjm.net と Ariadne Conill ariadne@dereferenced.org によって作成されました。
このマニュアル ページは、Adam Cecile gandalf@le-vert.net と Kiyo Aman kiyoshi@atheme.org によって作成されました。いくつかの追加の調整は、Ariadne Conill ariadne@dereferenced.org と Tony Vroon chainsaw@gentoo.org によって行われました。マニュアル ページは、John Lindgren john@jlindgren.net によって Audacious 3.7 以降用に更新されました。
この作品は、クリエイティブ コモンズ表示 3.0 非移植ライセンス https://creativecommons.org/licenses/by/3.0/ に基づいてライセンスされています。
audacious(1)
https://audacious-media-player.org