so-dsc

非公式 / サードパーティ実装 (unofficial third-party)。Sony DSC シリーズ (動作確認: DSC-RX100M5A) の Camera Remote API を再実装した Flask ビューア + 操作 + コンテンツ取り込み + AI 撮影係用 MCP サーバ。旧 PlayMemories Mobile / Imaging Edge Mobile の代替。

⚠️ 本リポジトリは Sony Group Corporation / Sony Imaging Products & Solutions Inc. と一切関係ありません。 Sony が公開していた Camera Remote API SDK の公開仕様 (developer.sony.com、現在は EOL) を参照して、 サードパーティが独自に実装したクライアントです。Sony 公式アプリのコード は含まれておらず、暗号化や保護機構を回避するものでもありません。 "Sony"、"PlayMemories"、"Imaging Edge"、"Creators' App"、"DSC"、 "RX100" は Sony Group Corporation の商標です。

プロトコル仕様: docs/protocol.md 最小再現 (依存なし): scripts/grab_frame.py

使い方

# 1) カメラ本体メニュー: ネットワーク → Bluetooth リモートコントロール →
#    「常時接続」を ON にしておくと、電源 ON で勝手に Smart Remote が立ち上がる。
#    そうでなければ:
#      アプリケーション → スマートリモコン を都度起動 (画面に SSID + PW 表示)
# 2) PC 側で `DIRECT-XXXX:DSC-RX100M5A` に Wi-Fi 接続
# 3)
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements.txt
SODSC_HOST=192.168.122.1 python run.py
# → http://127.0.0.1:5050 を開く

カメラ内画像/動画の取り込みは カメラ本体側で 「スマートリモコン」を抜けて 「スマートフォンに送る」を起動する必要がある (RX100M5A は setCameraFunction 未対応のためソフト経由でモード切替できない)。その状態で UI の Camera content タブの Load list を押す。撮影に戻すにはカメラ側で再度「スマートリモコン」へ。

環境変数:

名前	既定	説明
SODSC_HOST	(SSDP 自動発見)	カメラ IP。RX100M5A は AP モードで 192.168.122.1
SODSC_DD_PORT	64321	UPnP DD.xml 取得ポート (各サービスポートは DD.xml から動的に取得)
SODSC_DL_DIR	downloads	カメラから取り込んだ画像の保存先
HOST	127.0.0.1	Flask bind host
PORT	5050	Flask port (5000 を避ける: macOS Monterey 以降の AirPlay Receiver と衝突)

機能

• ライブビュー (Sony 独自バイナリストリームをパースして MJPEG として配信)
• リモートシャッター + AF (半押し / focusStatus ポーリング付) + ズーム
• 設定変更: ISO / シャッタースピード / F値 / EV / WB
• バルブ撮影 / 連写制御
• 動画記録 (startMovieRec / stopMovieRec で本体 SD カードへ録画)
• カメラ内画像/動画一覧 (Camera Remote API avContent または DLNA UPnP 経路自動分岐)
  • サムネ + Large JPEG (1920×1080 上限) ダウンロード
  • DLNA 経路ではフル解像度 RAW (.ARW) は取れない — Sony 仕様の制約
• AI 撮影係用 MCP サーバ (Claude Code 等から 18 ツール経由で操作)

仮想カメラ出力 (Zoom / Meet / FaceTime 等):

• OBS Studio の Virtual Camera 経由 で対応。ネイティブ実装は不要 — OBS が Mac/Win/Linux 全部に対応してくれる。詳細は下記「仮想カメラとして使う」を参照。

仮想カメラとして使う (OBS 経由)

Zoom / Google Meet / FaceTime / QuickTime などに RX100M5A のライブビューを 仮想カメラとして見せる やり方。OBS Studio の Virtual Camera 機能を中継に するので、ネイティブ Camera Extension / DAL plugin は不要、Mac/Win/Linux 共通で動きます。

