HMplayer
========

バージョン 1.05

概要
----

HMplayerは、編集可能なプレイリスト、メタデータと埋め込みアルバム
アートの表示、モニター機能、Icecast配信機能を備えたWindows向け
オーディオプレイヤーです。

動作環境
--------

- Windows 11
- Windows NエディションではMicrosoft Media Feature Packが必要になる
  場合があります。

対応音声形式
------------

- MP3
- FLAC
- M4A（AAC / ALAC）
- WMA
- WAV

音声形式の対応にはWindows Media Foundationを使用しています。

WAVファイルは、Windows Media Foundationで再生可能な音声形式を対象とします。

対応プレイリスト形式
--------------------

- M3U8

従来のM3U形式は直接サポートしていません。

主な機能
--------

- 再生、一時停止、停止、シーク、音量調整
- 編集可能なプレイリストとドラッグ＆ドロップによるファイル追加
- タグメタデータ表示
- 埋め込みアルバムアート表示
- Monitor Window
- Level Meter
- 英語 / 日本語ユーザーインターフェース
- 再生中Playlistの終了予定時刻算出
- 再生できなかったトラックはファイル名で表示し、再生時間を非表示
- 再び正常に再生できたトラックは通常のPlaylist表示へ復帰
- Playlistのトラックについて、ファイル名、パス、保持しているメタデータ、
  M3U8のEXTINF情報を確認できる「トラック情報」機能
- 音源ファイルが移動・削除されている場合でも、HMplayerが保持している
  情報を確認可能

終了時刻はPlaylistに記録されている再生時間をもとに算出し、音源ファイルの
存在確認は行いません。

Playlistへのトラック追加
-------------------------

対応音声ファイルは次の方法で追加できます。

- 複数ファイルを含むファイルのドラッグ＆ドロップ
- フォルダーのドラッグ＆ドロップ
- `File > ファイルを追加...` からの複数ファイル選択
- `File > フォルダーを追加...` からの1フォルダー選択

フォルダーをドラッグ＆ドロップした場合は、そのフォルダー直下にある対応
音声ファイルだけを追加します。サブフォルダーは検索しません。ファイルと
フォルダーを混在してドラッグ＆ドロップすることもできます。

`フォルダーを追加...` には `サブフォルダーを含める` オプションがあります。
初期状態はONです。OFFにすると、選択したフォルダー直下だけを追加します。

これらの操作ではMP3、FLAC、M4A、WAV、WMAを追加できます。

配信機能
--------

HMplayerは既存のIcecast2サーバーへMP3音声を送出できます。HMplayerは
Icecastのソースクライアントであり、Icecastサーバー本体は含みません。

- 44100 Hz、ステレオ、設定可能なビットレートによるMP3配信
- 同時配信接続数は最大3接続
- 配信メタデータと設定可能なメタデータ遅延
- UTF-8 / Shift_JISメタデータエンコーディング
- スピーカー再生音量とは独立したStreaming Gain
- Transfer Rate表示

HMplayer起動時に配信サーバーへ自動接続は行いません。配信設定や操作の
詳細はオンラインマニュアルを参照してください。

インストール
------------

ZIPファイルを任意のフォルダへ展開し、hmplayer.exeを実行してください。
同梱のDLLはhmplayer.exeと同じフォルダに置き、resourcesフォルダも元の
配置を維持してください。DLLを別途ダウンロードする必要はありません。

アルバムアート未設定時の画像
----------------------------

トラックに埋め込みアルバムアートがない場合、以下の画像を使用します。

resources/blank.png

このファイルを別の有効なPNG画像へ差し替えられます。400 x 400ピクセルを
推奨しますが、ほかのサイズのPNGも使用できます。読み込めない場合、
Album Artウィンドウの背景は黒になります。

設定保存先
----------

アプリ設定やウィンドウ状態は以下に保存されます。

%LOCALAPPDATA%\HMplayer

配信サーバーのパスワードはローカル設定ファイルへ平文で保存されます。
Windowsユーザーアカウントと設定ファイルを適切に保護してください。

オンラインマニュアル
--------------------

https://applications-7m9.pages.dev/hmplayer/manual

ライセンス
----------

HMplayer本体はMIT Licenseで提供されます。

ライセンス情報は以下を参照してください。

- LICENSE.txt
- THIRD_PARTY_NOTICES.txt
- THIRD_PARTY_LICENSES/

注意事項
--------

プレイヤーおよび配信機能の詳しい操作方法は、このREADMEではなく
オンラインマニュアルで案内します。
