[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"project-81366":3},{"id":4,"name":5,"fullName":6,"owner":7,"repo":5,"description":8,"homepage":8,"htmlUrl":8,"language":9,"languages":8,"totalLinesOfCode":8,"stars":10,"forks":11,"watchers":12,"openIssues":11,"contributorsCount":13,"subscribersCount":13,"size":13,"stars1d":12,"stars7d":14,"stars30d":15,"stars90d":13,"forks30d":13,"starsTrendScore":14,"compositeScore":16,"rankGlobal":8,"rankLanguage":8,"license":8,"archived":17,"fork":17,"defaultBranch":18,"hasWiki":17,"hasPages":17,"topics":19,"createdAt":8,"pushedAt":8,"updatedAt":20,"readmeContent":21,"aiSummary":22,"trendingCount":13,"starSnapshotCount":13,"syncStatus":11,"lastSyncTime":23,"discoverSource":24},81366,"Horizon-View","Denjino\u002FHorizon-View","Denjino",null,"TypeScript",44,2,1,0,3,5,39.43,false,"claude\u002Fbuild-horizon-view-v1-wstzS",[],"2026-06-12 04:01:33","# Horizon View\n\n**Webcam head tracking for Forza Horizon — turn your head, the cockpit camera follows.**\n\nHorizon View watches your head with any ordinary webcam and pans the in-game\ncamera as you look around, the way a VR headset would. It replaces the\nOpenTrack + AITrack + AutoHotKey stack with one calibrated app and a single\nhotkey. Built for ultrawide cockpit racing where small head movements should\nlet you glance at an apex or a mirror without taking a hand off the wheel.\n\n\u003Cp align=\"center\">\u003Cem>Created with &hearts; by \u003Ca href=\"https:\u002F\u002Fjmayala.com\">jmayala\u003C\u002Fa> — questions \u002F feedback: \u003Ca href=\"https:\u002F\u002Ftwitter.com\u002Fmadebyjmayala\">@madebyjmayala\u003C\u002Fa>\u003C\u002Fem>\u003C\u002Fp>\n\n> **v1 is Windows only** (Windows 10\u002F11, x64). The installer is unsigned, so\n> Windows SmartScreen will warn the first time — that's expected (see Install).\n\n---\n\n## Quick start\n\n1. **Download** the latest `HorizonView_x.y.z_x64-setup.exe` from the\n   [Releases](https:\u002F\u002Fgithub.com\u002Fdenjino\u002Fhorizon-view\u002Freleases) page and run it.\n2. When SmartScreen warns, click **More info → Run anyway**.\n3. The app opens into a short **setup wizard**: grant webcam access, pick your\n   camera, calibrate (5 dots, ~60 seconds), then set a starting sensitivity.\n4. Launch **Forza Horizon**, get into a car, switch to **cockpit view**.\n5. Press **Home** to turn tracking on. Look around — the camera follows your\n   head. Press **Home** again to turn it off.\n6. Press **F1** in-game to pop up the live-tune panel and dial it in while you\n   drive.\n\nThat's it. The app lives in your system tray; closing the window just\nminimises it there.\n\n---\n\n## How it works\n\n1. **MediaPipe Face Landmarker** (running locally in the app) reads your head\n   pose from the webcam and extracts your **yaw** — how far you're turned left\n   or right.\n2. A **5-point calibration** learns *your* natural head-movement range and\n   maps it to screen positions, so you don't have to fiddle with raw\n   sensitivity curves.\n3. While tracking is on, the app **holds the right mouse button** and emits\n   mouse movement to drive Forza's cockpit free-look, then releases it when\n   you toggle off.\n\nEverything runs on your machine. No telemetry, no network, no account.\n\n---\n\n## Setup wizard, step by step\n\n| Step | What happens |\n|---|---|\n| **Welcome** | Quick intro. |\n| **Webcam access** | Grant the camera permission. If you deny it, enable it under Windows Settings → Privacy & Security → Camera, then retry. |\n| **Pick camera** | Choose your webcam and confirm you can see your face in the preview. |\n| **Calibrate** | Full-screen. Five dots appear (center → far-left → mid-left → mid-right → far-right). **Look at each dot by turning your head — not just your eyes — then press Space** (or click \"Capture this point\"). Wait for the \"Tracker ready\" indicator and a live yaw readout before you start. |\n| **Tune** | Set a starting sensitivity. You'll fine-tune the rest in-game. |\n\nIf calibration fails (\"captured points aren't strictly ordered\"), you moved\ninconsistently between dots — just redo it, turning your head deliberately and\npausing before each capture.\n\nYou can re-run calibration any time from the dashboard (**Recalibrate**) or the\ntray menu.\n\n---\n\n## The controls — what every setting does\n\nAll of these live in the **dashboard** (the app window) and in the **in-game\nF1 overlay**. They're the same controls in both places and stay in sync.\n\n### Sensitivity `0.1× – 2.0×`\nOverall strength of the effect — how far the camera pans for a full head turn.\n**Start around 0.3×.** Higher = a small head turn moves the camera more.\n\n### Smoothing `0 – 100%`\nTrades responsiveness for stability.\n- **Low (Responsive):** the camera tracks your head almost instantly, but\n  webcam noise can make it feel twitchy.\n- **High (Smoothed):** heavier filtering — calmer, very slightly laggier.\n\nInternally this drives a One-Euro filter: it smooths hard when your head is\nstill and loosens up automatically when you move, so high smoothing doesn't\nmean sluggish fast turns. **~80% is a good default.**\n\n### Response curve `Sensitive center ↔ Linear ↔ Sensitive edges`\nChanges how head angle maps to camera pan.\n- **Linear (middle):** 1:1 — even response everywhere.\n- **Sensitive edges:** small head movements near center barely move the camera;\n  bigger turns ramp up sharply. Good if you want a steady forward view and only\n  pan when you really mean to.\n- **Sensitive center:** tiny head movements register immediately; the extremes\n  level off.\n\n### Center deadzone `0 – 30%`\nSnaps the camera to dead-center while your head is near neutral, so it doesn't\njitter when you're looking straight ahead. Outside the deadzone, motion is\nsmoothly re-mapped so there's no jump. **If you see micro-jitter while sitting\nstill, raise this to ~15%.** This is the right fix for rest-jitter — it doesn't\nhurt responsiveness once you're actually turning.\n\n### Left pan \u002F Right pan `0.2× – 3.0×`\nIndependent strength for each side. In a cockpit you sit on one side of the\ncar, so one mirror is \"closer\" (less rotation) than the other. Crank the\n**heavier side** up so a comfortable head turn reaches the far mirror. Example\nfor a left-hand-drive car: **Left ≈ 1.55×, Right ≈ 1.0×.**\n\n### Recenter\nLooking straight ahead but the camera isn't centered? Press **Recenter** while\nholding a neutral head pose — it makes your current pose the new \"center\"\nwithout re-running calibration. Useful when you've shifted in your seat during\na long session. \"Clear offset\" undoes it.\n\n### Fine-tune jitter (dashboard → Advanced)\nFor power users: `Min cutoff` and `Beta` expose the One-Euro filter directly\nand override the Smoothing slider. Lower min cutoff = heavier smoothing at\nrest; beta = how fast the filter loosens during motion.\n\n---\n\n## Recommended starting point\n\nA solid baseline (the defaults a fresh install ships with):\n\n| Setting | Value |\n|---|---|\n| Sensitivity | 0.30× |\n| Smoothing | 80% |\n| Response curve | Linear |\n| Center deadzone | 15% |\n| Left pan | 1.55× |\n| Right pan | 1.00× |\n\nThen adjust to taste with the F1 overlay while driving. Use **\"Reset advanced\nto recommended\"** in the dashboard to get back here.\n\n---\n\n## Tips & things to know\n\n- **Use the camera preview to tune without the game.** Turn on\n  *Advanced → Show camera preview window*. It shows the tracked face mesh and a\n  green ball that moves exactly as the camera would — a fast way to feel out\n  the sliders. Drag its corner to resize it.\n- **The toggle overlay needs borderless windowed mode.** The on-screen\n  \"Tracking ON\u002FOFF\" toast and the F1 panel appear over the game only in\n  **Fullscreen Windowed \u002F Borderless** mode. If you don't see them, check\n  Forza's Display settings. (Exclusive fullscreen hides all overlays,\n  system-wide — not specific to this app.)\n- **Cursor parking.** When tracking turns on, the mouse cursor is moved to the\n  bottom-center of your screen once and left there, so it stays out of the way.\n- **Face lost?** If the tracker loses your face (you look away, lighting drops),\n  it gently re-centers the camera and pauses until it sees you again. Good\n  lighting on your face makes tracking far more stable.\n- **Re-tuning after big changes.** If you change seating position or move your\n  webcam, hit **Recenter**, or **Recalibrate** if it feels off.\n- **Hotkeys.** Toggle defaults to **Home**, live-tune panel to **F1**. The\n  toggle key is rebindable in the dashboard.\n\n---\n\n## Developer notes\n\n- **Stack:** Tauri 2 (Rust core) + React + TypeScript + Vite + Tailwind.\n  Tracking via MediaPipe Tasks Vision (WebGL) in the webview; OS mouse output\n  and global hotkeys in Rust.\n- **Run locally:** `pnpm install` then `pnpm tauri dev`.\n- **Build installer:** `pnpm tauri build` → `src-tauri\u002Ftarget\u002Frelease\u002Fbundle\u002Fnsis\u002F`.\n- **MediaPipe assets** (WASM + model) are bundled at build time by\n  `scripts\u002Fsetup-mediapipe.mjs`, so the app works fully offline.\n- The only real end-to-end test is running Forza; most behaviour can be felt\n  out using the camera-preview tuning ball without launching the game.\n\nSee [`FUTURE.md`](.\u002FFUTURE.md) for what's intentionally out of scope for v1.\n\n---\n\n## Credits\n\nCreated with &hearts; by **[jmayala](https:\u002F\u002Fjmayala.com)**.\nQuestions, ideas, or bug reports → **[@madebyjmayala](https:\u002F\u002Ftwitter.com\u002Fmadebyjmayala)**.\n\n## License\n\nMIT.\n","Horizon View 是一款用于Forza Horizon游戏的头部追踪软件，通过普通网络摄像头捕捉玩家头部动作来控制游戏内的驾驶舱视角。其核心功能包括基于MediaPipe Face Landmarker技术实现的本地头部姿态检测、简易五点校准流程以适应个人自然头部转动范围，并通过模拟鼠标操作来驱动游戏中的自由视角。该应用简化了以往需要多软件配合使用的复杂设置，只需一个热键即可激活或关闭头部追踪功能。适用于希望在超宽屏环境下享受更沉浸式赛车体验的玩家，尤其是在需要频繁查看赛道关键点或后视镜时保持双手不离方向盘的情况下。当前版本仅支持Windows 10\u002F11 x64系统。","2026-06-11 04:04:48","CREATED_QUERY"]