XMMS2

1. 啟動 XMMS2

xmms2d (xmms2 daemon) 是 XMMS2 的核心，它的任務是接受來自各種 XMMS2 clients 的指令，負責處理音樂的播放與樂庫資料的儲存。當 client 告訴它要放音樂，它就會放音樂，當你離開 client 時，如果沒有告訴 xmms2d 要停止播放，它就會一直播音樂，直到你再由 client 傳命令給 xmms2d，要求它停止播放為止。所以說，播放音樂時，只有 xmms2d 在消耗資源，clients 可以關掉沒關係。

xmms2d 可分成三個部分：

transport plugin: 處理來自檔案系統或網路的音樂檔案資料
decoder plugin: 音樂檔案資料會被傳給 decoder 來解碼
output plugin: 解碼後的音樂資料傳送給 output plugin 來播放

可用 xmms2d 或 xmms2-launcher 來啟動 xmms2 daemon。

使用 xmms2-launcher 與直接執行 xmms2d 的差別在於：xmms2-launcher 會在背景啟動 xmms2d。xmms2-launcher 在 xmms2d 所需的 IPC 是 unavailable 時，不會馬上離開，會撐到指定的 IPC 可用時才會離開，離開後，xmms2d 就準備好可以接受命令了。

一般執行時，直接執行 xmms2-launcher 比較方便；若需要 debug，可用 xmms2d -v 。

2. XMMS2 的重要檔案與設定

XMMS2 的 clients 使用 IPC sockets 來與 xmms2d 溝通，指定的格式類似 url，有三種傳輸方式 (transport method) 可指定：tcp、tcp6 與 unix 。

一般如只想在本機控制音樂的播放，只要指定 unix socket 即可：

$ xmms2 config core.ipcsocket = unix:///tmp/xmms-ipc-USERNAME

上面的 USERNAME 要改成你的帳號。

除了以命令指定 ipc，也可以直接編設定檔，xmms2d 的個人設定檔位於 $HOME/.config/xmms2/xmms2.conf 。

如果有遠端控制的需求，才需要設定 tcp://ip:port。也可指定多個 IPC，以分號 ; 隔開，例如：

$ xmms2 config core.ipcsocket = unix://tmp/xmms-ipc-USERNAME;tcp://192.168.0.101:9667

如此，xmms2d 會監聽本機在 LAN 上的 IP 192.168.0.101 之 Port 9667，可由遠端連到本機來控制本機 xmms2 的播放。

遠端使用 client 時，要設定好 XMMS_PATH 才能控制 server，例如：

$ export XMMS_PATH=tcp://192.168.0.101
$ ./xmms2 list

4. xmms2 音樂資料庫

xmms2 可將使用者指定位置內所有的音樂檔案整理成一個 sqlite3 的資料庫，內含音樂檔案的 metadata 資訊、播放清單、與播放統計資訊 (如專輯名稱、樂手、音軌、播放次數……等等)，通常儲存在 $HOME/.config/xmms2/medialib.db ，以下簡單介紹如何管理與使用自己的音樂資料庫：

把音樂資料夾的路徑加入 media library
```
$ xmms2 mlib addpath 'PATH'
```
強制更新 media library 內的資料
```
$ xmms2 mlib rehash
```

搜尋 media library 中的資料

xmms2 mlib search [field1:val1 [field2:val2 ...]]

