How to set up phosphobot for free and control your robot arm in simulation and in real life.
The quickest way to get started is to use the install script. In a terminal, run the following command:
Then, run the phosphobot server:
It can take up to 15 seconds for the server to start.
On the same computer, open a web browser and navigate to localhost. You should now see the phosphobot dashboard.
Discover how to control your robot arm from the dashboard and from the Meta Quest app.
Use Homebrew to install phosphobot:
To update phosphobot, run the following command:
You can also directly download the binaries here.
On Linux, we use apt to distribute the software and you need additional packages. That’s why you need to run the install script with sudo:
To update phosphobot, run the following command:
phosphobot on Raspberry Pi has advanced features to make it easier to use (led ticking, bluetooth connection, extra dependencies already installed).
Setup your Raspberry Pi
Download and install the Raspberry Pi imager on your main computer.
Insert an SD card into your main computer.
Run the Raspberry Pi imager.
Then, click Next on the bottom right.
When the window pops up asking for OS customisation, select Edit Settings.
In general settings :
phosphobot?phosphobot and password123 (example).In the Services settings, make sure SSH is enabled.
Then hit Save and hit Yes to use the OS customization settings. Write the image to the SD card.
When writing is finished, take out the SD card from your computer.
Insert the microSD into the Raspberry Pi when it’s turned off.
1. SSH into the Raspberry Pi
SSH (Secure Shell) allows you to access the Raspberry Pi remotely from your main computer through the terminal.
Turn on the Raspberry Pi by plugging it to a power source. Wait for it to boot (look for the LED pattern)
Then, open a terminal and SSH into your Raspberry Pi. If you’ve followed the previous part, this means running on your computer this command :
If you didn’t follow the previous part, the username@hostname.local and password may be different.
When asked about the authenticity of host phosphobot.local, type yes to accept.
And when asked for password, enter password123 .
2. Install the software
When you’ve successfully SSH in the Raspberry Pi, run this to install the teleoperation server :
Your Raspberry Pi should be connected to the internet.
btberrywifi install location, leave blank.bluetooth password, leave blankEnter your country code, specify your country code (eg: US, FR…)After that, the installation script will download install dependencies. It can take a few minutes depending on your connection speed.
3. Once the installation is complete, reboot your Raspberry Pi.
The warning only appears on first run. Subsequent launches work normally.
You can also directly download the binaries here.. After downloading, run phosphobot this way:
Change C:\path\to\ to the path where you downloaded phosphobot. To make this easier, we recommand you to rename the file to phosphobot.exe and move it to your Desktop.
Then, you can create a shortcut to launch C:\Users\<your_username>\Desktop\phosphobot.exe run from anywhere.
Join the Discord to ask questions, get help from others and get updates
How to set up phosphobot for free and control your robot arm in simulation and in real life.
The quickest way to get started is to use the install script. In a terminal, run the following command:
Then, run the phosphobot server:
It can take up to 15 seconds for the server to start.
On the same computer, open a web browser and navigate to localhost. You should now see the phosphobot dashboard.
Discover how to control your robot arm from the dashboard and from the Meta Quest app.
Use Homebrew to install phosphobot:
To update phosphobot, run the following command:
You can also directly download the binaries here.
On Linux, we use apt to distribute the software and you need additional packages. That’s why you need to run the install script with sudo:
To update phosphobot, run the following command:
phosphobot on Raspberry Pi has advanced features to make it easier to use (led ticking, bluetooth connection, extra dependencies already installed).
Setup your Raspberry Pi
Download and install the Raspberry Pi imager on your main computer.
Insert an SD card into your main computer.
Run the Raspberry Pi imager.
Then, click Next on the bottom right.
When the window pops up asking for OS customisation, select Edit Settings.
In general settings :
phosphobot?phosphobot and password123 (example).In the Services settings, make sure SSH is enabled.
Then hit Save and hit Yes to use the OS customization settings. Write the image to the SD card.
When writing is finished, take out the SD card from your computer.
Insert the microSD into the Raspberry Pi when it’s turned off.
1. SSH into the Raspberry Pi
SSH (Secure Shell) allows you to access the Raspberry Pi remotely from your main computer through the terminal.
Turn on the Raspberry Pi by plugging it to a power source. Wait for it to boot (look for the LED pattern)
Then, open a terminal and SSH into your Raspberry Pi. If you’ve followed the previous part, this means running on your computer this command :
If you didn’t follow the previous part, the username@hostname.local and password may be different.
When asked about the authenticity of host phosphobot.local, type yes to accept.
And when asked for password, enter password123 .
2. Install the software
When you’ve successfully SSH in the Raspberry Pi, run this to install the teleoperation server :
Your Raspberry Pi should be connected to the internet.
btberrywifi install location, leave blank.bluetooth password, leave blankEnter your country code, specify your country code (eg: US, FR…)After that, the installation script will download install dependencies. It can take a few minutes depending on your connection speed.
3. Once the installation is complete, reboot your Raspberry Pi.
The warning only appears on first run. Subsequent launches work normally.
You can also directly download the binaries here.. After downloading, run phosphobot this way:
Change C:\path\to\ to the path where you downloaded phosphobot. To make this easier, we recommand you to rename the file to phosphobot.exe and move it to your Desktop.
Then, you can create a shortcut to launch C:\Users\<your_username>\Desktop\phosphobot.exe run from anywhere.
Join the Discord to ask questions, get help from others and get updates