「Cmus」の版間の差分

2023年10月31日 (火) 00:27時点における最新版

cmus (C* MUsic Player) は主要な音声フォーマットをサポートする、小さくて高速でパワフルなコンソール音楽プレイヤーです。ギャップレス再生や ReplayGain のサポート、MP3 や Ogg のストリーミング、ライブフィルタリング、インスタント起動、キーバインドのカスタマイズなど様々な機能が揃っており、デフォルトキーバインドは vi スタイルになっています。

インストール

cmus パッケージをインストールしてください。あるいは開発版は cmus-git^AUR でインストールできます。

利用可能なコーデックおよび出力プラグインのオプションの依存関係を参照してください (インストールされているプラグインは、cmus --plugins で一覧表示できます。)

cmus で alsa を使う

Advanced Linux Sound Architecture で cmus を使用する場合、デフォルト設定では音楽が再生できません。cmus を起動してもおそらく何も表示されません。alsa を使うには、新しい設定ファイルを作成して以下の変数を設定してください:

~/.config/cmus/rc

set output_plugin=alsa
set dsp.alsa.device=default
set mixer.alsa.device=default
set mixer.alsa.channel=Master

使用方法

こちらを参照 cmus(1)、 cmus-tutorial(7)、cmus-remote(1)

設定

cmus を設定するには、cmus(1) を参照してください。

リモートコントロール

Cmus は cmus-remote で unix ソケットを使うことで外部から操作することができます。これのおかげで外部アプリケーションやキーバインドで再生を制御するのが簡単になっています。

例としては XF86 のキーボードイベントで Cmus の再生を制御するという使い方があります。以下のスクリプトは Cmus が起動していない場合 xterm ターミナルで Cmus を起動して、既に起動している場合は再生/停止を切り替えます:

#!/bin/sh
# This command will break if you rename it to
# something containing "cmus".

if ! pgrep cmus ; then
  xterm -e cmus
else
  cmus-remote -u
fi

上記のコードをファイル ~/bin/cplay にコピーし、実行可能属性を付与します。

Openbox で cmus-remote を使用するには、Openbox#rc.xml を参照してください。

JACK

cmus を JACK サーバーと連携させるには、cmus で上記のコマンドを実行します。

:set output_plugin=jack

オーディオ scrobbling

Cmus はオーディオ scrobbling 自体をサポートしていませんが、サードパーティソリューションがあります。Last.fm または Libre.fm の scrobbling 用に cmusfm^AUR をインストールします。初期設定では、cmusfm init を実行し、リンクに従って認証を実行します。

デフォルトでは、cmusfm は Last.fm サービスに scrobbling します。ただし、設定ファイル (~/.config/cmus/cmusfm.conf の service-api-url および service-auth-url) オプションを変更することで、この動作を変更することができます。その後、新しい scrobbling サービスで認証するために、cmusfm cmusfm init を再初期化する必要があります。Libre.fm を scrobbling サービスとして使用するには、次のような設定を使用します。

~/.config/cmus/cmusfm.conf

service-api-url = "https://libre.fm/2.0/"
service-auth-url = "https://libre.fm/api/auth"

次のステップは、cmusfm を cmus の status program として設定することです。メイン cmus ウィンドウでコマンドを実行します :set status_display_program=cmusfm

トラブルシューティング

追加後にトラックが表示されない

追加したばかりのトラックが表示されない場合は、ffmpeg パッケージをインストールしていないことが原因である可能性があります。利用可能なファイル拡張子は次のようにして確認できます。

$ cmus --plugins

参照

@@ 1行目: / 1行目: @@
+{{Lowercase title}}
-[[Category:プレイヤー]]
+[[Category:音楽]]
+[[Category:コンソールアプリケーション]]
 [[en:Cmus]]
