﻿556LUNALINK PC companion
=====================

Wallpaper EngineのK's / 556LUNALINKに、実測したPC情報を渡す任意の補助機能です。
CPU・メモリ・通信の送受信速度・起動時間・Cドライブの空き容量を取得します。
NVIDIA GPUでは、nvidia-smiが利用できる場合に使用率・温度・VRAM・消費電力・クロックも取得します。
非対応の項目は空値になります。対応版では認識できたSpotify・Apple Musicの再生中の経過時間を「WITH MUSIC」へ渡します。
音声の録音、曲名・ジャケット・曲ごとの履歴の保存、プレイヤーやPCの操作は行いません。

使い方
------
1. Python 3.10以降が必要です。
2. 556LUNALINKの壁紙フォルダーと、このフォルダーを隣同士に配置してください。
3. PowerShellから次のように開始します。
   powershell.exe -NoProfile -File .\start.ps1 -WallpaperDir "C:\path\to\your\wallpaper"
4. 壁紙を再読み込みし、「PCステータス（このPC内）」をONにすると、PCの実測値が表示されます。初期状態はOFFです。
   Wallpaper Engineのエディターで読み込んだ場合は、実際のmyprojects内の壁紙フォルダーを指定してください。
5. 終了は、同じ補助機能フォルダーのstop.ps1を実行してください。
   powershell.exe -NoProfile -File .\stop.ps1

このフォルダーのスクリプト自体は、自動起動やサービス登録を行いません。
補助機能が停止した時は、壁紙のPC数値は「--」に戻ります。
計測は約1秒ごと、GPUは約2秒ごとです。通信速度は実際のインターフェイスの差分値です。
速度テストのダウンロードなどは行いません。

接続について
------------
接続先は127.0.0.1:8771のみです。PC情報は読み取り専用の/v1/statusで取得します。ココロタイムの画面間同期に/v1/kokoroを追加しています。開始時刻・演出種別・乱数シード・中止だけを同じPC内で短時間共有し、ファイルには記録しません。
通常の新規起動ではランダムな接続トークンを作り、指定した壁紙のpc-link-config.jsへ設定します。
既存controlの停止済みプロセスとペアリングを厳格に照合する--resume-controlでは、同じトークンを保持します。
このモードでは壁紙の設定を書き換えず、正常停止後もstopped:trueのcontrolを保持します。
ブラウザーの検証画面127.0.0.1:8769と、Wallpaper Engineのファイル表示だけを許可します。
既存のブラウザー版PC取得機能（ポート8768）には変更を加えません。

音楽の累計
----------
Spotifyと、Windowsに登録されたApple MusicアプリのSMTCセッションを読み取り、
PLAYINGの連続した新鮮な観測間だけ、経過秒数を積算します。対応プレーヤーの停止・一時停止・
取得失敗・スリープ中は加算しません。複数の対象セッションが同時再生しても二重加算しません。
音量や実際に聴いていたことの計測ではなく、対応プレーヤーの再生状態だった実測時間です。
動画やポッドキャストもSpotify内の再生状態として数えます。

累計とWindowsの起動識別子だけを、同じフォルダーのmusic-time.state.jsonへ保存します。
約15秒ごと、再生が止まった時、正常終了時に保存します。同じWindows起動中は復元し、
新しいWindows起動ではゼロから始めます。壁紙を閉じても、この補助機能が動いていれば継続します。
補助機能の導入前や停止中の過去再生時間は復元しません。初回・途中導入・観測の欠落は
coverageComplete:falseで示し、未観測時間を遡って加算しません。
未知の再生状態では既知の累計を保持し、古い取得状態として返します。
スリープを除くQueryUnbiasedInterruptTimeを使い、端末時計の変更による時間の跳びを避けます。
約1秒の観測なので、再生・一時停止の境界にはサンプル周期程度の誤差があります。

再開とログオン
--------------
既存のペアリングを維持して正常終了する場合:
  powershell.exe -NoProfile -File .\stop.ps1 -PreservePairing
保存済みcontrolから再開する場合:
  powershell.exe -NoProfile -File .\start.ps1 -ResumeControl
ログオン用の任意の入口:
  powershell.exe -NoProfile -File .\start-at-logon.ps1 -WallpaperDir "C:\path\to\your\wallpaper"

start-at-logon.ps1は、既存の対象プロセスが動いていれば二重に起動しません。
停止済みcontrolがあれば、ペアリングを保持して再開します。controlがない場合は指定した壁紙の
新規ペアリングへ進みますが、既存のペアリングを勝手に上書きしません。
自動起動を使う場合のWindowsスタートアップへの登録は別途行う操作です。
管理者権限のサービスやネットワークへのアクセスは必要ありません。
正常終了はローカルのpc-companion.stop.jsonで要求し、累計を保存して終了します。

配布時は、pc-companion.control.json、pc-companion.stop.json、music-time.state.json、
music-time.state.json.*.tmp、*.log、__pycache__を含めないでください。
壁紙のpc-link-config.jsはtokenが空の状態に戻してください。
556LUNALINKと一緒に配布する場合も、補助機能を起動するかどうかは利用者が選べます。
計測値は同じPC内の壁紙へ渡します。K's、kokorobeats、他の利用者や共有サーバーへ送信する機能はありません。
通信速度はこのPC全体の通信量であり、アーティストとの送受信を示すものではありません。

補助機能の画面からの復旧（0.2.3以降）
壁紙0.2.9以降のSHARE横の補助機能を再起動ボタンで、PC／WITH MUSIC／既存SHAREを再起動します。OBSの動作には影響しません。曲情報の再認識ボタンとは別です。
復旧専用の127.0.0.1:8775はPCと別プロセスで起動し、同じペアリングの認証済み要求だけを受け付けます。通常の停止では累計を保存し、ペアリングを維持して再開します。機能を新たに有効化しません。復旧機能自体が停止している場合は最新版セットアップを実行してください。
start-recovery.ps1／stop-recovery.ps1で復旧専用処理だけ起動・停止できます。再起動中は停止要求を拒否します。


壁紙の再生コントロール
Windowsのメディアセッションを使います。表示中の曲名・アーティストが一致した場合のみ操作します。対応していない操作は無効になります。Spotify APIへの接続や追加のログインは必要ありません。

YouTube MusicでWITH MUSICを使う場合
────────────────────────────
Chromeで https://music.youtube.com/ を開き、YouTube Musicをアプリとしてインストールしてください。
インストールしたアプリで音楽を再生し、556◎LINKの「補助機能を再起動」を一度押してください。
通常のブラウザータブの再生は計測しません。
公式アプリの識別情報と、現在のアドレスがmusic.youtube.comであることを両方確認して計測します。
通常のYouTubeへ移動した場合や、識別情報を確認できない場合は計測を保留します。
YouTube Music内のMVも計測対象です。ブラウザー拡張機能や追加のログイン連携は必要ありません。
今回のテストではChromeのアプリ版で確認しています。Edgeのアプリ版は実再生の確認が残っています。
