Playlist Manager
Version 1.03

English documentation: README.txt

概要

Playlist Managerは、音楽プレイリストの管理とM3U8プレイリストの
エクスポートを行うWindows 11向けアプリケーションです。Windowsの
ネイティブUIを使用し、プレイリストのデータとディスク上の音声ファイルを
分離して管理します。

リンク

公式サイト:
https://applications-7m9.pages.dev/playlist-manager/

オンラインマニュアル:
https://applications-7m9.pages.dev/playlist-manager/manual

ソースコード:
https://github.com/hman0765/MusicPlaylistManager

主な機能

- プレイリストとプレイリストグループの管理
- グループを一つだけ展開する表示モード
- M3U8とM3Uプレイリストのインポート
- M3U8プレイリストのエクスポート
- Windows Explorerからの音声ファイルのドラッグ＆ドロップ
- TagLibによるメタデータ取得
- メタデータ取得中の進捗表示
- トラックカラムの表示項目と順序のカスタマイズ
- プリセットまたはカスタム形式によるEXTINF生成
- 選択トラックまたはそのフォルダを外部アプリへ送る機能
- トラック数と合計再生時間の表示

基本操作

UIの言語を変更する
  Settings > Language（設定 > 言語）からEnglishまたは日本語を選択します。
  設定は選択時に保存され、Playlist Managerを次回起動したときに反映されます。
  実行中の画面はその場では再構築されません。

プレイリストを作成する
  Playlist > New Playlist（プレイリスト > 新しいプレイリスト）を使用します。
  プレイリスト名はPlaylistメニューまたはF2キーで変更できます。

音声ファイルを追加する
  対応する音声ファイルをWindows ExplorerからTrackペインへドラッグするか、
  File > Open Audio Files（ファイル > 音声ファイルを開く）を使用します。

M3U8またはM3Uプレイリストをインポートする
  File > Import Playlist（ファイル > プレイリストをインポート）を使用するか、
  M3U8またはM3Uファイルをアプリケーションへドロップします。M3Uファイルは
  UTF-8およびWindows日本語環境で一般的なCP932形式に対応しています。一部の
  プレイヤーが出力するPercent-EncodingされたUTF-8パスも可能な範囲で復元します。

M3U8プレイリストをエクスポートする
  プレイリストを選択し、File > Export M3U8（ファイル > M3U8をエクスポート）
  を使用します。EXTINF本文の形式はSettings > EXTINF Format
  （設定 > EXTINF形式）で設定できます。

メタデータを取得する
  1つ以上のトラックを選択し、Track > Get Metadata
  （トラック > メタデータを取得）を使用します。現在表示されているトラック
  カラムに必要なメタデータだけを取得します。この操作は音声ファイルから
  情報を読み取るだけで、タグの書き込みや変更は行いません。処理中はモーダルな
  進捗ウィンドウに処理済み件数と選択件数が表示され、完了すると自動で閉じます。
  存在しないファイルや読み取りに失敗したファイルも処理済みとして数えるため、
  残りのトラックの処理は継続されます。

プレイリストを整理する
  Playlist > Organize Playlists（プレイリスト > プレイリストを整理）から、
  グループの作成、グループ間のプレイリスト移動、並べ替え、プレイリストの
  削除を行えます。

グループの展開方式
  初期状態では複数のプレイリストグループを同時に展開できます。
  Settings > Expand Only One Group（設定 > グループを一つだけ展開）を
  有効にすると、左側で同時に展開できるグループが最大1つになります。有効に
  した時点ですべてのグループが折りたたまれ、その後は別のグループを開くと
  先に開いていたグループが自動的に閉じます。現在のグループを閉じ、展開中を
  0件にすることもできます。無効に戻しても現在の展開状態は変更されず、以後は
  複数のグループを同時に展開できます。

外部アプリへ送る

Settings > Send To Applications（設定 > アプリに送る）で、外部プレイヤー、
タグエディター、その他の実行ファイルを登録できます。上矢印と下矢印ボタンで
アプリの順序を変更できます。リストの先頭にあるアプリが既定の送信先となり、
トラックをダブルクリックしたときに使用されます。

Arguments（引数）欄には、次のプレースホルダーのどちらか一方を正確に1つ
含める必要があります。

  %files%   選択した音声ファイルのパスに置換されます。複数のトラックを
            選択して外部アプリへ渡せます。

  %folder%  選択した1トラックの親フォルダに置換されます。この形式は、
            送信するトラックが1つの場合だけ利用できます。

例:

  /add %files%

データの保存場所

アプリケーションの状態と設定は、次のファイルへ自動保存されます。

  %LOCALAPPDATA%\PlaylistManager\state.json

ファイル削除に関する重要事項

Playlist Managerでプレイリストを削除したり、プレイリストからトラックを
削除したりしても、ディスク上の音声ファイルそのものは削除されません。
変更されるのは、アプリ内部のプレイリストデータとエクスポートした
プレイリストファイルだけです。

Get Metadata（メタデータを取得）はタグと音声プロパティを読み取ります。
Version 1.03では、音声ファイルのタグを編集または書き込みません。

動作環境

- Windows 11
- TagLibは静的リンクされているため、追加のTagLib DLLは不要です。

ライセンス

このプロジェクトはMIT Licenseのもとで公開されています。
詳細はLICENSEをご覧ください。

この文書の英語版はREADME.txtを参照してください。
