Repository navigation
Releases
FH-DualSense-Enhanced R12
Enhanced R12 中文说明
Enhanced R12 改进 Xbox App 模式下的手柄按键响应,并集成实体 DualSense 隔离。
更新内容
- 手柄输入:改进蓝牙 ABXY 短按,以及使用键鼠后首次按键切回手柄的处理;虚拟 Xbox 360 手柄在短暂输入空档中保持连接。
- 一键安装并隔离:Xbox App 模式必须使用 HidHide。总览的“快速入口”显示安装进度、驱动与实体手柄隐藏状态。缺少驱动时,点击安装会下载并校验官方 HidHide 1.5.230 安装器,经 Windows UAC 批准后安装。已安装时不会重复下载。
- 自动配置:虚拟 Xbox 手柄就绪后,FHDS 自动放行自身、隐藏当前实体 DualSense,并在现有隐藏规则只涉及 DualSense 时开启 Device hiding,无需在官方配置界面手动勾选。已有其他设备规则或特殊反向配置时,FHDS 会提示检查。官方配置界面存在时仍可从快速入口打开。
- 输入保护与恢复:确认实体手柄已隐藏前,虚拟手柄只发送中立输入,软件内 Xbox App 游戏启动按钮保持禁用。FHDS 退出时清理自己添加的隐藏规则,保留用户原有规则;意外退出后的自有残留规则会在下次启动时清理。安装后可能需要重启 Windows,首次隐藏后可能需要重连手柄或重启游戏。
- 验收状态:蓝牙 ABXY 连按两次及 Xbox App 游戏内键鼠/手柄反复切换的效果仍需实体手柄与游戏实测。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R12.exe。EXE 已包含 Python 和应用运行依赖;Xbox App 所需的 HidHide 驱动按需安装。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R12;内置 EXE 更新只支持 Windows 独立版。
Linux 上若遇到 HID 权限不足,请按仓库中的 70-dualsense.rules 配置 udev 权限。
基本设置
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - Xbox App 版请在软件内选择
XBOX 版,并避免同时让 Steam Input 或 DS4Windows 接管手柄。 - Xbox App 模式请在总览的“快速入口”确认 HidHide 已安装且当前实体 DualSense 已隐藏。
Enhanced R12 English notes
Enhanced R12 improves controller button response in Xbox App mode and integrates physical DualSense isolation.
What's new
- Controller input: improves handling of short ABXY presses over Bluetooth and the first controller press after mouse or keyboard use. The virtual Xbox 360 controller stays connected through brief input gaps.
- One-click installation and isolation: Xbox App mode requires HidHide. Overview -> Quick access shows installation progress, driver status, and physical controller hiding status. When the driver is missing, Install downloads and verifies the official HidHide 1.5.230 installer, then installs it after Windows UAC approval. An existing installation is not downloaded again.
- Automatic configuration: once the virtual Xbox controller is ready, FHDS allows itself to see the device, hides the current physical DualSense, and enables Device hiding when existing hiding rules only target DualSense. No manual checkbox is needed in the official client. FHDS prompts for review if other devices or inverse configuration are present. The official client remains available from Quick access when installed.
- Input protection and recovery: until the physical controller is confirmed hidden, the virtual controller sends only neutral input and the in-app Xbox App game launch button stays disabled. FHDS removes only its own hiding rules on exit and preserves existing user rules; its rules left by an interrupted exit are cleaned up on the next launch. Installation may require a Windows restart; first-time hiding may require reconnecting the controller or restarting the game.
- Validation status: the double-tap ABXY and repeated mouse/controller switching symptoms still need testing with a physical controller in the Xbox App game.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R12.exe. It includes Python and the app's runtime dependencies; the HidHide driver required for Xbox App is installed on demand.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R12. Built-in EXE replacement is available only in the Windows standalone build.
On Linux, if HID access is denied, configure udev permissions with 70-dualsense.rules.
Basic setup
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - For Xbox App, select
Xbox Appinside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time. - In Xbox App mode, confirm in Overview -> Quick access that HidHide is installed and the current physical DualSense is hidden.
FH-DualSense-Enhanced R11
Enhanced R11 中文说明
Enhanced R11 重点改进 Xbox App 输入、触觉预览和本地诊断能力。
更新内容
- 手柄占用范围:FHDS 运行期间会持续使用当前实体 DualSense。切到桌面或其他游戏不会自动释放;其他游戏或手柄工具需要同一只 DualSense 时,请先退出 FHDS。
- Xbox App 输入升级:虚拟手柄可按最近主动输入在键鼠与 DualSense 之间热切换,保持玩家槽位并增强异常后的自动恢复。可选的 HidHide 1.7+ 会话隔离仍默认关闭,需要用户另行安装 HidHide,并先在官方 Configuration Client 中开启 Device hiding。
- 体感到摇杆:Xbox App 自定义映射新增 Steam Input 风格的 Camera 与 Deflection 模式,可选择左右摇杆、激活键、方向、死区和平滑。X360 没有原生陀螺仪通道,因此该功能只生成摇杆输出,并且必须同时开启自定义 Xbox 映射总开关和默认关闭的陀螺仪子开关。
- Haptics Lab 与本地诊断:系统与更新页新增默认折叠的 Haptics Lab 小卡片,可进行有界的扳机/握把场景预览;同时支持一键导出脱敏诊断 ZIP,诊断包只保存在本机,不会自动上传。
- 默认调教与鸣谢:新的
Default采用社区调教并默认开启 ABS;升级时旧Default会保留为Default before R11,Original保持上游风格。关于与许可证页新增“调教鸣谢:Bilibili 开心散仙”链接。 - 输入与稳定性:加强 Bluetooth 输入、虚拟手柄、Raw Input 热切换和异常后的恢复;Haptics Lab 会在有效游戏遥测到达时自动停止。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R11.exe。EXE 已包含 Python 和全部运行依赖。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R11;内置 EXE 更新只支持 Windows 独立版。
Linux 上若遇到 HID 权限不足,请按仓库中的 70-dualsense.rules 配置 udev 权限。
基本设置
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - Xbox App 版请在软件内选择
XBOX 版,并避免同时让 Steam Input 或 DS4Windows 接管手柄。
Enhanced R11 English notes
Enhanced R11 focuses on Xbox App input, haptic previews, and local diagnostics.
What's new
- Controller usage scope: FHDS continues using the selected physical DualSense while it is running. Switching to the desktop or another game does not release the controller; exit FHDS first when another game or controller tool needs the same DualSense.
- Xbox App input upgrades: the virtual controller can hand off between keyboard/mouse and DualSense according to the latest deliberate input, retain its player slot, and recover more reliably after transient failures. Optional HidHide 1.7+ session isolation remains off by default, requires a separate HidHide installation, and requires Device hiding to be enabled first in the official Configuration Client.
- Motion-to-stick mapping: Xbox App custom mapping adds Steam Input-style Camera and Deflection modes with stick, activation, direction, deadzone, and smoothing controls. X360 has no native gyro channel, so this feature produces stick output only and requires both the custom Xbox mapping master switch and its separate gyro switch, which is off by default.
- Haptics Lab and local diagnostics: a compact Haptics Lab card, collapsed by default under System and updates, provides bounded trigger/grip scene previews. One-click sanitized diagnostic ZIP export is also available; packages stay on the local computer and are never uploaded automatically.
- Default tuning and credit: the new community-tuned
Defaultenables ABS. Upgrades preserve the priorDefaultasDefault before R11, whileOriginalkeeps its upstream-style behavior. About and licenses now links the tuning credit for Bilibili 开心散仙. - Input and stability: recovery is strengthened across Bluetooth input, the virtual controller, and Raw Input hand-off. Haptics Lab also stops automatically when valid game telemetry arrives.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R11.exe. It includes Python and all runtime dependencies.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R11. Built-in EXE replacement is available only in the Windows standalone build.
On Linux, if HID access is denied, configure udev permissions with 70-dualsense.rules.
Basic setup
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - For Xbox App, select
Xbox Appinside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time.
FH-DualSense-Enhanced R10
Enhanced R10 中文说明
Enhanced R10 让油门阻力更容易完全关闭。
更新内容
- 油门末端硬墙独立控制:在“重压阻力”下方新增“油门末端硬墙”开关,默认关闭。关闭后,末端硬墙不再顶手;连续阻力仍由静止阻力和重压阻力设置决定,需要末端限位时也可以单独开启。
- 旧配置安全升级:现有 Profile 不会自动打开末端硬墙,原有油门阻力设置会继续保留。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R10.exe。EXE 已包含 Python 和全部运行依赖。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R10;内置 EXE 更新只支持 Windows 独立版。
Linux 上若遇到 HID 权限不足,请按仓库中的 70-dualsense.rules 配置 udev 权限。
基本设置
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - Xbox App 版请在软件内选择
XBOX 版,并避免同时让 Steam Input 或 DS4Windows 接管手柄。
Enhanced R10 English notes
Enhanced R10 makes throttle resistance easier to disable completely.
What's new
- Independent throttle end wall: a new
Throttle end wallswitch appears belowHeavy press resistanceand is off by default. Turning it off removes the end-stop resistance; the stationary and heavy-press settings still control continuous resistance, and the end wall can be enabled on its own when wanted. - Safe profile upgrade: existing profiles do not automatically enable the end wall, while their throttle-resistance settings remain in place.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R10.exe. It includes Python and all runtime dependencies.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R10. Built-in EXE replacement is available only in the Windows standalone build.
On Linux, if HID access is denied, configure udev permissions with 70-dualsense.rules.
Basic setup
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - For Xbox App, select
Xbox Appinside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time.
FH-DualSense-Enhanced R9
Enhanced R9 中文说明
Enhanced R9 新增自定义 XBOX 按键映射,并解决长期影响自动更新的可靠性问题。
更新内容
- 自定义 XBOX 按键映射:新增独立页面,可以修改 DualSense 数字按键到虚拟 Xbox 360 手柄的对应关系,包括触摸板左右点击。只有在“游戏平台”选择
XBOX 版时可以编辑;Steam 版请直接在 Steam 内修改映射。可以随时关闭自定义映射或一键恢复 Steam 默认映射。 - 从 R9 开始,自动更新更可靠:修复更新时误报“存在其他实例”、升级后文件名不正确、旧 EXE 或
.old遗留,以及失败后无法原地重试等问题。更新失败会尽量恢复原版本;检测到新版本时也会显示手动下载链接。 - 项目入口补全:
关于与许可证页面新增当前项目仓库链接。
R8 用户请先手动更新
R8 自带的旧更新程序无法在升级过程中使用 R9 的修复,因此 R8 → R9 仍可能更新失败。请从本发布页手动下载并启动一次 FH-DualSense-Enhanced-R9.exe;从 R9 开始,后续版本将使用新的更新流程。现有设置会继续保留。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R9.exe。EXE 已包含 Python 和全部运行依赖。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R9;内置 EXE 更新只支持 Windows 独立版。
Linux 上若遇到 HID 权限不足,请按仓库中的 70-dualsense.rules 配置 udev 权限。
基本设置
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - Xbox App 版请在软件内选择
XBOX 版,并避免同时让 Steam Input 或 DS4Windows 接管手柄。
Enhanced R9 English notes
Enhanced R9 adds custom Xbox button mapping and resolves long-running automatic update reliability problems.
What's new
- Custom Xbox button mapping: a new standalone page lets you remap DualSense digital buttons to the virtual Xbox 360 controller, including left and right touchpad clicks. Editing is available only when
Xbox Appis selected as the game platform; Steam users should change their mapping in Steam. Custom mapping can be disabled at any time or reset to the Steam defaults. - More reliable updates from R9 onward: fixes false “another instance is running” errors, incorrect filenames after upgrading, leftover old EXEs or
.oldfiles, and failures that could not be retried in place. Failed updates try to restore the previous version, and the update page now also shows a manual download link. - Project link: About & Licenses now links to the current project repository.
Important for R8 users
R8 ships with the older updater and cannot use the R9 fixes during the R8 → R9 handoff, so that automatic update may still fail. Manually download and launch FH-DualSense-Enhanced-R9.exe once from this release page. Future updates starting from R9 will use the corrected update flow. Existing settings remain in place.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R9.exe. It includes Python and all runtime dependencies.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R9. Built-in EXE replacement is available only in the Windows standalone build.
On Linux, if HID access is denied, configure udev permissions with 70-dualsense.rules.
Basic setup
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - For Xbox App, select
Xbox Appinside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time.
FH-DualSense-Enhanced R8
Enhanced R8 中文说明
Enhanced R8 重点修复扳机无法完全释放、红线提示偏早、界面文字裁切和旧版更新残留。
更新内容
- 扳机可以真正关闭:关闭
Brake stiffness或Throttle stiffness后,对应扳机不再在约 89% 行程留下硬阻力。新增启用自适应扳机输出总开关,可以立即释放 L2/R2,并保留已有子设置。 - 红线反馈更自然:燃油车会学习实际断油转速,默认提醒由
93%后移到95%;已自定义的时机和命名 Profile 不会被覆盖。R2 扳机键、握把和转速灯条保持同步。全部电动车不再输出红线震动,灯条仍会在接近极限时稳定变红。 - 界面排版修正:扳机与握把页面重新排布,说明文字在双列、窗口缩放和高 DPI 环境下不再被截断。
- 自动更新修正:连续从旧版升级时会恢复正确的
FH-DualSense-Enhanced-R8.exe文件名,并清理确认属于旧版本的 EXE、.old和校验文件;无关文件不会被删除。
Windows 独立 EXE(推荐)
下载 FH-DualSense-Enhanced-R8.exe。EXE 已包含 Python 和全部运行依赖。配套 .sha256 由内置更新器使用,手动启动 EXE 时不需要另外下载。
ZUV / Linux 备用方式
Windows 可使用 win_start.bat,Linux 可使用 linux_start.sh,也可以手动下载 FH-DualSense-Enhanced.zuv.py。Linux 独立文件为 FH-DualSense-Enhanced-R8;内置 EXE 更新只支持 Windows 独立版。
必要设置
- Steam 版保持 Steam Input 与 DualSense vibration 开启;Xbox App 版在软件内选择 Xbox App,不要同时让 Steam Input 或 DS4Windows 接管手柄。
- 在 Forza Horizon 中开启 Data Out,设置为
127.0.0.1:5300,并关闭游戏内振动。 - 若要完全释放 L2/R2,请关闭
启用自适应扳机输出;握把触觉需要在Grip haptics页面单独关闭。 - 收不到遥测时,请在防火墙中允许本程序和 UDP 5300。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R8 English notes
Enhanced R8 focuses on triggers that would not fully release, early redline warnings, clipped interface text, and leftovers from legacy updates.
What's new
- Trigger feedback can be fully disabled: after turning off
Brake stiffnessorThrottle stiffness, the corresponding trigger no longer keeps hard resistance around 89% travel. The newEnable adaptive trigger outputmaster switch releases L2/R2 immediately while preserving existing child settings. - More natural redline feedback: combustion cars learn their actual fuel-cut RPM, and the default warning moves later from
93%to95%. Custom timing and named profiles are preserved. R2, grip haptics, and the tachometer lightbar stay synchronized. Electric vehicles no longer produce redline vibration, while the lightbar still turns steadily red near the limit. - Layout fixes: the Trigger feedback and Grip haptics pages have been rearranged, and helper text no longer clips in two-column, resized, or high-DPI layouts.
- Updater fixes: repeated upgrades from older versions restore the correct
FH-DualSense-Enhanced-R8.exefilename and remove confirmed old-version EXEs,.oldfiles, and checksum files. Unrelated files are not deleted.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R8.exe. It includes Python and all runtime dependencies. The matching .sha256 is used by the built-in updater and is not required for manual launches.
ZUV / Linux fallback
Windows users may use win_start.bat, Linux users may use linux_start.sh, or either platform may download FH-DualSense-Enhanced.zuv.py manually. The standalone Linux asset is FH-DualSense-Enhanced-R8. Built-in EXE replacement is available only in the Windows standalone build.
Required settings
- On Steam, keep Steam Input and DualSense vibration enabled. For Xbox App, select Xbox App inside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the controller at the same time.
- Enable Forza Data Out at
127.0.0.1:5300and disable in-game vibration. - To release L2/R2 completely, disable
Enable adaptive trigger output; Grip haptics must be disabled separately. - If telemetry does not arrive, allow the app and UDP 5300 through Windows Firewall.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.
FH-DualSense-Enhanced R7
Enhanced R7 中文说明
Enhanced R7 相比上一稳定版 Enhanced R6,重点改进控制器连接真值、Bluetooth/Xbox App 输入可靠性、动态红线、高 DPI 显示和内置更新器。项目仍基于 Forza-Horizon-DualSense-Python 1.6.2,握把触觉参考 HorizonHaptics 1.3.0,Bluetooth HD haptics 协议参考 vDS 0.3.0-rc7 与 DS5Dongle。
控制器在线、USB/Bluetooth 传输方式、电量和充电状态现在只由完整有效的输入报告确认,不再把残留 HID handle 当成“已连接”。同一手柄的 USB/Bluetooth 拓扑会持续轻量检测并优先 USB;自动重连默认开启,“立即重新连接”也能恢复意外停止的 HID worker。Bluetooth 转 USB 会先等待 Windows 的 DualSense USB 音频端点就绪,再使用已验证的 R6 USB 音频生命周期接管握把。短暂 Bluetooth 信号波动不会再把当前连接永久降级为 compatible rumble;只有真实 0x36 构建、队列或 HID write 失败才会回退。当前交接设计下,拔掉 USB 可能使手柄关机,按 PS 键重新开机即可。
Xbox App 连接桥现在优先清空 Bluetooth HID 输入积压并只转发最新有效状态;同轮 0x36 已携带扳机键和灯效时会合并重复写入。100 ms 输入空档只发送一次中立状态并保留同一个虚拟 Xbox 360 Controller 与玩家槽位,不再因短时空档移除设备。物理 HID 与 ViGEm 会话遇到瞬时异常会按有界退避自动恢复,跨会话 runtime.log 可用于诊断长时间运行后不认手柄。
动态红线估计器会先预测车辆红线,再从同挡位多次确认的真实断油事件学习和修正阈值,同时排除换挡、离合和严重打滑。R2 扳机键红线、握把红线与转速灯条共用该结果,确认断油可立即强制灯条闪烁,改善仪表红区很宽、固定比例无法触发的车辆。配置页新增内置 Original,保留上游 1.6.2 扳机默认并启用 Enhanced 握把触觉;社区 Default 仍是默认选择,ABS 振动默认关闭。扳机反馈与握把触觉分成独立页面,灯效页不再显示握把设置。
Windows 界面现在在创建窗口前启用 Per-Monitor v2 DPI awareness,并按界面语言明确使用 Windows 系统 UI 字体与像素对齐的顶部状态框,改善 100%、125% 和 150% 缩放下的文字与边缘清晰度。长页面、响应式卡片和周期状态采用合并更新,减少最大化和跨页切换时的重复布局。FH6 实用功能现在会为 Xbox App 版自动读取本地磁盘的 .GamingRoot 并兼容默认 XboxGames,只检查游戏库根和直属目录,不扫描 WindowsApps 或全盘递归;精确验证失败时仍可手动选择游戏外层目录或直接 Content payload。内置更新器改为事务式并排安装:R7 以后使用规范版本文件名,不再创建 .exe.old;新版本健康启动后迁移现有快捷方式,清理同目录更旧的规范 EXE、对应 .old 和 .sha256,失败时保留仍被快捷方式引用的旧版本并支持启动恢复或回滚。
Windows 独立 EXE(推荐)
下载:FH-DualSense-Enhanced-R7.exe
EXE 已包含 Python 和全部依赖,不需要 BAT、ZUV、uv 或本机 Python。请把对应 .sha256 文件留在 Release 中供内置更新器校验;用户手动启动 EXE 时不需要同时下载 .sha256。
ZUV / Linux 备用方式
Windows 可下载 win_start.bat,Linux 可下载 linux_start.sh。启动器下载 FH-DualSense-Enhanced.zuv.py,Windows 启动器在需要时安装 uv。网络不稳定时,也可以手动下载 ZUV 本体并放到启动器旁边。Linux 独立文件为 FH-DualSense-Enhanced-R7;内置 EXE 更新只支持 Windows 冻结版本。
必要设置
Steam 版保持 Steam Input 与 DualSense vibration 开启;Xbox App 版在软件中选择 Xbox App,不要同时运行 Steam Input 或 DS4Windows 接管同一手柄。所有平台都要在 Forza Horizon 中开启 Data Out,IP 设为 127.0.0.1、端口设为 5300,并关闭游戏内振动,否则原生 rumble 会争用并掩盖本项目的握把反馈。收不到 UDP 时,请在防火墙中允许应用和 UDP 5300。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R7 English notes
Compared with the previous stable Enhanced R6, Enhanced R7 focuses on truthful controller state, Bluetooth/Xbox App input reliability, dynamic redline detection, high-DPI rendering, and transactional updates. It remains based on Forza-Horizon-DualSense-Python 1.6.2, with grip haptics informed by HorizonHaptics 1.3.0 and Bluetooth HD haptics informed by vDS 0.3.0-rc7 plus DS5Dongle.
Connected state, USB/Bluetooth transport, battery level, and charging state are now established only by complete valid input reports instead of a leftover HID handle. Lightweight topology monitoring follows the same controller across USB and Bluetooth and prefers USB. Automatic reconnect is enabled by default, and Reconnect Now can revive an unexpectedly stopped HID worker. Bluetooth-to-USB waits for the Windows DualSense USB audio endpoint before handing grip haptics to the verified R6 USB audio lifecycle. A temporary Bluetooth signal gap no longer permanently downgrades the connection to compatible rumble; fallback now requires an actual 0x36 build, queue, or HID write failure. With the current handover design, unplugging USB can power the controller off; press the PS button to reconnect.
Xbox App bridge mode now drains Bluetooth HID input backlog first and forwards only the newest valid state. Redundant writes are coalesced when the same 0x36 report already carries trigger and lighting state. A 100 ms input gap sends one neutral state but retains the same virtual Xbox 360 Controller and player slot instead of removing the device. Physical HID and ViGEm sessions recover from transient failures with bounded backoff, while a persistent runtime.log helps diagnose controllers that stop responding during long sessions.
The dynamic redline estimator starts with a prediction and then learns from repeated, same-gear limiter events while excluding shifts, clutch use, and severe wheel slip. R2 trigger redline feedback, grip redline feedback, and the tachometer lightbar share the learned result; a confirmed limiter event can immediately force the lightbar to flash. This improves cars whose wide dashboard red zone never worked with one fixed ratio. Profiles now include a built-in Original preset with upstream 1.6.2 trigger defaults plus Enhanced grip haptics. Community Default remains selected by default, with ABS vibration disabled. Trigger feedback and grip haptics have separate pages, and the lighting page no longer exposes grip settings.
Windows now enables Per-Monitor v2 DPI awareness before creating any UI and explicitly selects a Windows system UI font for each interface language, with pixel-aligned header status frames improving text and edge clarity at 100%, 125%, and 150% scaling. Long pages, responsive cards, and periodic status rendering coalesce repeated layout work to reduce maximize and navigation stalls. FH6 utilities now discover Xbox App flat-file installs from local-drive .GamingRoot markers and the default XboxGames folder. Discovery checks only the library root and direct children, never WindowsApps or a recursive full-drive scan; manual selection of either the outer game folder or direct Content payload remains the fallback. The updater now performs transactional side-by-side installation. R7 and later use canonical versioned filenames without creating .exe.old; after a healthy launch it migrates matching shortcuts and removes older canonical EXEs plus their matching .old and .sha256 files. Interrupted or partially failed updates retain needed old versions and can recover or roll back on the next start.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R7.exe. It includes Python and all runtime dependencies, so BAT, ZUV, uv, and a local Python installation are not required. The matching .sha256 remains attached to the Release for the built-in updater; users launching the EXE manually do not need to download it separately.
ZUV / Linux fallback
Windows users may download win_start.bat, and Linux users may download linux_start.sh. The launchers fetch FH-DualSense-Enhanced.zuv.py; the Windows launcher installs uv when required. On an unreliable connection, place a manually downloaded ZUV file next to the launcher. The standalone Linux asset is FH-DualSense-Enhanced-R7. Built-in executable replacement is available only in the frozen Windows build.
Required settings
For Steam, keep Steam Input and DualSense vibration enabled. For Xbox App, select Xbox App inside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the same controller. On every platform, enable Forza Data Out at 127.0.0.1:5300 and disable in-game vibration, otherwise native rumble can compete with or mask this project's grip feedback. Allow the app and UDP 5300 through Windows Firewall if packets do not arrive.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.
Full Changelog: R6...R7
FH-DualSense-Enhanced R6
Enhanced R6 中文说明
Enhanced R6 相比上一稳定版 Enhanced R5,把游戏平台扩展为 Steam 与 Xbox App,并继续支持 Forza Horizon 4、Forza Horizon 5 和 Forza Horizon 6。总览页会记住平台与游戏;Steam 通过对应 steam://run/<app-id> 启动,Xbox App 会优先使用 Windows 当前安装的 AUMID 直接启动,无法解析时打开对应 Xbox App 商品页供用户点击游玩。启动始终由用户点击触发,不会自动启动游戏或修改游戏设置。
Windows x64 版新增内置 DualSense 到 XInput 连接桥。Xbox App 模式把物理 DualSense 映射为虚拟 Xbox 360 Controller,不要求 DS4Windows,也不需要把 Xbox App 游戏加入 Steam。Steam 模式不会创建虚拟手柄。桥接包含 latest-state 转发、100 ms 中立保护和 3 s 移除保护,不接管游戏原生振动,也不安装或配置 HidHide。
若电脑缺少兼容的 ViGEmBus,软件会在用户确认后校验并打开内置的官方 ViGEmBus 1.22.0 安装程序,通过 Windows UAC 安装且不需要联网。已有兼容驱动会直接复用,不自动升级。ViGEmBus 与 ViGEmClient 已停止上游维护,本项目固定版本与 SHA-256,并允许随时切回 Steam 模式关闭连接桥。
独立的“FH6 实用功能”页面集中提供“中文文字 + 英文语音”和 DualSense 按键图标安装与还原,系统与更新页不再保留重复入口。两项功能均支持 Steam 与 Xbox App 安装目录:Steam 自动发现,Xbox App 由用户手动选择并保存。语言卡片分别显示当前游戏语言、实际显示语言和语音语言,无法验证的 Xbox App 语言会明确显示未知并要求额外确认,不会伪造结果。EXE 只内置一份 MOD 资源,安装前分别备份普通与 HiRes 原文件;写入失败会回滚,游戏运行时拒绝修改。感谢图标 MOD 作者 @hotline1337 授权并提供 MOD:Nexus Mods MOD 页面;游戏更新或验证文件后可能需要重新安装。
GUI 页面现在只挂载一次并通过 tkraise() 切换,避免每次导航都重新布局。总览只探测当前选择的 Steam 游戏,找到有效路径后停止探测;未找到时每 30 秒静默重试。按钮、平台选择器和 XInput 提示只在实际状态变化时重绘,默认平台保持 Steam。更新提醒点的黑色方块已修复,并完成 FH4/FH5/FH6 通用启动文案。Enhanced R6 仍基于 Forza-Horizon-DualSense-Python 1.6.2,触觉参考 HorizonHaptics 1.3.0,Bluetooth HD haptics 协议参考 vDS 0.3.0-rc7 与 DS5Dongle。
Windows 独立 EXE(推荐)
下载:FH-DualSense-Enhanced-R6.exe
EXE 已包含 Python 和全部依赖,不需要 BAT、ZUV、uv 或本机 Python。请把对应 .sha256 文件留在 Release 中供内置更新器校验;用户手动启动 EXE 时不需要同时下载 .sha256。
ZUV / Linux 备用方式
Windows 可下载 win_start.bat,Linux 可下载 linux_start.sh。启动器下载 FH-DualSense-Enhanced.zuv.py,Windows 启动器在需要时安装 uv。网络不稳定时,也可以手动下载 ZUV 本体并放到启动器旁边。Linux 独立文件为 FH-DualSense-Enhanced-R6;内置 EXE 更新只支持 Windows 冻结版本。
必要设置
Steam 版保持 Steam Input 与 DualSense vibration 开启;Xbox App 版在软件中选择 Xbox App,不要同时运行 Steam Input 或 DS4Windows 接管同一手柄。所有平台都要在 Forza Horizon 中开启 Data Out,IP 设为 127.0.0.1、端口设为 5300,并关闭游戏内振动,否则原生 rumble 会争用并掩盖本项目的握把反馈。收不到 UDP 时,请在防火墙中允许应用和 UDP 5300。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R6 English notes
Compared with the previous stable Enhanced R5, Enhanced R6 adds Steam and Xbox App platform workflows for Forza Horizon 4, Forza Horizon 5, and Forza Horizon 6. Overview remembers both selections. Steam uses the matching steam://run/<app-id> URI. Xbox App first attempts direct activation through the installed current-user AUMID, then falls back to the matching Xbox App product page so the user can press Play. Launch is always user initiated and never changes game settings.
Windows x64 now includes a DualSense-to-XInput bridge. Xbox App mode exposes the physical DualSense as a virtual Xbox 360 Controller without DS4Windows or adding the game to Steam. Steam mode creates no virtual target. Latest-state forwarding, a 100 ms neutral guard, and a 3 s target-removal guard prevent stale controls. The bridge does not capture native game rumble and does not install or configure HidHide.
If no compatible ViGEmBus is available, the app verifies and opens the bundled official ViGEmBus 1.22.0 installer only after confirmation. Windows UAC is shown and installation works offline. A compatible existing driver is reused without automatic upgrades. ViGEmBus and ViGEmClient are archived upstream, so this project fixes their versions and SHA-256 values and lets users disable the bridge by returning to Steam mode.
A dedicated FH6 Utilities page now contains the Chinese-text plus English-voice tool and FH6 DualSense icon installation and restore actions; System and Updates no longer duplicates them. Both utilities support Steam and Xbox App installations: Steam paths are discovered automatically, while Xbox App paths are selected and saved manually. The language card separately shows the current game, effective display, and voice languages. An Xbox App language that cannot be verified remains explicitly Unknown and requires extra confirmation instead of being invented. The EXE bundles one MOD archive, backs up the normal and HiRes originals separately, rolls back failed writes, and refuses changes while FH6 is running. Thanks to icon MOD author @hotline1337 for permission and the MOD: Nexus Mods MOD page. Game updates or file verification can require reinstallation.
GUI pages are mounted once and switched with tkraise() instead of being laid out again on every navigation. Overview discovers only the selected Steam game, stops after a valid path is found, and retries missing installs silently every 30 seconds. Buttons, selectors, and XInput hints redraw only when their presentation changes, while Steam remains the default platform. It fixes the black background behind the update notification dot and completes generic FH4/FH5/FH6 launch wording. Enhanced R6 remains based on Forza-Horizon-DualSense-Python 1.6.2, references HorizonHaptics 1.3.0, and uses vDS 0.3.0-rc7 plus DS5Dongle as Bluetooth HD haptics protocol references.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R6.exe. It includes Python and all runtime dependencies, so BAT, ZUV, uv, and a local Python installation are not required. The matching .sha256 remains attached to the Release for the built-in updater; users launching the EXE manually do not need to download it separately.
ZUV / Linux fallback
Windows users may download win_start.bat, and Linux users may download linux_start.sh. The launchers fetch FH-DualSense-Enhanced.zuv.py; the Windows launcher installs uv when required. On an unreliable connection, place a manually downloaded ZUV file next to the launcher. The standalone Linux asset is FH-DualSense-Enhanced-R6. Built-in executable replacement is available only in the frozen Windows build.
Required settings
For Steam, keep Steam Input and DualSense vibration enabled. For Xbox App, select Xbox App inside FH-DualSense-Enhanced and do not let Steam Input or DS4Windows claim the same controller. On every platform, enable Forza Data Out at 127.0.0.1:5300 and disable in-game vibration, otherwise native rumble can compete with or mask this project's grip feedback. Allow the app and UDP 5300 through Windows Firewall if packets do not arrive.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.
FH-DualSense-Enhanced R5
Enhanced R5 中文说明
Enhanced R5 相比上一稳定版 Enhanced R4,首先补全了总览页的实时状态链路。DualSense 卡片会区分 USB、Bluetooth、等待重连、关闭自动重连、DSX 单向 UDP 和后端错误;Forza 遥测卡片会区分等待数据、持续接收、数据中断和 UDP 绑定失败,并显示数据包来源、计数或最后接收时间。当前配置不再使用 - 占位,更新卡片会显示自动检查等待、检查关闭、检查中、已是最新、发现新版本、下载百分比、校验、待安装、安装中和错误。总览在页面创建后立即刷新,并在运行期间每秒刷新。
总览快速入口还新增“启动 FH6”按钮。程序会复用 Windows Steam FH6 安装发现,只有在确认安装有效且游戏尚未运行时才启用按钮;点击后通过 steam://run/2483190 交给 Steam 启动,以保留 Steam Input 和 Steam 启动上下文。按钮会区分正在查找、可以启动、正在启动、游戏运行中和未找到游戏,并在 FH6 已运行时保持禁用。程序不会自动启动游戏,也不会因为启动按钮而交换语言包或修改 Steam/游戏设置。
本版同时换用新的水墨风 DualSense 赛车图标。窗口标题栏、系统托盘、Windows 独立 EXE 与内置更新 Helper 共用同一套 PNG/多尺寸 ICO 资产。
“系统与更新”新增 Windows Steam 版 FH6 的“中文文字 + 英文语音”按钮功能。程序会从 Steam 注册表、libraryfolders.vdf、App ID 2483190 的 manifest、卸载信息和正在运行的 ForzaHorizon6.exe 查找安装目录,因此不依赖 C 盘;也可以手动选择安装目录。自动流程只会读取路径与状态,绝不会自动改名。
启用按钮只在确认 CHS.zip 为中文、EN.zip 为英文且 FH6 已关闭时可用,并要求 Steam 中的 FH6 语言为英文;无法读取 Steam 语言时会要求额外确认,明确检测到其他语言时会阻止操作。用户确认后,程序使用同目录临时名完成三步改名;还原按钮使用相同流程恢复原始名称。若进程中途失败会尝试回滚;若上次崩溃留下临时文件,只显示“需要修复”,必须再次点击按钮确认,程序不会自动修复或删除文件。Steam 更新或验证文件可能恢复原始语言包,之后重新扫描即可重新识别。
该功能只支持 Windows Steam 版 FH6,不复制语言包、不创建永久备份,也不在游戏运行时改名。使用前请至少运行一次 FH6,并在 Steam 属性中把游戏语言设为 English;修改语言包与 Forza Data Out、手柄触觉设置相互独立。
Enhanced R5 基于 Forza-Horizon-DualSense-Python 1.6.2,参考 HorizonHaptics 1.3.0,并使用 vDS 0.3.0-rc7 与 DS5Dongle 作为 Bluetooth HD haptics 协议参考。历史 Enhanced R1 使用 1.6.2.post1;从 Enhanced R2 起使用独立 R 版本体系。
Windows 独立 EXE(推荐)
下载:FH-DualSense-Enhanced-R5.exe
EXE 已包含 Python 和全部依赖,不需要 BAT、ZUV、uv 或本机 Python。请把对应 .sha256 文件留在 Release 中供内置更新器校验;用户手动启动 EXE 时不需要同时下载 .sha256。
ZUV / Linux 备用方式
Windows 可下载 win_start.bat,Linux 可下载 linux_start.sh。启动器下载 FH-DualSense-Enhanced.zuv.py,Windows 启动器在需要时安装 uv。网络不稳定时,也可以手动下载 ZUV 本体并放到启动器旁边。Linux 独立文件为 FH-DualSense-Enhanced-R5;内置 EXE 更新只支持 Windows 冻结版本。
必要设置
启用 Steam Input 和 DualSense vibration,然后在 Forza Horizon 中开启 Data Out,IP 设为 127.0.0.1、端口设为 5300。必须关闭 Forza 游戏内振动,否则原生 rumble 会争用并掩盖本项目的握把反馈。先启动 FH-DualSense-Enhanced,再启动游戏。收不到 UDP 时,请在防火墙中允许应用和 UDP 5300;只在短暂排查时关闭防火墙,随后立即恢复。本项目仍不会接管或完整复现菜单、CG 和上车过场的游戏原生振动。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R5 English notes
Compared with the previous stable Enhanced R4, Enhanced R5 completes the live status path on the Overview page. The DualSense card distinguishes USB, Bluetooth, reconnect waiting, disabled automatic reconnect, DSX fire-and-forget UDP, and backend errors. The Forza telemetry card distinguishes waiting, active reception, lost data, and UDP bind failure, with packet source, count, or last-received age. The active profile no longer falls back to a - placeholder. The update card covers the automatic-check wait, disabled checks, checking, up to date, available, download percentage, verification, ready, installing, and error states. Overview refreshes immediately after construction and once per second while the app runs.
Overview Quick Access also adds a Launch FH6 button. The app reuses Windows Steam FH6 install discovery and enables the button only when the install is valid and the game is not running. A click delegates launch to Steam through steam://run/2483190, preserving Steam Input and the Steam launch context. The button distinguishes discovery, ready, launching, running, and not-found states, and stays disabled while FH6 is running. The app never launches the game automatically, and the launch button does not swap language archives or change Steam/game settings.
This release also adopts a new ink-wash DualSense racing icon. The title bar, system tray, Windows standalone EXE, and bundled update Helper all use the same PNG and multi-size ICO assets.
System and Updates now includes an explicit button for Chinese text with English voice in the Windows Steam edition of FH6. Discovery checks Steam registry roots, libraryfolders.vdf, the App ID 2483190 manifest, uninstall metadata, and the full path of a running ForzaHorizon6.exe, so it does not assume the C drive. A manual install-folder choice is also available. Automatic work is read-only: the app never renames files without a button press and confirmation.
Enable is available only after CHS.zip is identified as Chinese, EN.zip as English, and FH6 is closed. The FH6 language in Steam must be English. An unknown Steam language requires an extra confirmation, while an explicitly different language blocks the operation. After confirmation, the app performs a three-step rename through a temporary name in the same directory; Restore uses the same process to return the original names. An in-process failure attempts rollback. A temporary file left by a previous crash is only reported as requiring repair, and repair still needs another button press and confirmation. Nothing is repaired or deleted automatically. A Steam update or file verification may restore the original archives, which a later rescan will detect.
This feature supports only the Windows Steam edition of FH6. It does not copy language archives, create a permanent backup, or rename anything while the game is running. Run FH6 at least once and set its Steam language to English before use. The language archive feature is independent from Forza Data Out and controller haptics settings.
Enhanced R5 is based on Forza-Horizon-DualSense-Python 1.6.2, references HorizonHaptics 1.3.0, and uses vDS 0.3.0-rc7 plus DS5Dongle as Bluetooth HD haptics protocol references. Historical Enhanced R1 used 1.6.2.post1; Enhanced R2 and later use the independent R-series version scheme.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R5.exe. It includes Python and all runtime dependencies, so BAT, ZUV, uv, and a local Python installation are not required. The matching .sha256 remains attached to the Release for the built-in updater; users launching the EXE manually do not need to download it separately.
ZUV / Linux fallback
Windows users may download win_start.bat, and Linux users may download linux_start.sh. The launchers fetch FH-DualSense-Enhanced.zuv.py; the Windows launcher installs uv when required. On an unreliable connection, place a manually downloaded ZUV file next to the launcher. The standalone Linux asset is FH-DualSense-Enhanced-R5. Built-in executable replacement is available only in the frozen Windows build.
Required settings
Keep Steam Input and DualSense vibration enabled. In Forza Horizon, enable Data Out, set IP to 127.0.0.1, and set port to 5300. You must disable in-game vibration in Forza, otherwise native rumble can compete with or mask this project's grip feedback. Start FH-DualSense-Enhanced before starting the game. If UDP packets do not arrive, allow the app and UDP 5300 through Windows Firewall. Disable the firewall only for brief diagnosis and restore it immediately afterward. The project still does not capture or fully reproduce native vibration from menus, cutscenes, or vehicle-entry sequences.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.
Full Changelog: R4...R5
FH-DualSense-Enhanced R4
Enhanced R4 中文说明
Enhanced R4 将界面统一为单一响应式桌面前端,只提供一个标准 Windows EXE。驾驶反馈页改为可滚动和响应式布局,以适应常见显示缩放与窗口尺寸;鼠标滚轮会跟随指针所在的滚动区域,嵌套页面到达边界后再交给外层滚动。“关于与许可证”已从握把触觉设置中移到日志下方的独立页面,原来没有实际功能的 R4 工作台已删除;窗口标题和 Windows 文件描述统一只使用 FH-DualSense-Enhanced。
Default 配置现在会自动保存并跨重启保留。关闭窗口、托盘退出、游戏关闭和更新重启都会使用同一退出流程:本会话修改过 Default 的手感参数时,可保存为默认填入 profile1、profile2 的命名配置后退出,也可直接退出或取消。恢复出厂设置会保留命名配置,重置全部手感和系统设置,并重新检测 Windows 显示语言。首次启动同样会自动选择支持的系统语言,之后仍可手动切换。
“系统与更新”旁会在发现、下载、校验、待安装或带 Release 信息的错误状态下显示白点;打开页面不会清除提醒。内置更新器只接受规范资产 FH-DualSense-Enhanced-R4.exe 及其 SHA-256,不再区分界面方案。
Windows 独立 EXE 可以在“系统与更新”中检查更新、选择后台下载、显示进度,并在用户确认后重启安装。更新助手等待主程序退出后替换文件,失败时恢复 .old。ZUV 和启动脚本继续作为网络或 Linux 环境下的备用安装方式,不再是 Windows EXE 更新的必要条件。发布流水线会使用跨平台生成器写入 SHA-256 sidecar,并在上传前重新计算和验证;缺失或不匹配会直接阻止 Release。
红线握把反馈改为非线性感知增益,默认强度提高到 220/255,low 比例提高到 45%,脉冲宽度提高到 70%,并加入可调的进入冲击。默认关闭 R2 扳机键红线、开启握把红线;握把默认仍在左侧。可选握把换挡冲击继续默认关闭。
新增的实验性扳机功能默认全部关闭,避免改变既有 Profile 手感:涡轮增压 R2 扳机键阻力、横纵向 G 力 R2 扳机键阻力、L2/R2 独立碰撞冲击、松开扳机键时的路面与减速带纹理。它们连同全部参数统一收纳在默认折叠的“实验性功能”中。转速灯条和挡位 Player LEDs 同样默认关闭,但保留在独立灯光页面。碰撞检测由扳机与握把共享同一个事件,避免同一遥测帧被重复判定。
USB 与 Bluetooth 继续使用同一套左右 PCM 语义。Bluetooth 0x36 路径增加 soft limiter 和带误差反馈的 int8 量化器,尽量保留低幅路面细节和叠加瞬态;灯条和 Player LEDs 同样写入 USB、Bluetooth 0x31 与 Bluetooth HD haptics 0x36 的状态区。如果当前连接拒绝 0x36,程序仍会回退到 compatible rumble,扳机不受影响。
Enhanced R4 基于 Forza-Horizon-DualSense-Python 1.6.2,参考 HorizonHaptics 1.3.0,并使用 vDS 0.3.0-rc7 与 DS5Dongle 作为 Bluetooth HD haptics 协议参考。历史 Enhanced R1 使用 1.6.2.post1;从 Enhanced R2 起使用独立 R 版本体系。
Windows 独立 EXE(推荐)
下载:FH-DualSense-Enhanced-R4.exe
EXE 已包含 Python 和全部依赖,不需要 BAT、ZUV、uv 或本机 Python。请把对应 .sha256 文件留在 Release 中供内置更新器校验;用户手动启动 EXE 时不需要同时下载 .sha256。
ZUV / Linux 备用方式
Windows 可下载 win_start.bat,Linux 可下载 linux_start.sh。启动器下载 FH-DualSense-Enhanced.zuv.py,Windows 启动器在需要时安装 uv。网络不稳定时,也可以手动下载 ZUV 本体并放到启动器旁边。Linux 独立文件为 FH-DualSense-Enhanced-R4;内置 EXE 更新只支持 Windows 冻结版本。
必要设置
启用 Steam Input 和 DualSense vibration,然后在 Forza Horizon 中开启 Data Out,IP 设为 127.0.0.1、端口设为 5300。必须关闭 Forza 游戏内振动,否则原生 rumble 会争用并掩盖本项目的握把反馈。先启动 FH-DualSense-Enhanced,再启动游戏。收不到 UDP 时,请在防火墙中允许应用和 UDP 5300;只在短暂排查时关闭防火墙,随后立即恢复。本项目仍不会接管或完整复现菜单、CG 和上车过场的游戏原生振动。
- 设置保存在程序旁边的
data/user_preferences.json,更新后继续保留。- Linux 启动器不会安装 udev 规则。HID 权限不足时,请下载
70-dualsense.rules,复制到/etc/udev/rules.d/,重新载入规则后连接手柄。- 预发布频道仍可通过
uv run FH-DualSense-Enhanced.zuv.py --prerelease跟踪。
Enhanced R4 English notes
Enhanced R4 consolidates the app into one responsive desktop interface and one canonical Windows executable. The Driving Feedback page now scrolls and rearranges responsively for common display scales and window sizes. Mouse-wheel input follows the scroll area under the pointer and transfers to the outer container only after an inner area reaches its boundary. About and licenses is now a dedicated page below Logs instead of being embedded in Grip Haptics. The non-functional R4 workspace card was removed, and the window title plus Windows file description now use only FH-DualSense-Enhanced.
The Default profile now autosaves and persists across restarts. Window close, tray quit, game close, and update restart share one exit path. If profile-scoped values in Default changed during the session, the app can save them as a named profile with profile1, profile2, and so on prefilled, or exit without creating a named profile. Factory reset preserves named profiles, resets profile and system settings, re-detects the Windows display language, and returns to Default. First launch also selects a supported system language automatically, while later manual language choices remain available.
A white update dot appears beside System and Updates while a release is available, downloading, verifying, ready to install, or associated with an update error. Opening the page does not dismiss it. The built-in updater accepts only the canonical FH-DualSense-Enhanced-R4.exe asset and its SHA-256 file. It supports background download, visible progress, user-confirmed restart installation, replacement by a separate helper after the main process exits, and .old rollback if replacement fails. ZUV remains optional for the standalone Windows EXE. The release pipeline now writes SHA-256 sidecars with a cross-platform generator and recomputes them before upload; a missing or mismatched sidecar blocks the Release.
Grip redline feedback now uses a nonlinear perceptual gain curve, with a default peak of 220/255, a 45% low-frequency ratio, a 70% pulse width, and an adjustable entry impact. R2-trigger redline feedback is disabled by default, grip redline feedback is enabled by default on the left grip, and the optional grip gear-shift thump remains disabled by default.
New experimental trigger effects are all disabled by default: turbo-boost R2-trigger resistance, lateral and longitudinal G-force R2-trigger resistance, independent L2/R2 collision jolts, and road or rumble-strip texture while a trigger is released. Their switches and tuning values are grouped under the collapsed Experimental features area. The tachometer lightbar and gear Player LEDs are also opt-in. Collision detection is shared by trigger and grip effects so the same telemetry frame is not classified twice.
USB and Bluetooth continue to use the same left/right PCM semantics. The Bluetooth 0x36 path adds a soft limiter and error-feedback int8 quantization to preserve more low-level road detail and layered transients. Lightbar and Player LED state is carried through USB, Bluetooth 0x31, and the Bluetooth HD haptics 0x36 state block. If a connection rejects 0x36, the app still falls back to compatible rumble without disabling adaptive triggers.
Enhanced R4 is based on Forza-Horizon-DualSense-Python 1.6.2, references HorizonHaptics 1.3.0, and uses vDS 0.3.0-rc7 plus DS5Dongle as Bluetooth HD haptics protocol references. Historical Enhanced R1 used 1.6.2.post1; Enhanced R2 and later use the independent R-series version scheme.
Windows standalone EXE (recommended)
Download FH-DualSense-Enhanced-R4.exe. It includes Python and all runtime dependencies, so BAT, ZUV, uv, and a local Python installation are not required. The matching .sha256 remains attached to the Release for the built-in updater; users launching the EXE manually do not need to download it separately.
ZUV / Linux fallback
Windows users may download win_start.bat, and Linux users may download linux_start.sh. The launchers fetch FH-DualSense-Enhanced.zuv.py; the Windows launcher installs uv when required. On an unreliable connection, place a manually downloaded ZUV file next to the launcher. The standalone Linux asset is FH-DualSense-Enhanced-R4. Built-in executable replacement is available only in the frozen Windows build.
Required settings
Keep Steam Input and DualSense vibration enabled. In Forza Horizon, enable Data Out, set IP to 127.0.0.1, and set port to 5300. You must disable in-game vibration in Forza, otherwise native rumble can compete with or mask this project's grip feedback. Start FH-DualSense-Enhanced before starting the game. If UDP packets do not arrive, allow the app and UDP 5300 through Windows Firewall. Disable the firewall only for brief diagnosis and restore it immediately afterward. The project still does not capture or fully reproduce native vibration from menus, cutscenes, or vehicle-entry sequences.
- Settings are stored in
data/user_preferences.jsonbeside the executable and remain across updates.- The Linux launcher does not install udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- The preview channel remains available through
uv run FH-DualSense-Enhanced.zuv.py --prerelease.
Full Changelog: R3...R4
FH-DualSense-Enhanced R3
Enhanced R3 中文说明
Enhanced R3 在 Enhanced R2 的动态扳机基础上加入按踏板状态路由的抓地力反馈:只踩刹车进入 L2,只踩油门进入 R2 扳机键,同时踩下时进入 R2 扳机键,L2 的 ABS 仍可独立介入。铺装、积水、泥土和碎石继续使用不同的材质频带。
R2 扳机键红线与握把红线现在拥有独立开关。默认关闭 R2 扳机键红线、开启握把红线;握把侧默认在左握把输出带 1.5 信号增益的断油脉冲。碰撞握把反馈加入方向包络;可选握把换挡冲击默认关闭,并使用独立的强度和持续时间普通设置。
USB 与 Bluetooth 现在共用同一套左右 PCM 波形。USB 继续使用手柄四声道音频端点;Bluetooth 通过 HID report 0x36 直接发送 3 kHz 双声道 HD haptics,保留路面纹理、发动机频率、红线波形和碰撞方向。如果当前连接拒绝 HD haptics,程序会自动回退到 compatible rumble,扳机不受影响。
游戏内原生振动可以保留菜单和过场反馈,但可能掩盖本项目的左右碰撞方向。验证方向或排查重复振动时,请关闭游戏内振动进行比较。本项目目前不会接管或完整复现游戏原生振动。
Enhanced R3 基于 Forza-Horizon-DualSense-Python 1.6.2,参考 HorizonHaptics 1.3.0,并使用 vDS 0.3.0-rc7 作为 Bluetooth HD haptics 协议参考。项目从 Enhanced R2 起使用独立 R 版本体系;历史 Enhanced R1 使用 1.6.2.post1。
Enhanced R3 highlights
Enhanced R3 routes dynamic traction feedback by pedal state while preserving the GT7-style L2 ABS wall, material-specific frequency bands, asymmetric EWMA smoothing, hysteresis, low-speed wheel rotation, and G-force damping introduced in Enhanced R2.
R2-trigger redline and grip redline now have independent switches. Trigger redline is off by default; grip redline is on by default on the left grip with a 1.5 signal gain. Directional collision haptics use a priority envelope. The optional grip gear-shift thump is off by default with independent normal settings for strength and duration.
USB and Bluetooth now share the same stereo PCM waveform renderer. USB uses the controller's four-channel audio endpoint; Bluetooth sends 3 kHz stereo HD haptics directly through HID report 0x36, preserving road texture, engine frequency, redline waveform, and collision direction. If the current connection rejects HD haptics, the app falls back to compatible rumble without interrupting adaptive triggers. The Bluetooth protocol implementation references vDS 0.3.0-rc7.
Recommended: launcher scripts
Download win_start.bat on Windows or linux_start.sh on Linux and run it. The launcher downloads the ZUV application bundle, and the Windows launcher installs uv when needed. uv then provisions the managed Python runtime. The published ZUV checks this fork's releases for updates.
If the automatic download is unreliable, use the manual ZUV fallback: download FH-DualSense-Enhanced.zuv.py from this Release, place it beside the launcher, and run the launcher again.
Standalone binaries
FH-DualSense-Enhanced-R3.exe for Windows contains Python and all application dependencies. It can be downloaded and run by itself without BAT, ZUV, uv, or a system Python installation. It does not self-update.
FH-DualSense-Enhanced-R3 is the standalone Linux build. It is built on Ubuntu, so older or substantially different distributions may need the ZUV launcher instead.
Required setup
Enable Steam Input and DualSense vibration, then enable Forza Horizon Data Out at 127.0.0.1:5300. Start FH-DualSense-Enhanced before launching the game. If no UDP packets arrive, allow the application and UDP 5300 through the firewall. Disable the firewall only for a short diagnostic comparison and turn it back on immediately. Disable in-game vibration when validating this project's directional collision output.
Heads up
- A manually downloaded ZUV can be kept next to the launcher script. The launcher copies it into its managed
appfolder.- Settings live in
data/user_preferences.jsonnext to the launcher and survive updates.- Linux: the launcher does not install system udev rules. If HID access is denied, download
70-dualsense.rules, copy it to/etc/udev/rules.d/, reload the rules, and reconnect the controller.- Prerelease channel: run
uv run FH-DualSense-Enhanced.zuv.py --prereleaseto track rolling test builds.
Full Changelog: R2...R3