-[[sr:Cmus]]
+[[pt:Cmus]]
-[http://cmus.sourceforge.net/ cmus] ''(C* MUsic Player)'' は主要な音声フォーマットをサポートする、小さくて高速でパワフルなコンソール音楽プレイヤーです。ギャップレス再生や ReplayGain のサポート、MP3 や Ogg のストリーミング、ライブフィルタリング、インスタント起動、キーバインドのカスタマイズなど様々な機能が揃っており、デフォルトキーバインドに vi スタイルになっています。
+[http://cmus.sourceforge.net/ cmus] ''(C* MUsic Player)'' は主要な音声フォーマットをサポートする、小さくて高速でパワフルなコンソール音楽プレイヤーです。ギャップレス再生や ReplayGain のサポート、MP3 や Ogg のストリーミング、ライブフィルタリング、インスタント起動、キーバインドのカスタマイズなど様々な機能が揃っており、デフォルトキーバインドは vi スタイルになっています。
 == インストール ==
 {{Pkg|cmus}} パッケージを[[インストール]]してください。あるいは開発版は {{AUR|cmus-git}} でインストールできます。
+利用可能な [[コーデック]] および出力プラグインのオプションの依存関係を参照してください (インストールされているプラグインは、{{ic|cmus --plugins}} で一覧表示できます。)
 === cmus で alsa を使う ===
 [[Advanced Linux Sound Architecture]] で cmus を使用する場合、デフォルト設定では音楽が再生できません。cmus を起動してもおそらく何も表示されません。alsa を使うには、新しい設定ファイルを作成して以下の変数を設定してください:
 {{hc|~/.config/cmus/rc|2=
@@ 17行目: / 22行目: @@
 }}
-==使用方法==
+== 使用方法 ==
-Cmus には素晴らしいリファレンスマニュアルが付いています。
- $ man cmus
- $ man cmus-tutorial
- $ man cmus-remote
+こちらを参照 {{man|1|cmus}}、 {{man|7|cmus-tutorial}}、{{man|1|cmus-remote}}
-=== Cmus の起動 ===
-cmus を起動するには、次を入力:
- $ cmus
-cmus を初めて起動したときはアルバム/アーティストタブが開かれます。
-=== 音楽の追加 ===
-{{ic|5}} を押してファイルブラウザタブに切り替えることで音楽を追加できます。タブを切り替えたら方向キー ({{ic|up}}, {{ic|down}}), {{ic|Enter}}, {{ic|Backspace}} を使って音声ファイルを保存しているディレクトリまで移動してください。また、vim のキーバインド ({{ic|k}}, {{ic|j}}) を使って保存している音楽を探すこともできます。
-cmus ライブラリに音楽を追加するには、方向キーでファイルやフォルダをハイライトしてから、{{ic|a}} を押します。{{ic|a}} を押すと cmus は次の行に移動して (行を移動してくれるおかげでファイルやフォルダを一斉に追加するのが楽になっています) ライブラリに {{ic|a}} を押したファイル/フォルダを追加します。大量の音楽が入っているフォルダを追加した場合、しばらく時間がかかることがあります。ファイルが追加されると、秒数が右下に表示されます。それが cmus ライブラリに含まれた全ての音楽の合計時間になります。
-{{Note|cmus がファイルを移動・複製したり、変更を加えることはありません。ファイルの場所を覚えてメタデータ (再生時間やアーティスト名など) をキャッシュするだけです。}}
-{{Note|終了時に Cmus は設定やライブラリなどを自動的に保存します。}}
-=== トラックの再生 ===
-{{ic|1}} を押してシンプルなライブラリビューを表示してください。方向キーの {{ic|up}} と {{ic|down}} (あるいは {{ic|k}}, {{ic|j}}) を使って再生したいアーティスト名やアルバムを選択します。アーティスト名で {{ic|space}} を押すと、そのアーティストのアルバムが開いたり閉じたりします。{{ic|Tab}} を押してトラックのリストとアーティスト/アルバムビューを切り替えて {{ic|Enter}} を押せば選択されたトラックが再生されます。以下のキーで再生を制御できます:
-:一時停止・再生するには {{ic|c}}。
-:10秒ずつシークするには方向キーの {{ic|right}}/{{ic|left}} (あるいは {{ic|h}}, {{ic|l}})。
-:1分ずつシークするには {{ic|<}}/{{ic|>}}。
-=== キーバインド ===
-キーバインドを変更する方法は設定セクションを見てください。
-==タブ==
-cmus にはタブが7つあります。{{ic|1}}-{{ic|7}} キーを押せばアクティブなタブが切り替わります。
-=== ライブラリタブ (1) ===
-いわゆる'''ライブラリ'''に含まれている全てのトラックが表示されます。トラックはアーティスト名でソートされアルバムツリーが作られます。アーティストの順番はアルファベット順です。アルバムは年代順です。
-=== ソートされたライブラリタブ (2) ===
-同じ中身を表示しますが、リストはユーザーの抽出条件によって自動的にソートされます。
-=== プレイリストタブ (3) ===
-編集できるプレイリストを表示。ソートもできます。
-=== プレイキュータブ (4) ===
-次に再生されるトラックのキューを表示します。キューに入っているトラックは他の曲 (プレイリストやライブラリ) よりも先に再生されます。
-=== ブラウザ (5) ===
-ディレクトリブラウザ。このタブで、ファイルシステムからライブラリやプレイリスト、あるいはキューに音楽を追加できます。
-=== フィルタータブ (6) ===
-ユーザーが定義したフィルターを表示。
-=== 設定タブ (7) ===
-設定を変更します。詳しくは下のセクションを参照。
 == 設定 ==
-cmus を設定するには、起動してから {{ic|7}} を押して設定タブに切り替えてください。デフォルトのキーバインドのリストが表示されます。方向キーでリストのフィールドを選択して {{ic|Enter}} を押すことで値を編集します。また、{{ic|D}} や {{ic|del}} でバインドを削除することもできます。バインドを解除したコマンドやオプションの変数を編集するには、リストを下にスクロールしてください。変数は {{ic|space}} で切り替えることができます。Cmus ではインターフェイスのあらゆるエレメントの色を変更することが可能です。色の前に "light" を付けることで明るく設定したりテキストエレメントの属性を設定できます。
+cmus を設定するには、{{man|1|cmus}} を参照してください。
 === リモートコントロール ===
 Cmus は {{ic|cmus-remote}} で unix ソケットを使うことで外部から操作することができます。これのおかげで外部アプリケーションやキーバインドで再生を制御するのが簡単になっています。
@@ 90行目: / 48行目: @@
 }}
