Skip to content


Repository files navigation

Turtle Rover

Turtle Control Software

A client-server application based on WebSocket technology to control Turtle Rover remotely

Build Status Release

Website | Facebook | YouTube

How it works (simplified)

Web Application --WebSockets--> Server --Serial--> Firmware


  • uv4l to send video stream
  • Working UART

How to install

How to run

How to setup Development Environment

To replicate our development workflow you will need a Linux-based distro or MacOS

Prerequisites: Install Yarn package manager on Your local machine.

  • Connect Raspberry Pi with Your machine
  • Create folder e.g. pi in home directory
  • Run ssh pi@ to enter TurtleOS shell
  • Run sudo chmod 777 /opt/turtlerover/ && sudo rm -R /opt/turtlerover/tcs to delete productional TCS
  • On Your local machine type: sshfs pi@ pi. This will mount whole TurtleOS filesystem in pi directory
  • Run cd pi/opt/turtlerover and clone this repo
  • Now You can open TCS project in Your favorite editor

How to build

  • Run yarn install
  • Run yarn build to build productional files. There is also yarn watch command, it will watch for any changes in files and rebuild project
  • Install Python dependencies sudo pip3 install -r requirements.txt
  • Run utils/

How streaming works

Streaming is done with UV4L drivers and WebRTC streaming server. UV4L comes preinstalled with TurtleOS.

Stream troubleshooting

There are still some problems with streaming and we are working to fix them. If stream doesn't work on your device, you may try to experiment with /etc/uv4l/uv4l-uvc.conf, especially with webrtc-enable-hw-codec option and force_hw_vcodec in core/stream.js. If you find any solution to your problem with streaming - please let us know or create a pull request.