{"id":16508603,"url":"https://github.com/osteele/optitrack-ws-server","last_synced_at":"2025-03-02T04:32:57.649Z","repository":{"id":49456635,"uuid":"209704459","full_name":"osteele/optitrack-ws-server","owner":"osteele","description":"Serve OptiTrack data from a CSV file to a WebSocket connection","archived":false,"fork":false,"pushed_at":"2021-06-17T06:19:21.000Z","size":21,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-02-25T09:18:42.721Z","etag":null,"topics":["motion-capture","optitrack","websocket-connection"],"latest_commit_sha":null,"homepage":"","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/osteele.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}},"created_at":"2019-09-20T04:21:12.000Z","updated_at":"2021-06-17T06:19:15.000Z","dependencies_parsed_at":"2022-09-04T21:00:21.420Z","dependency_job_id":null,"html_url":"https://github.com/osteele/optitrack-ws-server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteele%2Foptitrack-ws-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteele%2Foptitrack-ws-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteele%2Foptitrack-ws-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/osteele%2Foptitrack-ws-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/osteele","download_url":"https://codeload.github.com/osteele/optitrack-ws-server/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241460058,"owners_count":19966511,"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":["motion-capture","optitrack","websocket-connection"],"created_at":"2024-10-11T15:46:32.407Z","updated_at":"2025-03-02T04:32:57.621Z","avatar_url":"https://github.com/osteele.png","language":"Python","readme":"# OptiTrack Gateway\n\nA web server that serves offline OptiTrack data, that has been exported as CSV,\nvia a websocket connection.\n\nIt is meant to be used in conjunction with the web client in\n\u003chttps://github.com/osteele/p5pose-optitrack\u003e.\n\n## Install\n\n1. Verify that will python3 and pipenv are installed:\n\n   ```sh\n    python3 --version\n    pipenv --version\n    ```\n\n    The first command should print `Python 3.7.4` or greater.\n\n    The second command should print something like `pipenv, version 2018.11.26`.\n    It doesn't matter exactly what it prints, it just shouldn't error.\n\n2. If python3 and pipenv are not installed, install them. On macOS:\n\n   1. Install [homebrew](https://brew.sh)\n   2. Run the terminal commands:\n\n      ```sh\n      brew install python pipenv\n      ```\n\n   On other operating systems, follow the instructions\n   [here](https://pipenv.kennethreitz.org/en/latest/) to install pipenv.\n\n3. Clone this repository\n4. Inside the cloned directory, run this command:\n\n   ```sh\n   pipenv install\n   ```\n\n## Create CSV Files\n\nYou will need an OptiTrack *.csv file.\n\nUse the following command to convert this file to JSON:\n\n`pipenv run create-csv FILE_OR_DIR...`\n\nIf `FILE_OR_DIRNAME` is a CSV file, it creats a `*.json` file in the\n`./build` directory.\n\nIf `FILE_OR_DIRNAME` is a directory, all *.csv files *directly* inside that\ndirectory (but not files inside directories in that directory) are converted.\n\n`pipenv run print-bones FILE_OR_DIR...`\n\nPrints the bone names.\n\n## Run the Server\n\n`pipenv run server [JSON_PATH]`\n\nThis serves data from `JSON_PATH` on WebSocket port 8765. It can be accessed\nfrom a client running on the same machine, at `ws://localhost:8765`.\n\n## References\n\n* [OptiTrack CSV](https://v21.wiki.optitrack.com/index.php?title=Data_Export:_CSV)\n* [websockets](https://websockets.readthedocs.io/en/stable/)\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosteele%2Foptitrack-ws-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fosteele%2Foptitrack-ws-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fosteele%2Foptitrack-ws-server/lists"}