{"id":46902128,"url":"https://github.com/itsloopyo/gone-home-headtracking","last_synced_at":"2026-04-18T16:01:31.073Z","repository":{"id":343578024,"uuid":"1175245715","full_name":"itsloopyo/gone-home-headtracking","owner":"itsloopyo","description":"An OpenTrack compatible head tracking mod for Gone Home","archived":false,"fork":false,"pushed_at":"2026-04-18T14:33:43.000Z","size":16327,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-18T15:35:50.277Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/itsloopyo.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-03-07T12:49:32.000Z","updated_at":"2026-04-18T14:26:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"e74c23a5-948c-45c7-bcbc-88d24561dff8","html_url":"https://github.com/itsloopyo/gone-home-headtracking","commit_stats":null,"previous_names":["itsloopyo/gone-home-headtracking"],"tags_count":7,"template":false,"template_full_name":null,"purl":"pkg:github/itsloopyo/gone-home-headtracking","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fgone-home-headtracking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fgone-home-headtracking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fgone-home-headtracking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fgone-home-headtracking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsloopyo","download_url":"https://codeload.github.com/itsloopyo/gone-home-headtracking/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fgone-home-headtracking/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31974954,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-18T00:39:45.007Z","status":"online","status_checked_at":"2026-04-18T02:00:07.018Z","response_time":103,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-03-11T00:11:07.378Z","updated_at":"2026-04-18T16:01:31.059Z","avatar_url":"https://github.com/itsloopyo.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Gone Home Head Tracking\n\n![Mod GIF](https://raw.githubusercontent.com/itsloopyo/gone-home-headtracking/main/assets/readme-clip.gif)\n\nhttps://raw.githubusercontent.com/itsloopyo/gone-home-headtracking/main/assets/readme-clip.gif\n\nAn **unofficial** head tracking mod for Gone Home with decoupled look + aim support. Enables natural head movement using OpenTrack-compatible trackers while maintaining independent mouse aim.\n\n## Features\n\n- **Decoupled look + aim**: Look around freely with your head while mouse-controlled aim stays independent\n- **6DOF head tracking**: Yaw, pitch, roll, and positional tracking (X/Y/Z) via OpenTrack UDP protocol\n\n## Requirements\n\n- Gone Home (Steam, GOG, or Epic)\n- [OpenTrack](https://github.com/opentrack/opentrack) or a compatible head tracking app (smartphone, webcam, or dedicated hardware)\n- Windows 10/11\n\n## Installation\n\n1. Download the latest release from the [Releases page](https://github.com/itsloopyo/gone-home-headtracking/releases)\n2. Extract the ZIP anywhere\n3. Double-click `install.cmd`\n4. Configure OpenTrack to output UDP to `127.0.0.1:4242`\n5. Launch Gone Home\n\nThe installer automatically finds your game by checking Steam, GOG, and Epic installations. If it can't find the game, either:\n- Set the `GONEHOME_PATH` environment variable to your game folder\n- Run from command prompt: `install.cmd \"D:\\Games\\Gone Home\"`\n\n## Setting Up OpenTrack\n\n1. Download and install [OpenTrack](https://github.com/opentrack/opentrack/releases)\n2. Configure your tracker (Input):\n   - For webcam: Select \"neuralnet tracker\"\n   - For phone app: Select \"UDP over network\"\n3. Configure output:\n   - Select **UDP over network**\n   - Host: `127.0.0.1`\n   - Port: `4242`\n4. Click **Start** to begin tracking\n5. Launch Gone Home\n\n### Phone App Setup\n\nThis mod includes built-in smoothing to handle network jitter, so if your tracking app already provides a filtered signal, you can send directly from your phone to the mod on port 4242 without needing OpenTrack on PC.\n\n1. Install an OpenTrack-compatible head tracking app from your phone's app store\n2. Configure your phone app to send to your PC's IP address on port 4242 (run `ipconfig` to find it, e.g. `192.168.1.100`)\n3. Set the protocol to OpenTrack/UDP\n4. Start tracking\n\n**With OpenTrack (optional):** If you experience jerky motion, want curve mapping, or want a visual preview, route through OpenTrack instead. The mod already listens on port 4242, so OpenTrack's input must use a different port:\n1. In OpenTrack, set Input to **UDP over network** on port **5252** (or any port other than 4242)\n2. Set Output to **UDP over network** at `127.0.0.1:4242`\n3. In your phone app, send to your PC's IP on port **5252** (matching OpenTrack's input port)\n4. Make sure port 5252 is open in your PC's firewall for incoming UDP traffic\n\n## Controls\n\n| Key | Action |\n|-----|--------|\n| **Home** | Recenter (set current head position as neutral) |\n| **End** | Toggle head tracking on/off |\n| **Page Up** | Toggle position tracking (6DOF/3DOF) |\n\n## Configuration\n\nThe mod creates `HeadTracking.cfg` in `GoneHome_Data\\Managed` on first run. Edit it to customize:\n\n```ini\n# Network\nUdpPort = 4242\n\n# Keybindings (Unity KeyCode names)\n# See https://docs.unity3d.com/ScriptReference/KeyCode.html\nRecenterKey = Home\nToggleKey = End\nPositionToggleKey = PageUp\n\n# Sensitivity (multipliers, 0.1-5.0)\nYawSensitivity = 1.0\nPitchSensitivity = 1.0\nRollSensitivity = 1.0\n\n# Smoothing (0.0-1.0, remote connections enforce a minimum of 0.15)\nSmoothing = 0.0\n\n# Position tracking\nPositionSensitivityX = 1.0\nPositionSensitivityY = 1.0\nPositionSensitivityZ = 1.0\nInvertPositionX = true\nInvertPositionY = false\nInvertPositionZ = true\n\n# Reticle\nShowReticle = true\nReticleColor = 1.0,1.0,1.0,1.0\n```\n\n## Troubleshooting\n\n**Mod not loading:**\n- Check `HeadTracking_BOOT.log` in the Managed folder\n- Check `%TEMP%\\HeadTracking_BOOT_ERROR.log` for errors\n- Make sure all DLL files are in the Managed folder\n\n**No tracking response:**\n- Verify OpenTrack is running and outputting data\n- Check UDP port matches (default 4242)\n- Press **End** to enable tracking if it was toggled off\n- Press **Home** to recenter\n\n**Game crashes on startup:**\n1. Run `uninstall.cmd` to restore original files\n2. Verify game files through your launcher (Steam: Right-click \u003e Properties \u003e Local Files \u003e Verify)\n3. Try installing again\n\n## Updating\n\nDownload the new release and run `install.cmd` again. It will update the mod files in place.\n\n## Uninstalling\n\nRun `uninstall.cmd` from the release folder. This restores the original `Assembly-CSharp.dll` from backup and removes all mod files.\n\nYou can also restore manually:\n1. Delete from `GoneHome_Data\\Managed`: `HeadTracking.dll`, `CameraUnlock.Core.dll`, `CameraUnlock.Core.Unity.dll`, `Mono.Cecil.dll`\n2. Restore `Assembly-CSharp.dll`: rename `Assembly-CSharp.dll.original` back to `Assembly-CSharp.dll`, or verify game files through your launcher\n\n## Building from Source\n\n### Prerequisites\n\n- [Pixi](https://pixi.sh) package manager\n- .NET SDK 8.0+\n- Gone Home installed (Unity DLLs are needed as build references)\n\n### Build\n\n```bash\ngit clone --recurse-submodules https://github.com/itsloopyo/gone-home-headtracking.git\ncd gone-home-headtracking\n\n# Copy required Unity DLLs from your game installation\npixi run setup-libs\n\n# Build\npixi run build\n\n# Build and install to game directory\npixi run install\n```\n\n### Pixi Tasks\n\n| Task | Description |\n|------|-------------|\n| `pixi run setup-libs` | Copy Unity DLLs from game installation |\n| `pixi run build` | Build the mod (Release configuration) |\n| `pixi run install` | Build and install to game directory |\n| `pixi run uninstall` | Remove the mod from the game |\n| `pixi run package` | Create release ZIPs |\n| `pixi run clean` | Clean build artifacts |\n| `pixi run release` | Version bump, build, tag, and push |\n\n## License\n\nMIT License. See [LICENSE](LICENSE) for details.\n\n## Credits\n\n- [The Fullbright Company](https://fullbright.company/) - Gone Home\n- [OpenTrack](https://github.com/opentrack/opentrack) - Head tracking software\n- [Mono.Cecil](https://github.com/jbevain/cecil) - .NET assembly manipulation\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsloopyo%2Fgone-home-headtracking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsloopyo%2Fgone-home-headtracking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsloopyo%2Fgone-home-headtracking/lists"}