mos9527/SonyHeadphonesClient (rewrite ブランチ) を土台にした 個人開発の非公式 PC クライアント。日本語 UI 対応と Windows ポータブル版 (単一exe + 任意 settings.ini) の同梱を行っています。実機ターゲットは WH-1000XM6 / WF-1000XM6。
Important
Sony および "WH-1000XM..." 等の名称は Sony の登録商標です。本プロジェクトは Sony とは無関係の非公式ツールです。利用は自己責任で。
- Releases ページから最新の
SonyHeadphonesClient-vX.Y.Z-win-x64-portable.zipを取得 - zip を任意のフォルダに解凍
SonyHeadphonesClient.exeをダブルクリックで起動 — DLL の追加配置は不要
zip に含まれる settings.ini.sample を settings.ini にリネームして exe と同じフォルダに置きます。中身：
locale=jasettings.ini が無い場合は英語で起動します（システムタブの「言語」から日本語に切替も可能、その操作で settings.ini が自動生成されます）。
- Windows 10 (1903+) / 11 — UCRT 標準搭載が前提
- Bluetooth Classic 接続のヘッドホン (v0.2.0 以降は BLE GATT 経由の制御チャネルも併用)
- 対応機種は upstream の
docs/device-supportを参照
upstream rewrite ブランチの全機能をそのまま継承：
- イコライザー (5/10 バンド + プリセット + Clear Bass)
- ノイズキャンセリング / 外音モード切替・外音レベル / 適応感度 (XM6)
- DSEE on/off、BGM、Cinema、リスニングモード
- Speak-to-Chat、ヘッドジェスチャー
- マルチポイント (2台同時接続)、ペアリング済みデバイス管理
- タッチセンサー / NC・AMB ボタン機能割当
- 装着検出、自動電源オフ、音声ガイド、Sidetone
- バッテリー表示 (本体 / L・R / ケース)、コーデック表示、Now Playing メタデータ
このフォーク独自の追加：
- 日本語 UI — 約 200 文字列を翻訳。システムタブから即時切替可能
- ポータブル化 — MSVC ランタイム (
vcruntime/msvcp/ucrtbase) を/MT静的リンクし DLL 同梱不要、settings.iniも exe 隣に保存
- BLE GATT バックエンド：v0.1.x までは MinGW 環境で C++/WinRT が使えず Windows BLE バックエンド (
PlatformWindowsBLE.cpp) を除外しており Classic Bluetooth (RFCOMM) 専用でした。v0.2.0 から MSVC + Win SDK 構成に切替えて BLE GATT 制御チャネルを併用できるようにしています。新構成での実機検証は完了していないため安定動作は無保証、不具合時はペアリング設定で Classic 接続に戻してください。 - LE Audio (LC3) 非対応：本フォークは LE Audio の音声ストリーミング (LC3 codec / Auracast / CIS / BIS) を扱いません。BLE バックエンドは GATT 制御専用で、LC3 streaming は別 API (
Windows.Media.Audio) + BT 5.2 ハードウェア + Win11 22H2+ ドライバ要件のため scope 外です。 - upstream PR 予定なし：個人運用のため、本フォークから upstream への取り込み計画はありません。
詳細は CLAUDE.md を参照（必要ツールのバージョンや環境変数、典型的なハマりどころを記載）。要点のみ：
MSVC + Windows SDK（v0.2.0 以降の標準、BLE 有効）：
# MSVC env を activation した上で cmake/ninja を呼ぶ
cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build --target SonyHeadphonesClient -j2
./build/client/SonyHeadphonesClient.exeMinGW（fallback、BLE 除外）：
cmake -G Ninja -B build -DCMAKE_BUILD_TYPE=Release -DMDR_DISABLE_BLE=ON
cmake --build build --target SonyHeadphonesClient -j2GitHub Actions のリリースワークフローは MSVC 構成 (ilammy/msvc-dev-cmd@v1 + lukka/get-cmake@latest) で同等手順を実行します（.github/workflows/release.yml）。タグを v* 形式で push するとリリースが自動生成されます。
- 上流：mos9527/SonyHeadphonesClient (
rewriteブランチ) — そのさらに上流は Plutoberth/SonyHeadphonesClient - ライセンス：上流に従う (MIT)。本フォークの追加・改変部分も同条件で利用可能とします
- 非公式の注意：Sony 公式アプリ "Sound Connect" の機能を独自に解析・再実装したものです。Sony によるファームウェア更新でプロトコルが変動した場合、動作しなくなる可能性があります