FreeRDP JIS キーボードビルド（Apple Silicon M1〜M5向け）

Apple Silicon (arm64) 向けに、Mac日本語（JIS）キーボードでの \ および _ 入力を修正するパッチを適用してFreeRDPをソースからビルドします。FFmpeg、H.264ハードウェアアクセラレーション（VideoToolbox）、X11（xfreerdp）に対応しています。

---

結論

Ubuntu上のxrdpサーバーに対して利用可能なすべてのFreeRDPクライアントを広範囲にテストした結果、推奨クライアントはSDLクライアントではなく xfreerdp（X11クライアント）です。

クライアント比較

クライアント	速度	JIS \ / _	状態
xfreerdp（本ビルド）	高速	修正済み	推奨
sdl3-freerdp（本ビルド）	低速	修正済み	非推奨
sdl2-freerdp	低速	N/A	使わない
Macネイティブ（MacFreeRDP）	高速	不明	使わない
Homebrew xfreerdp	高速	不具合あり（keycode 0x65/0x66 不明）	JIS非対応

SDL3がxrdpで低速な理由

SDL3クライアントはすべてのビットマップ更新をCPU→Metalテクスチャとしてアップロードします。xrdpはレガシーRDPビットマップコーデック（planar/interleaved）を使用しており、多数の小さいタイル更新が発生するため、SDLのテクスチャパイプラインに過大な負荷がかかります。xfreerdpはX11/XQuartzを使用し、より直接的なレンダリングパスでこのコーデックを効率的に処理します。

有効なパッチ

JISキーボードの修正には2つのレベルでのパッチが必要でした。

1. SDLクライアント — client/SDL/SDL2/sdl_kbd.cpp
（元のアプローチ: moriya9n/FreeRDP-SDL-JISKBD）

SDL スキャンコード	修正前	修正後	キー
SDL_SCANCODE_INTERNATIONAL1	RDP_SCANCODE_UNKNOWN	RDP_SCANCODE_ABNT_C1	\ バックスラッシュ
SDL_SCANCODE_INTERNATIONAL3	RDP_SCANCODE_UNKNOWN	RDP_SCANCODE_BACKSLASH_JP	_ アンダースコア

2. X11クライアント — client/X11/xf_keyboard.c（本作業で発見した新規パッチ）

macOS + XQuartzでは、Apple JISキーコード 0x65（APPLE_VK_JIS_Yen）および 0x66（APPLE_VK_JIS_Underscore）がFreeRDPのApple VKテーブルに登録されておらず（0 にマップ）、Unknown key エラーが発生します。Apple keycodeテーブルの参照後に直接上書きすることで修正します。

// client/X11/xf_keyboard.c — load_map_from_xkbfile() 内の __APPLE__ フォールバックブロック
if (i == 0x65)
    xfc->X11_KEYCODE_TO_VIRTUAL_SCANCODE[i] = RDP_SCANCODE_BACKSLASH_JP; /* ¥/\ */
else if (i == 0x66)
    xfc->X11_KEYCODE_TO_VIRTUAL_SCANCODE[i] = RDP_SCANCODE_ABNT_C1;      /* _/ろ */

注意: 0x65 → BACKSLASH_JP、0x66 → ABNT_C1（直感とは逆順 — テストで確認済み）。

3. SDL3マウスクラッシュ修正 — client/SDL/SDL3/sdl_context.cpp

eventToPixelCoordinates() は、未登録のウィンドウIDでマウスイベントが届いた場合（macOSのフォーカス切り替え時）に false を返し、未処理の例外へ伝播していました。最初のウィンドウへのフォールバックで修正します。

// sdl_context.cpp — eventToPixelCoordinates()
auto w = getWindowForId(id);
if (!w)
    w = getFirstWindow(); // パッチ: macOSフォーカス問題時にフォールバック

---

ビルド手順

前提条件

brew install cmake ninja pkg-config openssl@3 pkcs11-helper cjson \
             ffmpeg sdl3 sdl3_ttf sdl2_ttf libusb openh264

Macクライアントには Xcode（コマンドラインツールのみ不可）が必要です。

sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer

クローンと安定タグのチェックアウト

git clone https://github.com/freerdp/freerdp ~/docker-claude/FreeRDP
cd ~/docker-claude/FreeRDP
git fetch --tags
git checkout 3.24.2   # または最新の安定タグ

パッチの適用

cd ~/docker-claude/FreeRDP

