Quod Libetのソースを表示

[[Category:音楽]]
[[en:Quod Libet]]
[https://quodlibet.readthedocs.io/ Quod Libet] は、[[Python]] で書かれ、[[GTK]] に基づいた音楽プレーヤーで、ネイティブまたはユーザーのプラグインを使用して拡張可能で、[[GStreamer]] をバックエンドとして使用して、多くのオーディオ形式をサポートしています。[[Wikipedia:ReplayGain|ReplayGain]]、タグの読み取りと書き込み、アルバムアートと歌詞の表示、正規表現に基づくライブラリのフィルタリングなどをサポートします。

Quod Libet プロジェクトには 3 つのコマンドが用意されています。:
; {{man|1|quodlibet}}: CLI をサポートするプレーヤーおよびライブラリマネージャー。
; {{man|1|exfalso}}: グラフィカルなタグマネージャー。
; {{man|1|operon}}: コマンドラインタグマネージャー。

== インストール ==

{{Pkg|quodlibet}} パッケージを [[インストール]] して下さい。

=== デコード機能の拡張 ===

Quod Libet は、[[GStreamer]] を介して [[FFmpeg|Libav-based]] コーデックの恩恵を受けることができます ([[Wikipedia:Monkey's Audio|Monkey's Audio (APE)]] ファイルをデコードする場合など) これを有効にするには、{{Pkg|gst-libav}} パッケージをインストールし、オーディオプレーヤーを再起動します。

=== プラグインリストの拡張 ===

Quod Libet は、いくつかの [https://gstreamer.freedesktop.org/documentation/plugins_doc.html?gi-language=c GStreamer のプラグイン] ([[Wikipedia:ReplayGain|ReplayGain]] 情報の計算など) から恩恵を受けることができます。これらを Quod Libet のプラグインリストで利用できるようにするには、{{Pkg|gst-plugins-good}} パッケージをインストールし、オーディオプレーヤーを再起動します。

== Configuration ==

=== Configuring the player core ===

In the menu, go to ''File'' and then ''Preferences''. From here, you can configure the library path, enable ReplayGain, and configure the player layout.

=== Enabling plugins ===

The default preferences of the player are not exhaustive. A more advanced configuration is done via
plugins. To enable them, in the menu, go to ''File > Plugins'', and enable the desired plugins.

Here is a list of interesting plugins:

; Alternative progress bar: Display a progress bar at the top of the window.
; Waveform search bar: Display a waveform progress bar instead of a simple bar.
; Change theme: Configure the interface theme.
; ReplayGain: Add a button in contextual menu to compute ReplayGain information for selected files.
; Information overlay: Add an OSD during title change.
; D-BUS MPRIS support: Add MPRIS support through D-BUS allowing to control the media player using keyboard multimedia keys.
; Display lyrics: Add a panel at the right of the display to show embedded lyrics.

== Plugins ==

=== ReplayGain ===

[[Wikipedia:ReplayGain|ReplayGain]] is disabled by default on Quod Libet. You must enable it in the preferences so that the volume of tracks will be adjusted at runtime based on ReplayGain tags.

Quod Libet is able to compute ReplayGain information and store it in the tags of audio files. It relies on the [https://gstreamer.freedesktop.org/documentation/replaygain/rganalysis.html?gi-language=c GStreamer's rganalysis] plugin. To do so:
* Ensure GStreamer's plugins are installed through the {{Pkg|gst-plugins-good}} package.
* Enable the ReplayGain plugin, right click on a file, go to ''Plugins'' and click on ''ReplayGain''.

=== External control ===

Quod Libet can be controlled programmatically using [[MPRIS]] through [[D-Bus]]. To do so, enable the ''D-BUS MPRIS support'' plugin. It allows control using multimedia keys and terminal.

The following demonstrate some examples of player control using the terminal.

; Set the playback volume to 50%:

 $ dbus-send --dest=org.mpris.MediaPlayer2.quodlibet --print-reply /org/mpris/MediaPlayer2 org.freedesktop.DBus.Properties.Set string:org.mpris.MediaPlayer2.Player string:Volume variant:double:0.5

; Control playback action:
 $ dbus-send --dest=org.mpris.MediaPlayer2.quodlibet --print-reply /org/mpris/MediaPlayer2 org.mpris.MediaPlayer2.Player.Next

Instead of ''Next'', you can use one of the following actions: ''Pause'', ''Play'', ''Previous'', ''Stop''.

=== Media server ===

Quod Libet can act as a media server using [[Music Player Daemon]] or [[Rygel]] as backends. To select and use one of them, enable the correspond plugins in the preferences.

== Troubleshooting ==

=== Multimedia keys do not work ===

Multimedia keys work using the [[MPRIS]] interface. This interface has to be enabled in the plugins of Quod Libet to make them work.

=== Interface freeze when title changes ===

Enabling a buggy plugin or too many sane plugins can sometimes leads to poor performance. Disable plugins until the freeze disappear, such that you can identify the faulty plugin. For instance, the ''Waveform search bar'' is known to cause some lags for low-end systems.

== See also ==

* [[Wikipedia:Quod Libet (software)|Wikipedia page]]
* [https://github.com/quodlibet/quodlibet/ GitHub repository]
* [https://quodlibet.readthedocs.io/ Official website]