{"id":28095108,"url":"https://github.com/jeka8833/foxyface","last_synced_at":"2026-06-06T14:01:25.496Z","repository":{"id":292716596,"uuid":"980569392","full_name":"Jeka8833/FoxyFace","owner":"Jeka8833","description":"An application that allows you to control your avatar's face in VRChat using your real face.","archived":false,"fork":false,"pushed_at":"2026-06-04T19:06:19.000Z","size":5770,"stargazers_count":55,"open_issues_count":5,"forks_count":6,"subscribers_count":2,"default_branch":"main","last_synced_at":"2026-06-04T21:25:34.701Z","etag":null,"topics":["babble-face-tracking","eye-tracking","face-tracking","head-tracking","mediapipe","mediapipe-facemesh","vrcft","vrchat"],"latest_commit_sha":null,"homepage":"https://foxyface.jeka8833.pp.ua","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Jeka8833.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2025-05-09T10:48:36.000Z","updated_at":"2026-06-04T17:37:30.000Z","dependencies_parsed_at":"2026-01-27T22:02:22.528Z","dependency_job_id":null,"html_url":"https://github.com/Jeka8833/FoxyFace","commit_stats":null,"previous_names":["jeka8833/foxyface"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/Jeka8833/FoxyFace","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeka8833%2FFoxyFace","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeka8833%2FFoxyFace/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeka8833%2FFoxyFace/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeka8833%2FFoxyFace/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Jeka8833","download_url":"https://codeload.github.com/Jeka8833/FoxyFace/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Jeka8833%2FFoxyFace/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33984824,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-06T02:00:07.033Z","response_time":107,"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":["babble-face-tracking","eye-tracking","face-tracking","head-tracking","mediapipe","mediapipe-facemesh","vrcft","vrchat"],"created_at":"2025-05-13T15:18:23.020Z","updated_at":"2026-06-06T14:01:25.489Z","avatar_url":"https://github.com/Jeka8833.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# FoxyFace\r\n\r\nFoxyFace allows you to use your real face to control your avatar's face in VRChat using any camera that is connected to your computer. You can also use the camera of an Android device, iOS device or another computer, but this will require you to download additional programs, [here are instructions on how to do it](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/connection/Using-another-device-as-a-camera).\r\n\r\nFoxyFace uses the [MediaPipe Face landmark detection](https://ai.google.dev/edge/mediapipe/solutions/vision/face_landmarker) neural network bundle and the neural network from [Project Babble](https://github.com/Project-Babble).\r\n\r\nFoxyFace is a good starting point as it doesn't require you to invest any money if you have a computer and a camera on \"any\" of your devices.\r\n\u003cbr/\u003e\u003cbr/\u003e\r\n\r\n## Almost complete facial tracking\r\n\r\n![Example of Face Tracking](https://raw.githubusercontent.com/wiki/Jeka8833/FoxyFace/images/MainPage/Example.png)\r\n\u003csub\u003e\u003csup\u003eFace is taken from [FreePik](https://www.freepik.com/free-photo/medium-shot-woman-sticking-out-tongue_38162313.htm#fromView=keyword\u0026amp;page=1\u0026amp;position=45\u0026amp;uuid=48e0b063-562f-4793-988c-3fb80cd0ca43\u0026amp;query=Tongue+Out+Face), and [Yeenie](https://yoursmu.gumroad.com/l/yeenie) avatar is made by SMU\u003c/sup\u003e\u003c/sub\u003e\r\n\r\nThe FoxyFace is currently tracking 83 parameters out of 102 parameters supported by VRCFT, which is 81%. That's taking into account the [Blended Shapes](https://docs.vrcft.io/docs/tutorial-avatars/tutorial-avatars-extras/unified-blendshapes).\r\n\r\n\u003cdetails\u003e\r\n  \u003csummary\u003eSupported parameters\u003c/summary\u003e\r\n  \u003cbr/\u003e\r\n  BrowInnerUpLeft, BrowInnerUpRight, BrowLowererLeft, BrowLowererRight, BrowOuterUpLeft, BrowOuterUpRight, BrowPinchLeft, BrowPinchRight, CheekPuffLeft, CheekPuffRight, CheekSquintLeft, CheekSquintRight, CheekSuckLeft, CheekSuckRight, EyeOpennessLeft, EyeOpennessRight, EyeSquintLeft, EyeSquintRight, EyeWideLeft, EyeWideRight, EyeXLeft, EyeXRight, EyeYLeft, EyeYRight, HeadPitch, HeadRoll, HeadX, HeadY, HeadYaw, HeadZ, JawForward, JawLeft, JawOpen, JawRight, LipFunnelLowerLeft, LipFunnelLowerRight, LipFunnelUpperLeft, LipFunnelUpperRight, LipPuckerLowerLeft, LipPuckerLowerRight, LipPuckerUpperLeft, LipPuckerUpperRight, LipSuckLowerLeft, LipSuckLowerRight, LipSuckUpperLeft, LipSuckUpperRight, MouthClosed, MouthCornerPullLeft, MouthCornerPullRight, MouthCornerSlantLeft, MouthCornerSlantRight, MouthDimpleLeft, MouthDimpleRight, MouthFrownLeft, MouthFrownRight, MouthLowerDownLeft, MouthLowerDownRight, MouthLowerLeft, MouthLowerRight, MouthPressLeft, MouthPressRight, MouthRaiserLower, MouthRaiserUpper, MouthStretchLeft, MouthStretchRight, MouthUpperLeft, MouthUpperRight, MouthUpperUpLeft, MouthUpperUpRight, NoseSneerLeft, NoseSneerRight, TongueBendDown, TongueCurlUp, TongueDown, TongueFlat, TongueLeft, TongueOut, TongueRight, TongueRoll, TongueSquish, TongueTwistLeft, TongueTwistRight, TongueUp\r\n\u003c/details\u003e\r\n\r\n\u003cdetails\u003e\r\n  \u003csummary\u003eUnsupported parameters\u003c/summary\u003e\r\n  \u003cbr/\u003e\r\nEyePupilDiameterMMLeft, EyePupilDiameterMMRight, JawBackward, JawClench, JawMandibleRaise, LipSuckCornerLeft, LipSuckCornerRight, MouthTightenerLeft, MouthTightenerRight, MouthUpperDeepenLeft, MouthUpperDeepenRight, NasalConstrictLeft, NasalConstrictRight, NasalDilationLeft, NasalDilationRight, NeckFlexLeft, NeckFlexRight, SoftPalateClose, ThroatSwallow\r\n\u003c/details\u003e\u003cbr/\u003e\r\n\r\n## Step 0\r\n\r\n1. Make sure you've installed [VRCFaceTracking](https://docs.vrcft.io).\r\n2. Make sure you find an avatar that supports face tracking or head movement. You **won't be able** to check if it works without this/third-party module enabled. Here's a video tutorial: [link](https://youtu.be/aitYy5H9YTM)\r\n3. The **most important step** is to make sure that you have enabled [OSC](https://docs.vrcft.io/docs/intro/getting-started#3%EF%B8%8F-enable-osc-in-vrchat) in the avatar settings and enabled tracking of individual parts of the face/head; by default, this is all turned off.\r\n\u003cbr/\u003e\r\n\r\n## Installation\r\n\r\nPerform the installation in this order:\r\n1. Install FoxyFace, instructions [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/install-update-uninstall/install/Install-FoxyFace).\r\n2. Install FoxyFaceVRCFTInterface, instructions [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFaceVRCFTInterface/install-update-uninstall/install/Install-Module-from-Module-Registry).\r\n\u003cbr/\u003e\r\n\r\n## Camera setup\r\n\r\nInstructions on how to set up the camera can be found [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/ui/camera/Camera-Settings).\r\n\r\nInstructions on how to use another device as a webcam can be found [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/connection/Using-another-device-as-a-camera).\r\n\r\n\u003cbr/\u003e\r\n\r\n## Updating the Project Babble neural network\r\n\r\nInstructions on how to update the neural network from Project Babble can be found [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/ui/babble/Update-Babble-Model).\r\n\r\n\u003cbr/\u003e\r\n\r\n## Want to control your avatar's head rotation?\r\n\r\nInstructions on how to track head rotation can be found [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/ui/vrcft/headrotation/Head-Rotation).\r\n\r\n\u003cbr/\u003e\r\n\r\n## Update FoxyFace Application\r\n\r\nInstructions on how to update the FoxyFace app can be found [here](https://foxyface.jeka8833.pp.ua/docs/FoxyFace/install-update-uninstall/Update-FoxyFace).\r\n\r\n\u003cbr/\u003e\r\n\r\n## Build\r\n\r\n\u003e [!NOTE]\r\n\u003e Simply cloning (`git clone`) without `--recurse-submodules` or downloading a Zip archive from GitHub **won't work** because the repository uses **submodules**!\r\n\r\n### Build FoxyFace\r\n\r\nPython version **3.12, 3.13, or 3.14** is required. Newer and older versions of Python have not been tested.\r\n\r\nAutomatically configuring the Python Virtual Environment doesn't happen in the IDE, but the basic plan consists of:\r\n1. Cloning the repository using:\r\n```\r\ngit clone --recurse-submodules https://github.com/Jeka8833/FoxyFace.git\r\n```\r\n2. Opening FoxyFace folder in IDE (PyCharm)\r\n3. The PyCharm may try to create .venv on its own, but it will most likely do so with the wrong version of Python, you need to recreate .venv with Python 3.12, 3.13, or 3.14.\r\n4. Next, the PyCharm will prompt you to install the required libraries from the `requirements.txt` file, you agree to this.\r\n\r\nThis is quite a complicated process for beginners, if you know how to automate this, feel free to offer your thoughts.\r\n\u003cbr/\u003e\r\n\r\n### Build FoxyFaceVRCFTInterface\r\n\r\nClone the project using internal IDE (JetBrains Rider, Visual Studio, ect...) tools, and select the project file FoxyFaceVRCFTInterface.sln. Then you click FoxyFaceVRCFTInterface -\u003e Build in the IDE, and it creates a compiled module for you in the release directory.\r\n\r\nInstructions on where to put the module and in general on developing modules for VRCFT can be found [here](https://docs.vrcft.io/docs/vrcft-software/vrcft-sdk/tracking-module).\r\n\u003cbr/\u003e\u003cbr/\u003e\r\n\r\n## License\r\n\r\n\u003e [!NOTE]\r\n\u003e This repository contains 2 separate projects and which have different licenses.\r\n\r\nFoxyFace code is licensed under [Apache License 2.0](https://github.com/Jeka8833/FoxyFace/blob/main/FoxyFace/LICENSE).\r\n\r\nFoxyFace uses code from third-party developers under license:\r\n1. License for Baballonia: [Apache License 2.0](https://github.com/Jeka8833/Baballonia-Copy/blob/main/LICENSE)\r\n\u003cbr/\u003e\r\n\r\nFoxyFaceVRCFTInterface code is licensed under [Unlicense](https://github.com/Jeka8833/FoxyFace/blob/main/FoxyFaceVRCFTInterface/UNLICENSE).\r\n\r\nFoxyFaceVRCFTInterface uses code from third-party developers under license:\r\n1. License for VRCFaceTracking: [Apache License 2.0](https://github.com/benaclejames/VRCFaceTracking/blob/master/LICENSE)\r\n\r\n\r\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeka8833%2Ffoxyface","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjeka8833%2Ffoxyface","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjeka8833%2Ffoxyface/lists"}