{"id":18456450,"url":"https://github.com/pollen-robotics/reachyteleoperation","last_synced_at":"2025-07-22T13:32:45.112Z","repository":{"id":164054584,"uuid":"636748112","full_name":"pollen-robotics/ReachyTeleoperation","owner":"pollen-robotics","description":"Unity app for teleoperating Reachy","archived":false,"fork":false,"pushed_at":"2024-09-12T11:36:49.000Z","size":5436,"stargazers_count":17,"open_issues_count":0,"forks_count":2,"subscribers_count":3,"default_branch":"develop","last_synced_at":"2025-03-23T06:41:25.344Z","etag":null,"topics":["reachy","teleoperation","unity","vr"],"latest_commit_sha":null,"homepage":"https://www.pollen-robotics.com","language":"C#","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pollen-robotics.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.txt","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}},"created_at":"2023-05-05T14:50:07.000Z","updated_at":"2025-03-01T06:26:51.000Z","dependencies_parsed_at":"2024-02-13T12:44:46.973Z","dependency_job_id":null,"html_url":"https://github.com/pollen-robotics/ReachyTeleoperation","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollen-robotics%2FReachyTeleoperation","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollen-robotics%2FReachyTeleoperation/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollen-robotics%2FReachyTeleoperation/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pollen-robotics%2FReachyTeleoperation/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pollen-robotics","download_url":"https://codeload.github.com/pollen-robotics/ReachyTeleoperation/tar.gz/refs/heads/develop","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247779796,"owners_count":20994569,"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":["reachy","teleoperation","unity","vr"],"created_at":"2024-11-06T08:11:36.033Z","updated_at":"2025-04-08T04:34:52.435Z","avatar_url":"https://github.com/pollen-robotics.png","language":"C#","funding_links":[],"categories":[],"sub_categories":[],"readme":"# ReachyTeleoperationXR\n\nUnity-based application that allows to control a [Reachy robot](https://www.pollen-robotics.com/reachy/) (version 2021+), or a [virtual one](https://github.com/pollen-robotics/reachy2021-unity-package), with a VR headset. The user documentation is available [here](https://docs.pollen-robotics.com/vr/introduction/introduction/).\n\n## Requirements\n\nThe app should run with any VR headset compatible with Unity. It has been tested with the Oculus Quest 2, and the Valve Index. The Oculus Quest 2 can be used in standalone mode or with the Oculus link.\n\nFor any custom development we recommend to use Unity LTS 2020.3. Versions above 2020.3 will not work due to compatibility issues with the gRPC library.\n\n## Installation\n\n### Using a [release build](https://github.com/pollen-robotics/ReachyTeleoperation/releases) [recommended]\n\nFor the Oculus Quest 2, you may ask to join the list of beta users to install the app directly from the app store. Please contact us on our [discord channel](https://discord.com/channels/519098054377340948/991321051835404409)!\n\nFor Windows and Android platforms, the simplest way to use the application is to download a [release here](https://github.com/pollen-robotics/ReachyTeleoperation/releases) (*Assets* section). The Windows package is a zip file that contains the .exe to run. Your VR headset should be plugged in and ready to be used. The Android package is an *.apk that should be installed on your device.\n\n\n### From source\n\nClone the **main** branch of the repo. Make sure that git lfs is enabled. If you want to contribue to the project please see the *Issues/Contribution* section.\n```\ngit clone -b main https://github.com/pollen-robotics/ReachyTeleoperation.git\n```\n\nDownload the [grpc_unity_package](https://packages.grpc.io/archive/2022/04/67538122780f8a081c774b66884289335c290cbe-f15a2c1c-582b-4c51-acf2-ab6d711d2c59/csharp/grpc_unity_package.2.47.0-dev202204190851.zip) from the [gRPC daily builds](https://packages.grpc.io/archive/2022/04/67538122780f8a081c774b66884289335c290cbe-f15a2c1c-582b-4c51-acf2-ab6d711d2c59/index.xml). Unzip it in the **Assets/Plugins** folder. You can now run the app from Unity or build an executable for your platform.\n\n## Usage\n\nThis is the quick-start documentation. For a detailed manual, please visit the [main documentation website](https://docs.pollen-robotics.com/vr/introduction/introduction/).\n\nTeleoperating a robot takes place in three basic steps:\n\n### 1. Connect to a robot\n\nThe first step is to select the robot you want to control. For that you'll need the ip address of the robot (please refer to the [robot documentation](https://docs.pollen-robotics.com/dashboard/introduction/first-connection/) for the first connection), or the ip address of the computer running the Unity simulator. Press *new robot button* and add your robot.\n\n![alt text](Docs/img/connection.jpg)\n\nNote that there is a built-in virtual robot for local testing of the application.\n\n### 2. Get ready for the teleoperation\n\nThis step checks that the connection to the (virtual) robot is fine, and allows to set various parameters. Side menus (status, help, settings) can be opened by clicking on the related icons.\n\nGet familiar with the controls of the robot. Press X to play with the emotions or change the gripper grasping mode. Once you are ready, press the *Ready* button and button A to take control of the robot.\n\n*Please not that A and X refers to the buttons of the Oculus controllers. They may differ on your device.*\n\n![alt text](Docs/img/mirror.jpg)\n\n### 3. Take control!\n\nYou are now controlling Reachy! Press and hold A to return to the previous step. \n\n![alt text](Docs/img/teleop.jpg)\n\n## Issues / Contributions\n\nIf you have any problem, you can create an issue or chat with us on our [discord server](https://discord.com/channels/519098054377340948/991321051835404409). \nFinally, anyone is welcome to contribute to this project. Feel free to checkout the **develop** branch and to pull request any modifications.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpollen-robotics%2Freachyteleoperation","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpollen-robotics%2Freachyteleoperation","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpollen-robotics%2Freachyteleoperation/lists"}