{"id":20884565,"url":"https://github.com/eyetrackvr/etvrtrackingmodule","last_synced_at":"2026-05-25T00:01:55.457Z","repository":{"id":200185056,"uuid":"703735397","full_name":"EyeTrackVR/ETVRTrackingModule","owner":"EyeTrackVR","description":"A VRCFT module for ETVR project ","archived":false,"fork":false,"pushed_at":"2026-05-24T22:02:24.000Z","size":162,"stargazers_count":16,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-05-24T23:28:55.438Z","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/EyeTrackVR.png","metadata":{"files":{"readme":"README.md","changelog":null,"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}},"created_at":"2023-10-11T20:06:32.000Z","updated_at":"2026-05-24T21:52:10.000Z","dependencies_parsed_at":"2024-01-28T22:23:54.522Z","dependency_job_id":"083db1e8-cfb1-4880-a994-79069866e88e","html_url":"https://github.com/EyeTrackVR/ETVRTrackingModule","commit_stats":null,"previous_names":["lorow/etvrtrackingmodule","eyetrackvr/etvrtrackingmodule"],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/EyeTrackVR/ETVRTrackingModule","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EyeTrackVR%2FETVRTrackingModule","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EyeTrackVR%2FETVRTrackingModule/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EyeTrackVR%2FETVRTrackingModule/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EyeTrackVR%2FETVRTrackingModule/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EyeTrackVR","download_url":"https://codeload.github.com/EyeTrackVR/ETVRTrackingModule/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EyeTrackVR%2FETVRTrackingModule/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33455026,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-24T19:21:36.376Z","status":"ssl_error","status_checked_at":"2026-05-24T19:21:10.562Z","response_time":57,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":"2024-11-18T08:10:29.951Z","updated_at":"2026-05-25T00:01:55.442Z","avatar_url":"https://github.com/EyeTrackVR.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ETVR VRCFT Tracking Module \n\nETVR Tracking mode is a VRCFT addon dedicated to EyetrackVR Project.\nIt acts as middle ground for translating OSC messages sent by EyetrackVR to a format understandable by VRCFT project. \n\nWith it:\n- ETVR can work with whichever game VRCFT supports. \n- Users don't have to worry about setting up a different set of params than those required by VRCFT\n- ETVR get's to be forever(*) compatible\n\n## How to use this: \n\n### Module installation\n####  When it gets registered in VRCFT Module registry  \nTo make use of this module, checkout the module registry in VRCFT app and install it from there. \nEverything will be ready to go. \n\n##### For now: \n\nYou'll have to download the provided DLL file [from releases pages](https://github.com/lorow/ETVRTrackingModule/releases)\nNext, place it under `C:\\Users\\{your_user}\\AppData\\Roaming\\VRCFaceTracking\\CustomLibs\\` directory.\n\nIf the directory doesn't exist, feel free to create it.\nDon't forget to replace the `{your_user}` part with your pc's name. \n\n    # For example:\n    \n    from:\n    \n    `C:\\Users\\{your_user}\\AppData\\Roaming\\VRCFaceTracking\\CustomLibs\\`\n    \n    to:\n    \n    `C:\\Users\\lorow\\AppData\\Roaming\\VRCFaceTracking\\CustomLibs\\`\n\n### App setup\n\nYou'll need to change the `Port` in `Settings` from `9000` to `8889`.\n\nSettings will save automatically, but for them to take effect, you'll need to restart the app.\n\n## What's supported right now / roadmap \n\n### What's currently supported: \n\nThis a bit more technical section meant more to showcase what params sent out by ETVR are currently supported \nand translated by the module to VRCFT.\n\nFor V1 params sent out by ETVR with their defaults :\n\n        { \"RightEyeLidExpandedSqueeze\", 1f },\n        { \"LeftEyeLidExpandedSqueeze\", 1f },\n        { \"LeftEyeX\", 0f },\n        { \"RightEyeX\", 0f },\n        { \"EyesY\", 0f },\n\nFor v2 params sent out by ETVR with their default values:\n\n        { \"EyeX\", 0f },\n        { \"EyeY\", 0f },\n        { \"EyeLid\", 1f },\n        \n        { \"EyeLeftX\", 0f },\n        { \"EyeLeftY\", 0f },\n        { \"EyeRightX\", 0f },\n        { \"EyeRightY\", 0f },\n        { \"EyeLidLeft\", 1f },\n        { \"EyeLidRight\", 1f },\n\nAdditionally to those params:\n\n##### Eye widen / Squint emulation\n\nEye widen is supported by default in v2 params, for v1 we're emulating it. Every time eye openness reported by ETVR\nreaches above certain threshold, we try and smoothly widen the eye a little bit. \n\nSquinting. For v2 it's defined as a separate parameter. For v1 it is done the same way as eye widen.\n\n##### Eyebrows emulation  \n\nEyebrows emulation is now supported as well, for both v1 and v2(UE) parameters. It works by smoothly adjusting VRCFTs parameters after openness reaches a certain threshold. \n\n#### Squinting support for V2 parameters  \n \nImplemented similarly to widen, we smoothly adjust proper expressions for v1 and v2 params when we detect eye openness has reached a very low threshold.\n\n#### Other stuff\n- [More dev-ish stuff] unified protocol for talking with ETVR\n- Configuration for adjusting emulation thresholds for squinting / widen / eyebrows if need be and OSC Port in case of conflicts \n\n## How to contribute:\nPretty much the same way as with [EyetrackVR Project](https://github.com/EyeTrackVR/eyetrackvr). \n\n### How do I get it to compile? \n\nTo get this to compile: \n\n- Clone this project with either git or zip download. \n- Download the source code zip from [VRCFT release page](https://github.com/benaclejames/VRCFaceTracking/releases) and extract it next to this project. \n- Open this project with the IDE of your choice and hit build, it should compile into a DLL file. \n\n### Dev faq: \n\n##### Why download source code from releases instead of cloning the project? \n\nTo avoid a situation where the code you compile the module against is too new. \nI did that, it results in a pretty weird error.\nDownloading the source code ensures that you have the same code base that was used to compile the production app\n\n##### Do I need to copy the file to the directory mentioned above? \n\nNo. It's already setup as a build event. \nOnce compiled the file will be copied over to `$(USERPROFILE)\\AppData\\Roaming\\VRCFaceTracking\\CustomLibs\\$(ProjectName).dll` \n\nThis also means that if you try to compile while vrcft is running, building will error out on the copying step. This is expected. \nClose down VRCFT and try buildig again.\n\n##### Does this compile under linux? Can I work on this from linux?\n\nI am not sure. All of the development was done on a Windows machine. Feel free to try tho \n\nOne step that you'll need to modify is the after build copy event in  `ETVRTrackingModule.csproj` , either completely remove it or replace the path with the correct one. \n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feyetrackvr%2Fetvrtrackingmodule","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feyetrackvr%2Fetvrtrackingmodule","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feyetrackvr%2Fetvrtrackingmodule/lists"}