還記得我上一篇那個又臭又長的 Rebocap Linux 文章 嗎?為了讓 Windows 版的 Rebocap 在 Wine 裡跑起來,又是補丁又是 bridge.exe 的,整整踩了七個坑(╯‵□′)╯︵┻━┻
結果文章發出去才九天,Rebocap 官方就直接出了 Linux 版(
明明之前還說不會出的說……hhhh
我昨天裝起來用了一下,跟之前的方案比起來,現在只要開官方的軟體跟 CLI 就好了,Bottles、setupapi 補丁、bridge.exe 這三層全部都不用了,開跟關都簡單超多 ww
不過官方的 Linux 版只附了 SteamVR 的驅動,而我這邊還是用 WiVRn + xrizer 在跑 VRChat 的,根本沒有 SteamVR,所以中間還是要靠 CLI 把追蹤器轉給 WiVRn。如果你本來就是用 SteamVR 的話,那直接裝官方版就好了,這篇可以不用看了(
開玩笑的,還是看一下嘛~

順帶一提,我把 repo 的名字也改了,從 rebocap-linux-vrchat-fbt 改成 TW527E/rebocap-linux-wivrn-fbt,這樣比較看得出來它是給 WiVRn 用的。然後 rebocap-wivrn-bridge、rebocap-wine、rebocap-linux-compat 這幾個 repo 也都補上了簡體、繁體、英文、日文四種語言的 README
就算你沒有 Rebocap 好了,你就只是好奇 Linux 上到底能不能玩 VR 全身追蹤,那也可以來看看我這篇又臭又長的文章唷~www
不過先說好,官方的 Linux 版現在還是 Preview 預覽版,官方自己也說這次主要是拿來觀察程式在 Linux 上穩不穩定的,所以遇到 bug 很正常,有問題可以去官方的 X 貼文或 Discord 回報
好啦,進入正題 w
跟之前的方案差在哪
先看一下資料是怎麼跑的,上面是這次的官方版,下面是之前的 Wine 版:
官方 Linux 版:
Quest 頭顯 → WiVRn → CLI ⇄ Rebocap(Linux 原生,:20480)
Rebocap 追蹤器 → Rebocap → CLI → SolarXR → WiVRn → xrizer → VRChat
之前的 Wine 版:
Quest 頭顯 → WiVRn → CLI ⇄ bridge.exe(Wine,:36850)⇄ Rebocap(Wine)
Rebocap 追蹤器 → Rebocap → bridge.exe → CLI → SolarXR → WiVRn → xrizer → VRChat
之前 Rebocap 跑在 Bottles 的 Wine 裡面,它只會開一條 named pipe,所以要靠 bridge.exe 在 Wine 裡把 pipe 轉成 TCP,Linux 這邊的 CLI 才接得到。而官方的 Linux 版自己就會在 127.0.0.1:20480 監聽,CLI 直接連上去就好了,中間那一大坨 Wine 的東西全部可以拿掉
然後之前接收器要靠 Wine 的 COM 埠加上 setupapi 補丁才認得到,現在官方程式是直接用 USB 去抓接收器的,所以這個也不用管了
剩下的 CLI 還是跟之前一樣,負責在 WiVRn 跟 Rebocap 中間來回轉送:把頭顯的頭部姿勢送給 Rebocap,再把追蹤器的姿勢用 SolarXR 發布給 WiVRn,最後 xrizer 再轉給 VRChat
不過這次我用的是自己 fork 的 TW527E/rebocap-wivrn-bridge,不是原版的 akazdayo/rebocap-wivrn-bridge。我在裡面做了三件事:加上官方 Linux 版的支援(用 --bridge 127.0.0.1:20480 連),然後拿掉追蹤器轉送時兩段 10 ms 的輪詢等待,還有修正用 WayVR 這類工具拖動遊玩區之後,追蹤器會偏離身體的問題
延遲有差嗎
老實說,兩個方案在進 CLI 之前的差別很小。官方版少了 Wine 的 named pipe、bridge.exe 的輪詢跟 Wine 的序列埠模擬,大概只省下 1~3 ms 而已w
真正差比較多的是 CLI 本身。原版 CLI 裡追蹤器的姿勢要在兩個 10 ms 的輪詢迴圈裡排隊,平均會多約 10 ms,最多大概 20 ms,而且更新間隔還會忽長忽短。我的 fork 改成一收到就馬上送給 WiVRn,所以不管你用哪個方案,都建議換成這個 fork 的 CLI
我的環境
系統是 Arch Linux(Omarchy,Hyprland),顯卡是 NVIDIA RTX 3070,頭顯是 Quest 2,用 WiVRn 26.9 加上 xrizer 0.6 在跑 VRChat,WiFi 跟 USB 都可以連
Rebocap 是官方的 Linux Preview 0.1(安裝檔是 rebocap-linux-preview-0.1-1.run),追蹤器韌體是 v17。平常綁 10 點:腰、胸、雙大腿、雙小腿、雙腳、雙上臂
第一步,安裝官方 Linux 版 Rebocap
先到官方文件的 軟體下載安裝 頁面,切到 Linux 分頁,點擊下載 Rebocap Linux Preview 0.1

然後在安裝檔所在的資料夾打開終端機,給它執行權限再跑起來:
chmod +x rebocap-linux-preview-*.run
./rebocap-linux-preview-*.run
照著提示裝完就好,預設會裝在 ~/.local/opt/rebocap。裝好之後從應用程式選單開 Rebocap,或是直接執行 ~/.local/opt/rebocap/rebocap-ui 也可以





第二步,給接收器權限
這步一定要做!官方自己也說沒設好的話接收器會連不上,日誌裡會一直跳 state -3
好在官方有附一個腳本,它會寫一條 udev 規則到 /etc/udev/rules.d/70-rebocap.rules,再把你加進 dialout、uucp、plugdev 其中一個群組(Arch 的話是 uucp):
sudo bash ~/.local/opt/rebocap/linux/install_linux_permissions.sh --install --user "$USER"
跑完之後記得重新登入,再把接收器拔掉重插一次

第三步,更新韌體
開 Rebocap 之後,如果有跳出要更新追蹤器韌體,就照著更新。Linux Preview 0.1 支援的追蹤器韌體是 V16、V17,接收器是 V6、V7、V8,我的追蹤器本來是 v15,升到 v17 之後感覺有比較穩

更新的時候不要拔接收器,也不要關程式。官方還特別說了不要同時更新追蹤器跟接收器,一個一個來
然後接收器韌體要特別注意,V8 把傳統的 CDC 序列埠拿掉了,改成 vendor 模式,官方說升上去之後就只有最新版的軟體認得到,要用舊版軟體就只能把韌體降回來。對官方 Linux 版來說 V7、V8 都沒差,但我上一篇的 Wine 方案整條路都是靠 /dev/ttyACM* 這個序列埠在跑的,所以接收器一升到 V8,Wine 方案就接不上了(
我自己的接收器現在還是 V7。如果你想留著 Wine 版當備案,更新的時候先只更新追蹤器就好,韌體更新視窗裡接收器跟追蹤器是分開更新的
第四步,不要裝官方的 SteamVR 驅動
官方版有附一個 SteamVR 驅動(在 data/rebocap_driver),但我們沒有要用 SteamVR,所以不要裝
而且 20480 這個埠同一時間只收一個連線,SteamVR 驅動佔著的話,CLI 就連不上去了
第五步,編譯 CLI
這邊要用我 fork 的版本,原版的不支援官方 Linux 版的 20480:
sudo pacman -S rust openxr pkgconf
git clone https://github.com/TW527E/rebocap-wivrn-bridge ~/Projects/rebocap-wivrn-bridge
cd ~/Projects/rebocap-wivrn-bridge && cargo build --release
那如果你之前照我上一篇裝過,舊的 CLI 應該是在 ~/Downloads/rebocap-wivrn-bridge,而且是 akazdayo 的原版。啟動腳本會優先用跟它自己放在同一層的那份 CLI,所以最簡單的做法就是把舊的刪掉,在同一個位置重新 clone 我的 fork 再編譯一次
第六步,裝啟動腳本
git clone https://github.com/TW527E/rebocap-linux-wivrn-fbt ~/Projects/rebocap-linux-wivrn-fbt
ln -s ~/Projects/rebocap-linux-wivrn-fbt/scripts/rebocap-fbt ~/.local/bin/rebocap-fbt
腳本會自己判斷你用的是哪個方案:20480 有在監聽就當作官方 Linux 版,沒有的話再去找 36850 的 bridge.exe。CLI 也會自動找,順序是 REBOCAP_CLI、PATH、跟這個 repo 放在同一層的 rebocap-wivrn-bridge,再來是 ~/Projects、~/Downloads、~/src、~/ 底下的 rebocap-wivrn-bridge
如果你的路徑或埠號跟我不一樣,可以用 REBOCAP_CLI、REBOCAP_NATIVE_PORT(預設 20480)、REBOCAP_WINE_PORT(預設 36850)這些環境變數蓋掉
之前裝過舊版腳本的人,因為 GitHub 會自動幫改名的 repo 轉址,所以直接在舊的資料夾裡 git pull 就可以更新了,symlink 也不用重做。想把網址也改掉的話,再跑一次:
git remote set-url origin https://github.com/TW527E/rebocap-linux-wivrn-fbt
對了,右搖桿按下也能跳的那個綁定產生器也還在,用法跟上一篇一樣,需要的話去那篇看就好了
第七步,改用 rebocap-launch 開 Rebocap
如果你跟我一樣是用 Omarchy,從應用程式選單(Super+Space)開 Rebocap 的話,它會在視窗出現一秒之後自己關掉(
從終端機開卻又完全正常,搞了半天才找到原因,詳細的放在後面的踩坑那段
所以我在 repo 裡多放了一個 rebocap-launch,用它來開 Rebocap 就不會被關掉了。先把它連到 ~/.local/bin,再把 Rebocap 的 desktop 檔改成用它來開:
ln -s ~/Projects/rebocap-linux-wivrn-fbt/scripts/rebocap-launch ~/.local/bin/rebocap-launch
sed -i "s|^Exec=.*|Exec=$HOME/.local/bin/rebocap-launch|" ~/.local/share/applications/rebocap.desktop
腳本裡會順便設定 REBOCAP_NO_DESKTOP_INTEGRATION=1,因為 Rebocap 每次啟動都會重寫自己的 rebocap.desktop,把 Exec= 改回原本的樣子,不關掉的話你剛改的就白改了ww
Rebocap 不是裝在 ~/.local/opt/rebocap 的話,用 REBOCAP_APP 指定 rebocap-ui 的路徑就好。其他桌面從選單開沒問題的話這步可以跳過,不過裝了也不會怎樣,腳本只有在偵測到限制的時候才會繞路
日常怎麼玩
不玩全追的話就照平常的方式,開 WiVRn → 頭顯連線 → 開 VRChat,Rebocap 跟腳本都不用開
要玩全身追蹤的話,順序很重要!
首先開 WiVRn(wivrn-dashboard),確認伺服器有在跑,這時候頭顯先不要連。然後開官方的 Rebocap,就這樣,不用再先開 Bottles 再開 bridge.exe 了ww
接著在終端機跑腳本:
rebocap-fbt # 10 點(預設):腰、胸、雙大腿、雙小腿、雙腳、雙上臂
rebocap-fbt 12 # 12 點:10 點再加雙前臂
rebocap-fbt 6 # 6 點
rebocap-fbt 10 --usb # 準備好後自動用 USB 連頭顯
rebocap-fbt --native # 強制用官方 Linux 版(--wine 是強制用 Wine 版)
開頭會印出現在用的是哪個方案,用官方版的話會寫 模式:官方 Linux 版 Rebocap(127.0.0.1:20480)

等到印出「SolarXR 準備好了」(也會跳桌面通知)之後,再連頭顯。然後在 Rebocap 切到 VR 模式,戴著頭顯校準

最後從 Steam 開 VRChat,在 快捷選單(Quick Menu) 點擊 校準全身追蹤(Calibrate FBT) 就可以了~
腳本跑起來之後一樣會幫你檢查部位:
有資料的部位:0 1 2 3 4 5 6 7 9 10
⚠ 已發布但沒有資料:…
⚠ 有資料但沒有發布:…
只要出現 ⚠,就代表你給的部位參數跟實際綁的追蹤器對不上,要去改部位參數。部位編號跟 USB 連線的細節跟上一篇一樣,這邊就不重複了
玩完要結束的時候,在腳本的終端機按 Ctrl+C 關掉 CLI,再把 Rebocap 的視窗關掉就好了,WiVRn 照平常的方式處理。之前還要用 bridge.quit 讓 bridge 自己退出、還不能從主機 kill Wine 程序的那些麻煩事,現在全部都沒有了 (❁´◡`❁)
還有一個很重要的跟以前一樣:重啟 CLI 或換了部位之後,頭顯要重新連線,VRChat 也要重開。因為 WiVRn 只有在頭顯連線的那一刻才會讀追蹤器清單
踩過的坑
這次的坑少很多了,畢竟 Wine 那一層整個不見了,上一篇那七個坑基本上都不會再遇到ww
腳本說找不到接收器,但 Rebocap 明明認得到
官方版跑起來的時候,會把接收器從 cdc_acm 卸下來,直接用 USB 去存取,所以 /dev/ttyACM* 跟 /dev/serial/by-id/... 會直接消失。我舊版的腳本就是去找這個檔案的,結果就一直說接收器沒插(
現在腳本已經改成直接找 USB 裝置 248a:8002 了,更新一下就好
從選單開 Rebocap,一秒後就自己關掉
這個是我在 Omarchy 上遇到的,從應用程式選單開 Rebocap,視窗出現大概一秒就自己關掉了,沒有當機紀錄,日誌就停在 [linux-rt] realtime=ok,但從終端機開又完全正常(
原因是 Rebocap 會把接收器的執行緒設成即時排程(SCHED_FIFO,透過 pkexec 呼叫官方的 rebocap-set-rt)。而 Omarchy 的選單是跑在 Quickshell 裡的,Quickshell 的 RLIMIT_RTTIME(即時執行緒能用的 CPU 時間上限)是 0,從選單開的程式全部都會繼承這個值
所以執行緒一變成即時就馬上「超時」,核心送出 SIGXCPU,Rebocap 收到之後就很乖地自己結束了hhhh
而且硬上限是 0 的話,程式自己是調不回來的,所以只能繞開。rebocap-launch 會先檢查這個上限,不是 unlimited 的話,就改用 systemd-run --user 從 systemd 的使用者管理員來開 Rebocap,並把上限設成無限
想看某個程序的上限的話,可以跑:
grep 'realtime timeout' /proc/<PID>/limits
改了 rebocap.desktop,下次又變回去了
Rebocap 每次啟動都會重寫自己的 desktop 檔,用環境變數 REBOCAP_NO_DESKTOP_INTEGRATION=1 就可以關掉,rebocap-launch 已經幫你設好了
CLI 連不上 20480
20480 這個埠同一時間只收一個連線,如果有開著官方的 SteamVR 驅動,或是你不小心開了兩個 CLI,後面那個就連不上去。把 SteamVR 或另一個 CLI 關掉就好
CLI 連上了,但一直沒有資料
檢查一下 Rebocap 是不是還沒切 VR 模式,或是正在更新韌體。更新韌體的時候它是不會送資料的,等更新完、切 VR 模式校準之後就會有了
log 裡一直出現 Wine pipe、bridge.exe
明明用的是官方 Linux 版,CLI 的 log 還是會出現 Wine pipe、bridge.exe 這些字,這只是沿用原版的寫法而已,忽略就好了hhhh
其他跟上一篇一樣的小坑
CLI 噴 Failed to connect to monado service process 的話,是 WiVRn 伺服器沒在跑。dashboard 開著不代表伺服器開著,要在 dashboard 點擊「啟動伺服器」
CLI 顯示 invalid SolarXR frame 加上一堆用法說明的話,檢查一下部位參數裡是不是混了全形標點(例如 12。),只能用半形數字跟逗號
用 WayVR 這類工具拖動遊玩區之後,追蹤器如果偏離身體,先確認你用的是我 fork 的 CLI,再看 log 裡有沒有 libmonado unavailable,有的話就去確認 WiVRn 的 runtime JSON 裡有沒有 MND_libmonado_path
那之前的 Wine 方案呢
還在,沒有刪掉。rebocap-fbt 兩種方案都還是支援的,rebocap-wine 跟 rebocap-linux-compat 也都留著,要是官方版在你的電腦上跑不起來,還是可以照 上一篇 的方法用 Wine 跑
不過除非官方版真的不能用,不然我是不推薦啦。少了 Wine、裝丁跟 bridge.exe 三層,開跟關都簡單太多了,而且韌體也可以直接用官方版更新,不用再擔心在 Wine 裡更新會不會出事了
對了,前面說過的接收器韌體 V8 要注意一下,升上去之後 Wine 方案就接不上了。repo 的 README 裡有寫幾個在 V8 上繼續用 Wine 方案的思路(降回 V7、在 Wine 裡跑支援 V8 的新版 Windows Rebocap、或是自己寫一個 USB 轉序列埠的程式),不過我都還沒做也沒測,有興趣的人可以試試看,修好了歡迎發 PR ~
最後
好啦~以上就是用官方 Linux 版 Rebocap 在 Linux 上玩 VRChat 全身追蹤的整個流程了!現在日常就是開 WiVRn、開 Rebocap、跑一行 rebocap-fbt,然後就可以在 VRChat 裡動腳了ww
說真的,上一篇花了那麼多時間在 Wine 裡面跟 named pipe 搏鬥,結果九天後官方直接出 Linux 版,心情有點複雜(
不過能不用 Wine 終究還是好事啦,感謝 Rebocap 官方~
感謝你把這整篇又臭又長的文章看完~(❁´◡`❁) 如果你也有在 Linux 上用 Rebocap,或是照著這篇接起來了(或是接不起來),快給我在下面留言告訴我啊!!!!



