{"id":49484598,"url":"https://github.com/itsloopyo/bioshock-remastered-headtracking","last_synced_at":"2026-05-03T21:01:24.885Z","repository":{"id":352328511,"uuid":"1214175658","full_name":"itsloopyo/bioshock-remastered-headtracking","owner":"itsloopyo","description":"An OpenTrack compatible head tracking mod for Bioshock Remastered","archived":false,"fork":false,"pushed_at":"2026-04-30T22:55:49.000Z","size":27447,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T00:25:05.367Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Rust","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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-04-18T08:06:35.000Z","updated_at":"2026-04-30T22:55:51.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/itsloopyo/bioshock-remastered-headtracking","commit_stats":null,"previous_names":["itsloopyo/bioshock-remastered-headtracking"],"tags_count":3,"template":false,"template_full_name":null,"purl":"pkg:github/itsloopyo/bioshock-remastered-headtracking","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fbioshock-remastered-headtracking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fbioshock-remastered-headtracking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fbioshock-remastered-headtracking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fbioshock-remastered-headtracking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/itsloopyo","download_url":"https://codeload.github.com/itsloopyo/bioshock-remastered-headtracking/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/itsloopyo%2Fbioshock-remastered-headtracking/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32584651,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-03T06:36:36.687Z","status":"ssl_error","status_checked_at":"2026-05-03T06:36:09.306Z","response_time":103,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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-05-01T00:04:01.882Z","updated_at":"2026-05-03T21:01:24.878Z","avatar_url":"https://github.com/itsloopyo.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# BioShock Remastered Head Tracking\n\n![Mod GIF](https://raw.githubusercontent.com/itsloopyo/bioshock-remastered-headtracking/main/assets/readme-clip.gif)\n\nDecoupled look+aim head tracking for BioShock Remastered. Your head moves\nthe view; the mouse still controls aim.\n\n## Features\n\n- **6DOF head tracking** via OpenTrack UDP - yaw, pitch, roll, and\n  positional lean.\n- **True look / aim decoupling** - the engine sees your unmodified\n  mouse aim while the rendered view follows your head, so bullets\n  always land where the reticle is drawn.\n- **Parallax-correct reticle** drawn directly into the swap chain,\n  replacing BioShock's gun and plasmid reticles.\n\n## Requirements\n\n- A purchased copy of **BioShock Remastered** on Steam (AppID 409710).\n- **Windows 10 / 11**.\n- A tracking source that speaks OpenTrack UDP. Anything that can send\n  48-byte OpenTrack packets to port 4242 works.\n\n## Installation\n\n1. Download the latest `BioshockRemasteredHeadTracking-v\u003cversion\u003e-installer.zip`\n   from [Releases](https://github.com/itsloopyo/bioshock-remastered/releases).\n2. Extract anywhere.\n3. Run `install.cmd` - it auto-detects your Steam install and copies\n   `xinput1_3.dll` into `BioShock Remastered/Build/Final/`.\n\nFor NexusMods users: grab the `-nexus.zip` variant and extract straight\ninto your game's root folder.\n\n### Manual install\n\nCopy `xinput1_3.dll` into:\n\n```\n\u003cSteam library\u003e/steamapps/common/BioShock Remastered/Build/Final/\n```\n\n## OpenTrack setup\n\n| Setting  | Value              |\n|----------|--------------------|\n| Output   | UDP over network   |\n| Address  | 127.0.0.1          |\n| Port     | **4242**           |\n| Protocol | UDP Position + Rotation (raw doubles) |\n\nFilter / smoothing / deadzone choice is up to you.\n\n## Phone app setup\n\nThe receiver binds to `0.0.0.0:4242`, so a phone tracking app on the\nsame WiFi can send directly to your PC at port 4242 - provided the\napp smooths the signal before sending. Without smoothing, raw phone\ngyro data is too jittery for use.\n\n## Controls\n\nTwo equivalent binding sets - use whichever your keyboard has:\n\n| Action              | Nav-cluster | Chord           |\n|---------------------|-------------|-----------------|\n| Recenter            | `Home`      | `Ctrl+Shift+T`  |\n| Toggle tracking     | `End`       | `Ctrl+Shift+Y`  |\n| Cycle tracking mode | `Page Up`   | `Ctrl+Shift+G`  |\n\n`Page Up` / `Ctrl+Shift+G` cycles tracking mode:\n\n1. Normal head-tracked gameplay\n2. Positional tracking disabled, rotational tracking enabled\n3. Rotational tracking disabled, positional tracking enabled\n4. Back to normal\n\nThe chord letters T/Y/G sit in a vertical strip in the centre of\nthe keyboard. `Ctrl+Shift+\u003cletter\u003e` is universally avoided by games,\nso the chord set works whether or not your keyboard has a nav\ncluster.\n\n## Configuration (non-default FOV)\n\nIf you've changed the FOV slider in BSR's options away from 100° (the\nstock value), the head-tracked reticle may drift away from the actual\naim point - the mod can't auto-detect the slider value. Tell it your\nFOV manually:\n\n1. A self-documenting `bioshock_headtrack.ini` is written to\n   `BioShock Remastered/Build/Final/` on first launch (next to the\n   DLL).\n2. Uncomment and set:\n\n   ```ini\n   [overlay]\n   fov_h = 90\n   ```\n\n   Replace `90` with whatever horizontal FOV you've set in-game. Valid\n   range: 40-150°. Vertical FOV is derived from horizontal at 16:9.\n3. Restart the game.\n\n## Troubleshooting\n\n**No tracking in-game.**\n- Confirm your tracker is sending UDP to `127.0.0.1:4242` (or your\n  PC's LAN IP if tracking from a phone).\n- Check the mod log at\n  `BioShock Remastered/Build/Final/bioshock_headtrack.log`.\n\n**Game crashes on launch.**\n- `xinput1_3.dll` must be in `Build/Final/`, not the game root.\n- Steam -\u003e right-click BioShock Remastered -\u003e Properties -\u003e Local Files\n  -\u003e Verify integrity, then reinstall the mod.\n\n**Reticle drifts left/right as you yaw your head.**\n- You're likely running a non-stock FOV. Set `[overlay] fov_h` in\n  `bioshock_headtrack.ini` (see Configuration).\n\n**Wrong rotation / jitter.**\n- Increase smoothing in your tracking source.\n- Set `BIOSHOCK_PATH` env var to override game detection if\n  `install.cmd` can't find your install.\n\n## Updating / uninstalling\n\nTo update, run the new installer over the old DLL - it overwrites in\nplace.\n\nRun `uninstall.cmd` from the extracted installer, or run\n`pixi run uninstall` from a source checkout. Both restore the\noriginal `xinput1_3.dll` from the `.backup` file the installer left\nbehind.\n\n## Building from source\n\n```powershell\npixi run build-release   # 32-bit, i686-pc-windows-msvc\npixi run install-release # deploy locally to your Steam install\n```\n\n`pixi run release \u003cversion\u003e` bumps `Cargo.toml`, regenerates the\nchangelog from commits, tags, and pushes - CI builds and uploads the\nrelease ZIPs.\n\n## License\n\nMIT - see [LICENSE](LICENSE).\n\n## Credits\n\n- BioShock Remastered (c) 2K / Irrational Games / Blind Squirrel\n  Entertainment.\n- [OpenTrack](https://github.com/opentrack/opentrack) for the UDP\n  protocol.\n- [MinHook](https://github.com/TsudaKageyu/minhook) for function\n  hooking.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsloopyo%2Fbioshock-remastered-headtracking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fitsloopyo%2Fbioshock-remastered-headtracking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fitsloopyo%2Fbioshock-remastered-headtracking/lists"}