$ xmms2 mlib search artist:"Nina Simone" (大小寫沒關係)
$ xmms2 mlib search artist:"To?" (問號代表一個任意字元)
$ xmms2 mlib search artist:* (星號代表零或多個任意字元)
$ xmms2 mlib search album:*by* (搜尋 album 名稱中包含 'by' 的樂曲)
$ xmms2 mlib search title:*love* (歌名包含 'love' 的樂曲)
$ xmms2 mlib search genre:electronic artist:a*
$ xmms2 mlib search tracknr:*22 (搜尋 tracknumber 比較怪，前面要加星號)
$ xmms2 mlib search tracknr \<= 3 (使用 > 或 < 要先用 \ 跳脫)
$ xmms2 mlib search 'tracknr<=3' (tracknr 與 <、= 與 3 之間不可有空白)
$ xmms2 mlib search bitrate:*64000 (單位是 bit/s，即 bps)
$ xmms2 mlib search bitrate \> 320000
$ xmms2 mlib search bitrate \<= 64000
$ xmms2 mlib search size \>= 50000000 (單位是 bytes)
$ xmms2 mlib search size \<= 5000000 (單位是 bytes)
$ xmms2 mlib search artist:"ennio*" date:2001 (用 > < >= <= 無效)
$ xmms2 mlib search samplerate:*22050
$ xmms2 mlib search samplerate \>= 48000
$ xmms2 mlib search timesplayed:*5 (被播過 5 次)
$ xmms2 mlib search timesplayed \>=5
$ xmms2 mlib search timesplayed \<2
$ xmms2 mlib search artist:"Nina Simone" OR artist:"Bj?rk" (可使用 "OR" 操作子，一定要用大寫)
$ xmms2 mlib search genre:jazz AND 'bitrate>=192000' (可使用 "AND" 操作子，一定要用大寫)
$ xmms2 mlib search artist~no (artist 含有 no 的曲目，~ 代表部分符合)
$ xmms2 mlib search artist:"bjork" +date (搜尋 date 這個 field 有任何字元的歌曲)
$ xmms2 mlib search '#18' (找 id 為 18 的曲子，不能用 ?*)
$ xmms2 mlib search in:bjork (在名稱為 bjork 的 collection 中搜尋)
$ xmms2 mlib search in:NinaSimone album:"a single woman" NOT title:"a single woman"
(在名稱為 NinaSimone 的 collection 中搜尋 a single woman 這張專輯中
除了 a single woman 這首歌外，還有那些歌。NOT 操作子要大寫。)
$ xmms2 mlib search '(' artist:Bjork AND title~o ')' OR '(' artist:"nina simone" AND title:o* ')'
(找 artist 為 Bjork 且 title 包含字母 o 的曲目，
或者 artist 為 Nina Simone 且 title 是以字母 o 開頭的曲目)

其他可用的 field 包含 id (id 指的是音樂檔案在資料庫中的 id 數字)、url (歌曲的路徑)、added (加入 media library 的時間，自 1970 年 1 月 1 日起算的秒數)、mime、lmod (上次修改時間，同樣是從 1970-01-01 起算的秒數)、laststarted(上次播放時間)、duration (歌曲長度，以 miniseconds 計算)、{album, artist, track}_id (歌曲的 MusicBrainz 的 ID number)。

其實 media library 允許任何 field (有時稱 key 或 properties) 儲存在內，所以要提供完整的 field 清單是蠻困難的，以上所提到的，只是一些比較常見的 field，並不完整。

url 的格式，在本機是 file:///media/e/Bjork/flac/audio_04.flac ，若用 daap，則為 daap://192.168.0.101:9999/2818.mp3 ，daap 的樂曲都被編號並放到虛擬的目錄了，所以遠端音樂檔案實際的路徑無法用於搜尋。

將搜尋結果加入播放清單

搜尋到想要加入播放清單的歌曲後，將 search 改成 searchadd，即可將搜尋結果加入播放清單。
```
$ xmms2 mlib searchadd artist:"keith*"
```

5. xmms2 播放清單

5.1. 管理播放清單內容

列出目前使用中的播放清單:
```
xmms2 list
```
列出某份播放清單的內容:
```
xmms2 list playlist_name
```

瀏覽某個網址的內容 (以編碼過的型式顯示):

$ xmms2 browse URL
$ xmms2 browse file:///media/d/music
$ xmms2 browse daap:///192.168.0.101:9999/