# SDLクライアントパッチ（A/B/C）
SDL_KBD=$(find client -name "sdl_kbd.cpp" | grep SDL2 | head -1)
sed -i.bak 's/ENTRY(SDL_SCANCODE_INTERNATIONAL1, RDP_SCANCODE_UNKNOWN)/ENTRY(SDL_SCANCODE_INTERNATIONAL1, RDP_SCANCODE_ABNT_C1)/' "$SDL_KBD"
sed -i.bak 's/ENTRY(SDL_SCANCODE_INTERNATIONAL3, RDP_SCANCODE_UNKNOWN)/ENTRY(SDL_SCANCODE_INTERNATIONAL3, RDP_SCANCODE_BACKSLASH_JP)/' "$SDL_KBD"
sed -i.bak 's/ENTRY(SDL_SCANCODE_RGUI, RDP_SCANCODE_RWIN)/ENTRY(SDL_SCANCODE_RGUI, RDP_SCANCODE_OEM_3)/' "$SDL_KBD"

# X11クライアントパッチ — client/X11/xf_keyboard.c に手動で適用
# 変更箇所の詳細は上記「有効なパッチ」セクションを参照

CMake設定

HBREW=$(brew --prefix)

cmake -S . -B build -G Ninja \
  -DCMAKE_BUILD_TYPE=Release \
  -DCMAKE_OSX_ARCHITECTURES=arm64 \
  -DWITH_CLIENT_SDL=ON \
  -DWITH_CLIENT_MAC=ON \
  -DWITH_X11=ON \
  -DWITH_FFMPEG=ON -DWITH_DSP_FFMPEG=ON -DWITH_VIDEO_FFMPEG=ON \
  -DWITH_OPENH264=ON \
  -DWITH_VAAPI=OFF \
  -DBUILD_TESTING=OFF -DCHANNEL_URBDRC=OFF \
  -DCMAKE_PREFIX_PATH="$HBREW" \
  -DOPENSSL_ROOT_DIR="$HBREW/opt/openssl@3" \
  "-DCMAKE_C_FLAGS=-I$HBREW/include/SDL2 -I$HBREW/include" \
  "-DCMAKE_CXX_FLAGS=-I$HBREW/include/SDL2 -I$HBREW/include"

主要フラグ:

• WITH_FFMPEG=ON + WITH_VIDEO_FFMPEG=ON: FFmpeg経由のH.264 → Apple VideoToolboxハードウェアアクセラレーション
• WITH_OPENH264=ON: OpenH264ソフトウェアフォールバック
• WITH_VAAPI=OFF: Linux専用。macOSでは非対象
• CMAKE_OSX_ARCHITECTURES=arm64: Apple Siliconネイティブバイナリ

ビルド

ninja -C build -j$(sysctl -n hw.ncpu)

インストール

mkdir -p ~/bin
cp build/client/X11/xfreerdp ~/bin/xfreerdp-jis

# ~/bin がPATHに未追加の場合（~/.zshrc に追記）
echo 'export PATH="$HOME/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

---

使用方法

xfreerdp-jis /v:HOST /u:USERNAME /p:PASSWORD \
  /kbd:layout:Japanese /smart-sizing \
  /sound /microphone /bpp:32

パッチ適用後のJISキーマッピング:

物理キー（JIS）	RDPセッションでの入力結果
¥ キー	\ バックスラッシュ
Shift + ¥ キー	| パイプ
Shift + ろ キー	_ アンダースコア

---

パッチの出典

元のSDLキーボードパッチ: MORIYA Seiji氏による moriya9n/FreeRDP-SDL-JISKBD（2023年7月）。
X11キーボードパッチ、SDL3マウス修正、ビルド手順: 本ビルド作業中に発見・開発（2025年3月）。

トラブルシューティング

症状	対処法
xcode-select: tool 'ibtool' requires Xcode	sudo xcode-select --switch /Applications/Xcode.app/Contents/Developer
Could NOT find OpenH264	brew install openh264
SDL_ttf.h not found	brew install sdl2_ttf を実行し、C/CXXフラグに -I$(brew --prefix)/include/SDL2 を追加
SDL3マウスのクリック時クラッシュ	sdl_context.cpp の getFirstWindow() フォールバックパッチを適用
freerdp_bitmap_decompress_planar failed	/gfx および /video フラグを削除（xrdp非対応）
Unknown key with X keycode 0x65/0x66	xf_keyboard.c にX11キーボードパッチを適用
$(brew --prefix) 使用後に zsh: command not found	事前に HBREW=$(brew --prefix) で変数に代入してから $HBREW を使用