***************************************************************************************************

     拡張Web : mpdweb /PLSPlaylist インストール
                                                                              2024.04.10  ver.1.00
***************************************************************************************************
mpdwebを拡張する機能、PLSPlaylistは ストリーミングの.pls形式のPlaylistから再生する機能。
PlaylistからPLSボタンをクリックしてで切り替えるとができる。
pls形式と画像のアーカイブを同じディレクトリに置いていく。
mpdweb_plslist_{RelaseDate}.tar.gz
アーカイブがない場合は、PLSPlaylist機能はインストールするが自己.pls/.jpgのファイルを用意する

1.インストール方法は，
Volumio/Moode audioでは環境に合わせて使用できる。

$su -
# cd /mnt/INTERNAL
# chmod 0777 install_pls.sh
# ./install_pls.sh

 ./install_pls.sh [mode={InstMode}]
   "" , 内封しているPLS画像を使用しInstall
   mode=moode : MoOdeAudio の RADIO を使用してInstall
   mode=share : ディレクトリを作成するだけ。作成後、mountすれば共有となる
   mode=remove: /mntのPLSPlaylistを削除。lnでない場合はそのまま削除しない

シェル内でsambaを再起動する。
 mpdweb PLSPlaylist: /mnt/PLSPlaylist
  PLS   : .plsファイルの設置ディレクトリ
  Image : .jpg画像ファイルの設置ディレクトリ
MPDWEBのPlaylist機能にPLSボタンを有効にしている。

2.".pls"ファイル&画像ファイルの設置方法

PLSファイルのファイル名 ：{任意の名前}.pls
画像ファイルのファイル名: {PLSファイルと同じ任意の名前}.jpg (pngも設定済なので使用可能)
                           画像は300X300で作成している。

,plsファイル形式
moOdeAudioの.plsを使用できるように同じフォーマットとしている。一般的な形式でもある。
[playlist]             : ヘッダー
File{n}=URL/ファイル名 : 再生目的のURLを設定:本システムではストリーミングのURL
Title{n}=タイトル      : ファイル{n}と合わせて使用する。表示タイトル
Length{n}=時間|-1      : 再生時間を設定ストリーミングは"-1"で良い
...以下任意に複数設定できる。
NumberOfEntries1=1     : 設定数(未設定可)
Version1=2             : 版数 (未設定可)
Favorite={n}           : 拡張機能。未設定で可。お気に入りを設定 n:1〜5で設定 (Sortで使用できる)

ファイル例) NHK-FM.pls
[playlist]
File1=https://radio-stream.nhk.jp/hls/live/2023507-b/nhkradiruakfm/master48k.m3u8　(必須)
Title1=NHK-FM
Length1=-1
File2=https://radio-stream.nhk.jp/hls/live/2023507/nhkradiruakfm/master.m3u8
Title2=NHK-FM-Station
Length2=-1
NumberOfEntries1=1
Version1=2
Favorite=1:

3.PLSPlaylistの有効/無効設定
  インストーラで有効にしているが有効/無効を設定できる。
  いくつか方法があるが
    mpdweb/mpdconfig.xmlを編集すれば設定できる。
    <ExtendModule>
      <Playlist>{on|off}</Playlist> : on:有効/off:無効と設定できる。
 変更ツールは
 ・mpdweb/shell/mpdextendset.sh
     $ mpdextendset.sh tag=playlist flag=on
   を実行
 ・Webから単体で実行
   http://{IPAddress}:{Port}/mpdweb/mpdsetting_Extendmod.php?setup
   Extend Module:ListHost : Enableをクリック。 (EnableになっているとDisableと表示される)
 ・MPDWEBから起動
   NowMusicの「...」CommonFunctionを表示→MPDWEB Configをクリック→上部右「Extend」をクリック
   Webから単体で実行と同じ画面が表示されるので操作は同じ。

  ※実行できない場合
    インストーラで変更しているが
    chmod 0755 mpdweb/shell/mpdextendset.sh
    また、mpdextendset.sh/mpdconfig.xmlを探しているのでmpdweb下に同じ名前で複数持たないようにする。
    コピーを取る場合、mpdconfig.xml.backupなどにRenameしておくこと。

4.PLSPlaylist設定
  mpdweb_playlist.xmlをインストールに合わせて用意している。
  設定を変更する場合，mpdweb_playlist.xmlをmpdweb_playlist_myset.xmlにコピーして使用する。
  mpdweb_playlist_myset.xmlがあれば優先して使用する。
  .pls/画像ファイルを用意しているのでそのまま使用できるの戻すときmpdweb_playlist_myset.xmlを削除するなりで済むようにした。
  自前で.pls/画像ファイルを用意するとき以外は変更しなくて使用できる。

5.他のMPDWEBがある場合MPDWEBのTaskServerで使用できる。
  <TaskServer><Host>192.168.0.122</Host>          : MPDWEBのTaskServerのAddress
  <WebPath><WEBPath>http://{ip}:{Port}/</WEBPath> : 画像を表示するURL(TaskServerと別に設定できる)

6.moOdeAudioにインストールした場合
  moOdeAudioの.plsを使用できるようにしているが、設定をmoOdeAudioのディレクトリにすればmoOdeAudioの環境で使用できる。
  mpdweb_playlist_myset.xml.moodeaudioを用意しているのでmpdweb_playlist_myset.xmlにRenameすれば使用できる。
