{"id":46345537,"url":"https://github.com/rvt/headtracker","last_synced_at":"2026-03-04T21:12:29.973Z","repository":{"id":44718292,"uuid":"231729939","full_name":"rvt/headtracker","owner":"rvt","description":"Head Tracker using MPU6050/MPU9250 and ESP8266","archived":false,"fork":false,"pushed_at":"2024-02-06T07:04:52.000Z","size":546,"stargazers_count":26,"open_issues_count":5,"forks_count":8,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-04-15T01:18:52.493Z","etag":null,"topics":["eps8266","esp8285","headtracking","mpu6050","mpu9250","opentrack","xplane"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rvt.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}},"created_at":"2020-01-04T08:07:45.000Z","updated_at":"2024-03-19T17:41:34.000Z","dependencies_parsed_at":"2024-01-28T19:46:12.316Z","dependency_job_id":null,"html_url":"https://github.com/rvt/headtracker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/rvt/headtracker","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvt%2Fheadtracker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvt%2Fheadtracker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvt%2Fheadtracker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvt%2Fheadtracker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rvt","download_url":"https://codeload.github.com/rvt/headtracker/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rvt%2Fheadtracker/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30093152,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-04T20:42:30.420Z","status":"ssl_error","status_checked_at":"2026-03-04T20:42:30.057Z","response_time":59,"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":["eps8266","esp8285","headtracking","mpu6050","mpu9250","opentrack","xplane"],"created_at":"2026-03-04T21:12:29.346Z","updated_at":"2026-03-04T21:12:29.950Z","avatar_url":"https://github.com/rvt.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Head tracking with esp8266/esp8265 and MPU6050 or MPU9250\n\n# Installation\n\nInstall platform IO\n\n```bash\n# Build char* array for web\n./generateHtmlArray.sh\nplatformio run --target upload -e wemos\nplatformio device monitor --baud 115200\n```\n\n# How to use\n\nThe device will create a new network so for a once time setup you need to have your computer or mobile phone connect to this network and congirue the wifi.\n\n![Wifi Config Menu](img/wifi_config.png \"Wifi Config\")\n\nIf you did monitor your device it will show you the IP address of the access point.\n\nWhile you are at it go to the setup page to tell setup the location and protocol to send data to. You can also calibrate the MPU (Motion Processing Unit). Read the instructions carefully!\n\n![Calibration menu](img/calibration.png \"Calibration\")\n\n* FreePie protocol sends Yaw Pitch and Roll using the FreePie format. This has been tested with OpenTrack\n* OpenTrackUDP sends Yaw Pitch and Roll using a simple floar array. This has been tested with OpenTrack.\n\n# Where to put the MPU\n\nI have designed a little box that can be printed using a 3D printer.\nIt´s a bit tricky to print but it will work out if you put up some support material. The STL file (mpu6050_holder.stl) is included. Then I have sewed it on a baseball cap. I´s very light and you will hardly fill it.\n\n![Holder for MPU6050 menu](img/mpu6050_holder.png \"mpu6050\")\n\nThe ESP8266 can be put in a other box and you can connect the MPU6050 and ESP8266 using a 5 wire shielded cable. Make sure it´s not longer than 1.5 to 2 meter (I have tested 1.5m) otherwhise I2C communication mght fail.\n\n# calibration and zero\n\nWithin the setup page there is a tool to setup calibration and setting 'zero' orientation.\nCalibration of the mpu9250 is unfortunatly more than tricky, but if you have questions please ask.\n\n\n# TODO\n* guide trought calibration for imu's\n* show calibration values on UI + quality of qualibration (mpu 9250)\n* add more IMU's like the ICM-20948\n* code cleanup, this was somewhat hacked together to create a MVP\n* add more output protocols.\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frvt%2Fheadtracker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frvt%2Fheadtracker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frvt%2Fheadtracker/lists"}