-前記のスクリプトを [[Openbox]] で使うには、上のコードを {{ic|~/bin/cplay}} ファイルにコピーしてください。そして {{ic|chmod +x ~/bin/cplay}} でファイルに実行可能権限を付与して、{{ic|~/.config/openbox/rc.xml}} を編集してキーバインドを以下のように変更します:
+上記のコードをファイル {{ic|~/bin/cplay}} にコピーし、[[ヘルプ:読み方#実行可能属性の付与|実行可能属性を付与]] します。
-{{note|Make sure there are no conflicting keybindings in rc.xml}}
+[[Openbox]] で cmus-remote を使用するには、[[Openbox#rc.xml]] を参照してください。
-{{hc|~/.config/openbox/rc.xml|<nowiki>
-  <keyboard>
+=== JACK ===
-    <keybind key="XF86AudioPlay">
-      <action name="Execute">
+cmus を JACK サーバーと連携させるには、cmus で上記のコマンドを実行します。
-        <command>cmus-remote -u</command>
+{{bc|1=
-      </action>
+:set output_plugin=jack
-    </keybind>
+}}
-    <keybind key="XF86AudioNext">
-      <action name="Execute">
+== オーディオ scrobbling ==
-        <command>cmus-remote -n</command>
-      </action>
+Cmus はオーディオ scrobbling 自体をサポートしていませんが、[https://github.com/cmus/cmus/wiki/status-display-programs#audio-scrobbling-to-eg-lastfm-or-librefm サードパーティソリューション] があります。Last.fm または Libre.fm の scrobbling 用に {{AUR|cmusfm}} をインストールします。初期設定では、{{ic|cmusfm init}} を実行し、リンクに従って認証を実行します。
-    </keybind>
-    <keybind key="XF86AudioPrev">
+デフォルトでは、cmusfm は Last.fm サービスに scrobbling します。ただし、設定ファイル ({{ic|~/.config/cmus/cmusfm.conf}} の ''service-api-url'' および ''service-auth-url'') オプションを変更することで、この動作を変更することができます。その後、新しい scrobbling サービスで認証するために、cmusfm {{ic|cmusfm init}} を再初期化する必要があります。Libre.fm を scrobbling サービスとして使用するには、次のような設定を使用します。
-      <action name="Execute">
-        <command>cmus-remote -r</command>
+{{hc|~/.config/cmus/cmusfm.conf|<nowiki>
-      </action>
+service-api-url = "https://libre.fm/2.0/"
-    </keybind>
+service-auth-url = "https://libre.fm/api/auth"
-  </keyboard>
 </nowiki>}}
+次のステップは、cmusfm を cmus の ''status program'' として設定することです。メイン cmus ウィンドウでコマンドを実行します {{ic|<nowiki>:set status_display_program=cmusfm</nowiki>}}
-これでキーボードの {{ic|XF86AudioPlay}} キーを使用すると、cmus が起動します。cmus が既に起動している場合、再生が開始されます。XF86AudioNext と XF86AudioPrev キーでトラックが変わります。
+== トラブルシューティング ==
+=== 追加後にトラックが表示されない ===
+追加したばかりのトラックが表示されない場合は、{{Pkg|ffmpeg}} パッケージをインストールしていないことが原因である可能性があります。利用可能なファイル拡張子は次のようにして確認できます。
+ $ cmus --plugins
 == 参照 ==
@@ 119行目: / 84行目: @@
 * [https://github.com/cmus/cmus Git リポジトリ]
 * [https://cmus.github.io/ ウェブサイト]
+* [https://github.com/cmus/cmus/wiki ユーザーが投稿したスクリプト]