將 URL 加到指定或使用中的播放清單:
```
xmms2 add [PLAYLIST] URL...
```
將 URL 加到指定或使用中的播放清單，並由清單中 POS 這個位置加入:
```
xmms2 insert [PLAYLST] POS URL
```
將有 arguments 的 URL 加到指定或使用中的播放清單:
```
$ xmms2 addarg [PLAYLIST] URL arguments
```
將樂曲的 id 加到指定或使用中的播放清單:
```
$ xmms2 addid [PLAYLIST] medialib_id...
```
將樂曲的 id 加到指定或使用中的播放清單，並由清單中 POS 這個位置加入:
```
$ xmms2 insertid [PLAYLIST] POS medialib_id...
```
將 playlist 檔加到指定或使用中的播放清單:
```
$ xmms2 addpls [PLAYLIST] URL
```
將目錄內所有樂曲都加入播放清單:
```
$ xmms2 radd [PLAYLIST] directory
```
將音樂資料庫內所有樂曲都加入播放清單:
```
$ xmms2 loadall
```
從目前 active 的播放清單切換到另一份清單 PLAYLISTNAME :
```
$ xmms2 playlist load 'PLAYLISTNAME'
```
清除目前使用中的播放清單的內容:
```
$ xmms2 clear
```
清除目前使用中的播放清單內的某些項目:
```
$ xmms2 remove [PLAYLIST] PLAYLIST_POSITION
```

5.2. 排序播放清單中的內容

打亂播放清單順序: xmms2 shuffle [PLAYLIST]
依各種 PROPERTIES 來排序: xmms2 sort PROPERTIES
1. xmms2 sort id
2. xmms2 sort title
3. xmms2 sort artist
4. xmms2 sort tracknr
5. xmms2 sort album
6. xmms2 sort date
依各種 PROPERTIES 來排序指定的清單 PLAYLIST: xmms2 sort PLAYLIST PROPERTIES
*調整播放清單中樂曲的順序*： xmms2 move [PLAYLIST] POS_ORIGINAL POS_NEW

5.3. 管理播放清單

列出目前使用中播放清單的內容: xmms2 list
顯示目前使用中播放清單的名稱: xmms2 playlist active
列出所有可用的播放清單: xmms2 playlist list
建立一份播放清單: xmms2 playlist create PLAYLSTNAME
移除某份播放清單: xmms2 playlist remove PLAYLSTNAME
更改播放清單的名稱: xmms2 coll rename Playlists/test Playlists/hello

5.4. 播放方式

$ xmms2 play (播放)
$ xmms2 stop (停止)
$ xmms2 seek +120 (前進 120 秒) (使用 daap 或 http streaming 時無效)
$ xmms2 seek -31 (倒帶 31 秒)
$ xmms2 seek 100 (跳到 100 秒處)
$ xmms2 next (下一首)
$ xmms2 prev (前一首)
$ xmms2 toggleplay (切換播放/停止)
$ xmms2 jump PLAYLIST_POSITION (跳到清單中的某個編號)
$ xmms2 volume_list (列出所有 channel 的音量)
$ xmms2 volume [CHANNEL] VOLUME
 (設定 CHANNEL 的音量為 VOLUME，值可為 0-100，若無指定 CHANNEL，就全部一起改)

5.5. 顯示 Server 或曲目資訊

$ xmms2 stats (列出 uptime 與 version)
$ xmms2 info [id] (列出指定 id、或目前播放樂曲在 mlib 中的相關資訊)
$ xmms2 status (進入顯示樂曲播放狀態的模式)
$ xmms2 current PATTERN (以自訂的格式來顯示目前播放曲目的資訊)
(PATTERN 可用 "${album} - ${tracknr}" 的型式指定，請注意 shell 的 substitution 功能)
(實測發現，需將 $ 跳脫，才能正常顯示曲目資訊)
$ xmms2 current "\${artist} > \${album}: \${tracknr} - \${title}"
$ xmms2 current "【\${artist}: \${album}】 \${tracknr} - \${title}"

5.6. 播放清單的類型

