{"id":20801772,"url":"https://github.com/timschneeb/budspro-headtracking","last_synced_at":"2025-04-07T05:09:02.138Z","repository":{"id":48923080,"uuid":"361880802","full_name":"timschneeb/BudsPro-Headtracking","owner":"timschneeb","description":"Stream head-tracking data from the Samsung Galaxy Buds Pro in real-time","archived":false,"fork":false,"pushed_at":"2024-12-30T14:07:02.000Z","size":23,"stargazers_count":96,"open_issues_count":5,"forks_count":12,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-03-31T04:05:05.816Z","etag":null,"topics":["bluetooth","earbuds","galaxy-buds","headtracker","headtracking","reverse-engineering","samsung"],"latest_commit_sha":null,"homepage":"","language":"Python","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/timschneeb.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}},"created_at":"2021-04-26T20:11:33.000Z","updated_at":"2025-02-20T01:21:29.000Z","dependencies_parsed_at":"2025-02-09T05:10:23.673Z","dependency_job_id":"c2cd4352-c411-429d-ad90-77af8be12fd0","html_url":"https://github.com/timschneeb/BudsPro-Headtracking","commit_stats":null,"previous_names":["timschneeb/budspro-headtracking"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FBudsPro-Headtracking","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FBudsPro-Headtracking/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FBudsPro-Headtracking/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/timschneeb%2FBudsPro-Headtracking/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/timschneeb","download_url":"https://codeload.github.com/timschneeb/BudsPro-Headtracking/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247595334,"owners_count":20963943,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":["bluetooth","earbuds","galaxy-buds","headtracker","headtracking","reverse-engineering","samsung"],"created_at":"2024-11-17T18:21:47.981Z","updated_at":"2025-04-07T05:09:02.117Z","avatar_url":"https://github.com/timschneeb.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Galaxy Buds Pro Headtracking\nStream head-tracking data from the Samsung Galaxy Buds Pro in real-time\n\n## Requirements\n\n### Windows\n\nOn Windows, make sure to install version 0.22 of PyBluez.\nThe latest version (v0.23) does not work properly and fails to enumerate Bluetooth devices.\n```\npip install PyBluez==0.22\n```\n\n### Linux\n\nOn Linux, you can just go ahead and install the latest version of PyBluez.\n```\npip install PyBluez\n```\n\n## Usage\n```\npython Headtracking.py --help\n```\n```\nusage: Headtracking.py [-h] [-v] [-t] mac-address\n\nStream head-tracking data from the Galaxy Buds Pro\n\npositional arguments:\n  mac-address    MAC-Address of your Buds\n\noptional arguments:\n  -h, --help     show this help message and exit\n  -v, --verbose  Print debug information\n  -t, --trace    Trace Bluetooth serial traffic\n\n```\nDump raw head-tracking data as a quaternion (4D vector):\n```\npython Headtracking.py 64:03:7f:2e:2b:3a\n```\n```\nx=0.0159, y=0.0096, z=0.0134, w=0.0245\nx=0.0179, y=0.0171, z=0.0127, w=0.0251\nx=0.0178, y=0.0172, z=0.0146, w=0.0000\nx=0.0168, y=0.0103, z=0.0056, w=0.0226\nx=0.0165, y=0.0123, z=0.0149, w=0.0252\nx=0.0164, y=0.0122, z=0.0151, w=0.0252\nx=0.0153, y=0.0085, z=0.0181, w=0.0000\nx=0.0172, y=0.0162, z=0.0178, w=0.0006\nx=0.0170, y=0.0156, z=0.0182, w=0.0007\nx=0.0177, y=0.0167, z=0.0141, w=0.0255\nx=0.0164, y=0.0120, z=0.0148, w=0.0252\nx=0.0167, y=0.0143, z=0.0182, w=0.0006\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fbudspro-headtracking","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftimschneeb%2Fbudspro-headtracking","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftimschneeb%2Fbudspro-headtracking/lists"}