1. OBS Studio をインストール (https://obsproject.com)
2. so-dsc Flask サーバを起動 (python run.py)
3. OBS で Browser Source を追加:
   • URL: http://127.0.0.1:5050/embed (PORT が違う場合は合わせる)
   • Width: 640 / Height: 424 (Sony liveview ネイティブ)
   • 「Shutdown source when not visible」「Refresh browser when scene becomes active」 はお好みで (推奨: ONになってると配信状態が安定する)
4. シーンに Browser Source を配置・サイズ調整
5. OBS の右下 Start Virtual Camera をクリック
6. Zoom / Meet / FaceTime のカメラ選択で OBS Virtual Camera を選ぶ

/embed は OBS Browser Source 用のクロームレスページ — 全画面 <img> で liveview を表示し、stale 検知で <img> を自動再アタッチします (配信中にカメラが一瞬切れても OBS 側を再起動しなくて済む)。

OBS の他のソース (テロップ、ロゴ、別カメラ、スクリーンキャプチャ) と 合成できるのも便乗のうれしさ。

動画記録

UI の Movie REC ボタン (Shoot タブ) または MCP の start_movie_rec / stop_movie_rec ツールで本体 SD カードへ動画を記録します。

RX100M5A での前提:

• カメラ本体ダイヤルを動画ポジションに合わせる必要あり (setShootMode は Smart Remote Control SAK で未提供のため、API 側からモード切替はできない)
• ダイヤルが動画位置になると startMovieRec / stopMovieRec が getAvailableApiList に出現する → UI の Movie REC ボタンが有効化
• 録画中は cameraStatus event slot が MovieRecording になる

録画したファイルは本体 SD カードに残ります。Wi-Fi 経由で取り込むなら 本体メニューで「スマートフォンに送る」モードに切り替えて Camera content タブから DL (DLNA 経由・Large JPEG プレビュー版のみ取得可能、本機種では オリジナル動画は SD 直接 or USB 経由でないと取れません)。

制約

• カメラの Wi-Fi AP は 同時接続クライアント 1 台 のみ受け付ける。純正アプリと 同時には使えない。
• Flask の reloader は 2 プロセス起動するためカメラ側の 1-client 制限とぶつかる。 run.py では reloader を無効化済み。
• setCameraFunction 直後はカメラ側状態がしばらく不安定。Flash モード切替直後に startLiveview を叩いて Illegal State が返る場合は数秒待って再試行する設計。
• macOS Safari は multipart/x-mixed-replace の挙動が貧弱な場合がある。Chrome / Firefox 推奨。
• 一部の API (動画記録設定など) は RX100M5A では未対応 (12 No Such Method)。 事前に getAvailableApiList で確認するのが安全。

ネットワーク的な注意

デフォルトで 127.0.0.1 にだけ bind しています。HOST=0.0.0.0 で公開する場合は 同一 LAN の誰でもカメラを操作・録画閲覧できる ことに注意してください。認証は ありません。自宅 LAN かつ信頼できる範囲でのみ晒すこと。

MCP サーバ (AI 撮影係)

Flask が立っている前提で、mcp_server/server.py が Claude Code / Claude Desktop 等の MCP クライアントに stdio で接続できるブリッジ になります。 カメラを「AI に渡せるツール」として公開する形:

ツール一覧:

カテゴリ	tool	説明
introspect	get_status	現状 (running/idle/available_apis/focus_status/exposure など)
introspect	reconnect	手動再接続トリガ
introspect	refresh_services	DD.xml 再取得 (本体側モード切替検知)
vision	get_liveview_frame	最新ライブビュー JPEG を Image で返す (AI が見る)
shoot	take_picture(save=True)	半押し → focusStatus 待ち → シャッター → postview を Image で返す + 保存
shoot	half_press(on)	半押し AF (位置は本体側で決まる)
shoot	zoom(direction, movement)	ズーム
exposure	set_iso, set_shutter, set_fnumber, set_exposure_compensation	露出
exposure	set_white_balance_auto, set_white_balance_kelvin(K)	WB
burst	start_burst / stop_burst	連写 (postview URL リスト返却)
bulb	start_bulb / stop_bulb	バルブ撮影
movie	start_movie_rec / stop_movie_rec	本体 SD への動画記録
content	list_camera_pictures / download_camera_picture	カメラ内画像 (avContent or DLNA 自動分岐)
storage	list_saved_pictures / get_saved_picture(name)	host downloads/

Claude Code に登録する

.mcp.json.example をコピーして絶対パスを埋めるか、claude mcp add で プロジェクトスコープに追加します。.mcp.json 自体は .gitignore 済み (ホスト依存)。

# Flask は別タームで起動しておく
SODSC_HOST=192.168.122.1 python run.py

# 方法 A: claude CLI で登録 (推奨)
claude mcp add so-dsc -s project \
  -e SODSC_API_BASE=http://127.0.0.1:5050 \
  -e PYTHONPATH=$(pwd) \
  -- $(pwd)/.venv/bin/python -m mcp_server.server

# 方法 B: 手動コピー
cp .mcp.json.example .mcp.json
# → .mcp.json を開き <ABSOLUTE_PATH_TO_REPO> を実パスに置換

SODSC_API_BASE を変えれば別ポートの Flask に向けられます (例: dev で 5051 を使ってる場合)。登録後、Claude Code を再起動するとツールが認識 されます (mcp__so-dsc__get_status など)。

使用感

Claude に 撮影係になって と頼むと:

• get_liveview_frame で構図を見る
• 必要なら set_iso/set_shutter/set_exposure_compensation で露出調整
• zoom で寄り/引き
• take_picture で撮る → postview を即見る
• 「もうちょい寄る?」「明るすぎ、EV-1」みたいな自己フィードバックが回る

AF 位置だけは指定不可 (RX100M5A 制限)。本体側で Focus Area を決めてお くか、half_press 中に画面中央へ被写体が来るよう人間 or AI が構図を寄 せる運用。

Disclaimer / 免責事項

This project is an independent, third-party reimplementation of the publicly-documented Camera Remote API that Sony released as a beta SDK (now end-of-life). It is not affiliated with, endorsed by, or sponsored by Sony Group Corporation, Sony Imaging Products & Solutions Inc., or any of their subsidiaries. No source code from any Sony application, SDK, or firmware is included or redistributed. The project does not bypass any authentication, DRM, or content-protection mechanism.

Trademarks "Sony", "PlayMemories", "Imaging Edge", "Creators' App", "Camera Remote API", "DSC", "RX100", and any associated logos are property of Sony Group Corporation. They are referenced here solely for compatibility documentation.

Use this software at your own risk. The MIT license below disclaims all warranties.

本リポジトリは Sony 公式の Camera Remote API ベータ SDK (現在 EOL) の 公開仕様 を参照したサードパーティ独自実装です。Sony Group Corporation および関連会社とは一切関係ありません。Sony 公式アプリ・SDK・ファーム ウェアのソースコードは含まれていません。認証・DRM・保護機構を回避する ものでもありません。商標 ("Sony"、"PlayMemories"、"Imaging Edge"、 "Creators' App"、"Camera Remote API"、"DSC"、"RX100" 等) はすべて Sony Group Corporation に帰属し、互換性を説明する目的でのみ言及しています。 本ソフトウェアは利用者の自己責任でお使いください。

License

MIT — see LICENSE.