設定播放清單的類型: 目前 XMMS2 支援三種類型的 playlists，這三種類型的播放清單都有一些屬性，可用 xmms2 coll attr 命令來設定，這三種類型分別為：
1. list: 最簡單，內含 medialib 的 ids。只有一種 attribute: jumplist。jumplist 是當目前清單播放完後要跳過去的 playlist 名稱。
2. queue: 是一份靜態的清單，支援固定長度的播放清單，當樂曲播放後，就會被移除，queue 有兩種 attributes: jumplist 與 history。jumplist 同前，history 則是要保留的播放過樂曲的數量。
3. pshuffle: 從 collection 中隨機抽出的一些樂曲，有三種 attributes：jumplist、history 與 upcoming。前兩種同前，upcoming 是指在播放清單中必需維持的尚未播過的曲目數量。

6. Collection

所謂 Collection，就是 Media Library 內某些曲目的集合，譬如：

周杰倫的專輯
1950 以前的 jazz 類的音樂
我最愛的幾首歌
上週才加入的音樂 (某人某首歌除外)

以 Collection 的性質來看，前兩項是動態的，可藉由向 media library 資料庫發出 query 來取得符合的曲目清單，例如：我剛剛將一張周杰倫的專輯加入資料庫，那麼現在再搜尋 artist 為周杰倫的專輯，找出來的結果就會比之前多出剛剛新加入的這張專輯的資料。

第三項 (我最愛的幾首歌) 是一份靜態的清單，也就是說我喜歡的歌是一首一首指定的，除非我自己增減，否則這份清單不會改變。

第四項則混合了動態與靜態的清單。

表面上看，這似乎類似於 Playlist，或者 Dynamic Playlist，但其實 XMMS2 對 playlist 與 collection 的處理是非常不同的。

XMMS2 的 collection，是沒有排順序的，不可用來播放，它只是用來將 media library 中的某些曲目分出來成為一個小組(subset)，讓聆聽者容易取得這個小組內的曲目而已。如果想聽 collection 內的曲目，必需依 collection 的內容建立 playlist，才可播放。簡單講，collection 是 a set of media，又稱 mediaset，就技術上來講，是 unordered collection。也可將 collection 看成是用 filter 篩選過的 media library，也就是向資料庫 query 的結果。

XMMS2 的 playlist，是一份有順序的曲目清單，是可用來依序播放的。就技術上來講，是 a list of media，又稱 medialist，其實還是一種 collection，只不過它是 ordered collection。

Collection 存在的目的，是為了讓使用者可以更容易、更方便地從龐大的 media library 中取出某一部分 (collection)，依據這個部分，或是這個部分的某一部分，來建立播放清單，讓 playlist 的建立更簡便。

XMMS2 可以有許多 collections，這些 collections 可放到不同的 namespace 中來分類，這些 namespace 彼此不會重疊，如果一個 collection 在某個 namespace，它就不會同時存在於另一個 namespace，但某個 namespace 內的 collection 仍可 reference 到另一個 namespace 內的 collection。

預設有兩個 namespace，一個是 Playlists，專門用來放播放清單；一個是 Collections，用來放一般使用者自己定義的 collections。

XMMS2 在指定 collname 時，有時必需加上所屬的 namespace，此時只要在 collection name 前加上所屬的 namespace 即可，譬如：

Playlist/collname
Collections/collname

6.1. Collection 的用法

xmms2 coll list [namespace]: 列出指定的 namespace 的所有 collections。

$ xmms2 coll list Collections
$ xmms2 coll list Playlists
$ xmms2 coll list (會列出 Collections 與 Playlists 的 collections)

xmms2 coll save [collname] [PATTERN]: 把 PATTERN 的 query 結果儲存到名稱為 collname 的 collection。
```
$ xmms2 coll save björk artist:bj?rk (將 artist 為 bj?rk 的曲目建立成一個 collection)
```

xmms2 coll rename [oldname] [newname]: 把原名為 oldname 的 collection 改為 newname。

