Getting Started

Get Started：下載、設定與第一次啟動

本頁是一般使用者的完整第一次啟動流程。若還不確定自己要使用哪些功能，先看 Onboarding。

1. 選擇下載版本

請從 v1.8 Release 下載與用途相符的檔案：

Release artifact	適用情境
FH6-HorizonTuner-Full-Installer.exe	安裝完整 Full 版本；也作為 Full OTA 更新 payload
FH6-HorizonTuner-Lite-Installer.exe	安裝精簡 Lite 版本；也作為 Lite OTA 更新 payload
FH6-HorizonTuner-Full-Portable.exe	不需安裝的完整可攜版
FH6-HorizonTuner-Lite-Portable.exe	不需安裝的精簡可攜版
FH6-HorizonTuner-Portable-Bundle.zip	同時包含 Full 與 Lite portable executable 的便利壓縮包
FH6-HorizonTuner-Full-Linux-x86_64.AppImage	Linux x86_64 Full，無 HUD／原生音訊媒體；沒有 Linux Lite

Full 與 Lite Installer 是彼此獨立的選項，不需要先安裝另一個版本。手動執行 Installer 或 Portable 時不需要自行下載 sidecar；backend 已嵌入 Tauri host。

Release artifact 名稱可能隨版本調整；若本頁與 Release 頁面不一致，以該版本 Release 內容為準。

2. 選擇安裝或 Portable

Installer

1. 執行對應的 Full 或 Lite Installer。
2. 依 Windows 安裝精靈完成安裝。
3. 從開始選單或安裝目錄啟動。

Portable

1. 將 EXE 或 Portable Bundle 解壓縮到你有寫入權限的資料夾。
2. 建議不要放在需要系統管理員權限的目錄。
3. 直接執行 Full 或 Lite Portable EXE。

v1.8 使用 Rust backend、MCP 與 Agent CLI，產品執行不需要 Python；Python 僅保留給選用維護／發行工具。 設定、Session、tuning 與自訂 HUD 請先備份再升級。

Linux 與 Android

Linux AppImage 需相容 WebKitGTK／GTK 與圖形環境；可使用 FUSE 或 AppImage extraction 模式。只提供 x86_64 Full no-HUD，不提供 macOS、Linux ARM、DEB/RPM 或 Linux Lite。安裝與資料路徑請看 跨平台指南。

Android Companion 為 Beta，v1.8 Release 沒有 APK，需依 Companion 指南 從原始碼建置。它透過 LAN 配對或 USB/ADB 使用主機資料，不取代主機 backend；原生主題／裝置驗收限制仍保留。

3. 在遊戲中開啟 Data Out

在 Forza Horizon 6 中：

1. 開啟遊戲設定。
2. 找到 HUD / Audio / Telemetry 相關設定中的 Data Out。
3. 將 Data Out 設為 ON。
4. Data Out IP Address 填入 127.0.0.1。
5. Data Out Port 填入 8000。
6. 若使用雙設備測試，IP 要填執行 FH6-HorizonTuner 的電腦區域網路 IP。

不同遊戲版本的設定分類名稱可能略有不同；重點是 Data Out 啟用、IP 指向工具主機、UDP port 與工具設定一致。

4. 啟動並確認 telemetry

啟動 Full 或 Lite 後：

1. 等待 backend / sidecar ready。
2. 開啟 Live 工作區的 Telemetry Dashboard。
3. 確認 Navigation 的 Data Out health 不再顯示 disconnected。
4. 在遊戲中行駛，確認速度、RPM、檔位或踏板資料會變化。
5. 若只看到靜態畫面，依 Telemetry 排錯 的順序檢查，不要重複開啟多個 backend。

開發模式的預設通道為：

通道	預設值
Forza Data Out telemetry	UDP 127.0.0.1:8000
REST / WebSocket	http://127.0.0.1:8001
Raw telemetry forwarding	UDP 127.0.0.1:5300（啟用後才使用）

Release Build 會優先使用 HTTP 8001；若被占用，會改用可用的動態 port。實際 port 會寫入 logs/web_port.txt，也會在 Settings 的 MCP 卡片顯示。

5. Full 與 Lite 的差異

Windows Full 的工作區為 Live、Tune、Sessions、HUD；Lite 為 Live、HUD。Settings、Appearance、Diagnostics、About 位於應用程式選單。下表的 HUD 指 Windows 版本；Linux Full 沒有 HUD。

功能	Full	Lite
Telemetry Dashboard	✓	✓
HUD Overlay	✓	✓
Settings	✓	✓
Tuning Workbench	✓	—
Car Parameters / Dyno	✓	—
Drag Test	✓	—
Post-Race Analysis / MoTeC	✓	—

Lite 與 Full 共用 telemetry/backend 生命週期和 HUD 能力，適合只需要儀表與即時 dashboard 的使用者。

6. 第一次建議設定

第一次使用建議依這個順序：

1. 在 Settings 選擇語言與一般單位系統。
2. 確認 Telemetry Port 為 8000。
3. 先不要開啟 telemetry forwarding，除非確實要把 raw packet 傳給 SimHub 或其他工具。
4. 若要使用 Full 的調校流程，先建立或確認 車輛參數。
5. 若只想看 HUD，先使用內建樣式，再調整 HUD Overlay 的尺度與元素。
6. 若要記錄跑圈，確認 Race Recording 已在 Settings 開啟，再閱讀 賽後分析。

7. 第一次遇到問題的處理順序

依序確認：

1. 遊戲 Data Out 是否真的為 ON。
2. 遊戲 IP 是否指向正確的工具主機。
3. 遊戲 Data Out port 與 Settings Telemetry Port 是否相同。
4. 是否有另一個程式占用 UDP 8000。
5. backend 是否 ready，前端是否連到實際 HTTP port。
6. 若是 Release Build，查看 logs/web_port.txt 與 Settings MCP 卡片。
7. 最後才重新啟動程式；不要同時開多個 Full/Lite backend。

詳細排錯請見 Troubleshooting。

English

Use the published v1.8 Windows Full/Lite installers or portable executables, or Linux x86_64 Full no-HUD AppImage. Android Companion is source-build Beta; no APK is attached to v1.8. Enable Data Out to the receiving host on UDP 8000 (127.0.0.1 only on the same computer). The product runtime is Rust and requires no Python. Full has Live, Tune, Sessions and HUD workspaces; Lite has Live and HUD. Settings is in the app menu; update controls are inside Settings. Use the actual HTTP/MCP port shown by the app.

日本語

v1.8 は Windows Full/Lite と Linux x86_64 Full no-HUD AppImage を提供します。Android Companion はソースビルド Beta で APK は同梱されません。Data Out の送信先は受信 PC、UDP 8000 です。同一 PC の場合だけ 127.0.0.1 を使用します。Rust runtime に Python は不要です。Full は Live/Tune/Sessions/HUD、Lite は Live/HUD を持ち、設定はアプリメニューから開きます。