$ xmms2 coll rename björk bjork (將原名為 björk 的 collection 改為 bjork)
$ xmms2 coll rename Playlists/test Playlists/hello (更改播放清單名稱)

xmms2 coll query [collname] [order]: 列出 collname 這個 collection 內的曲目，並依 order 來排序。(order 是前面提過的 field，可使用多個 fields，以逗號隔開)

$ xmms2 coll query bjork (列出 bjork 這個 collection 內的曲目,預設會用 id 排序)
$ xmms2 coll query bjork title (列出曲目，並依 title 來排序)
$ xmms2 coll query bjork album,title (先用 album 排序，再用 title 排序)

xmms2 coll queryadd [collname] [order]: 將 collection 的曲目加入目前使用中的 playlist
```
$ xmms2 coll queryadd bjork title
```

xmms2 coll find [media_id] [namespace]: 在 namespace 或所有的 collections 中(假如沒有指定 namespace)找尋誰有指定的 media_id

$ xmms2 coll find 01949 (在所有的 namespace 中尋找誰有 id 為 01949 的 collection)
$ xmms2 coll find 01949 Collections (僅在 Collections 這個 namespace 尋找)

xmms2 coll get collname: 列出名稱為 collname 的 collection 的結構。

$ xmms2 coll get bjork (列出名為 bjork 的 collection 的結構)
Match ('artist', 'b??rk*') for:
  Reference: 'All Media'
$ xmms2 coll get Playlist/new (列出名為 new 的播放清單結構)
Idlist: (40, 2468, 2469, 2470, 2471, 2472, 2476)

xmms2 coll attr [collname] [attr] [val]: get/set 一個 saved collection 的 attribute。
1. 對於 list 類型的 playlist，可設定 jumplist 這個 attribute。jumplist 就是播完目前播放清單後要跳過去的下一份播放清單的名稱。
2. 對於 queue 類型的 playlist，可設定 jumplist 與 history 這兩個 attribute。jumplist 的意義與之前相同；history 屬性是一個數字，是用來指定對於已播放過曲目要保留多少筆的設定。
3. 對於 pshuffle 類型的 playlist，可設定 jumplist、history 與 upcoming 這三種類型的屬性。jumplist 的意義與之前相同，但要注意一點，pshuffle 只有在其來源的 collection 中已無法再由 media library 找到符合條件的曲目時，才代表播完這份 playlist。history 的意義與之前相同。upcoming 屬性是一個數字，代表尚未播放過、要顯示在 playlist 中的曲目的數量。
  $ xmms2 playlist type test1 pshuffle Collections/bjork (設定 test1 這份播放清單的類型為 pshuffle，由 bjork 這個 collection 抓出曲目) $ xmms2 coll attr Playlists/test1 upcoming 2 $ xmms2 coll attr Playlists/test1 history 3 $ xmms2 coll attr Playlists/test1 jumplist test2 (bjork 這個 collection 如果沒有曲目，才會跳到 test2 這份播放清單，注意，test2 這份播放清單不要寫成 Playlists/test2，會找不到) $ xmms2 coll attr Playlists/test1 (顯示 test1 的 attr) $ xmms2 playlist load test1 $ xmms2 play $ xmms2 next $ xmms2 list …… (必需 xmms2 next 與 xmms2 list 幾次後才看得出差別)
xmms2 coll remove [collname]: 移除一個之前已儲存的 collection
```
$ xmms2 coll remove bjork
```

如需更多資訊，可見 Collections Concept。

7. XMMS2 的設定

列出已安裝的 plugin
```
$ xmms2 plugin_list
```
列出設定值
```
$ xmms2 config_list
```
指定設定值
```
$ xmms2 config config_key [=] value
```

開啟某種 effect

xmms2 config effect.order.0 some-effect-name
xmms2 config some-effect-name.enabled 1

設定使用 replaygain

xmms2 config effect.order.0 replaygain
xmms2 config replaygain.enabled 1