Reachy Mini documentation

Media Architecture

Hugging Face's logo
Join the Hugging Face community

and get access to the augmented documentation experience

to get started

Media Architecture

Understanding the media architecture of Reachy Mini is essential for effectively utilizing its audio and visual capabilities. They operate differently based on the specific model of Reachy Mini you are using.

Note : There is ongoing work to unify the media architecture across all Reachy Mini models. The information below reflects the current state as of the latest update.

Reachy Mini

Video and audio streams can be accessed locally in the case of an embedded app, or remotely (through WebRTC protocol) with the Python SDK from a remote machine. GStreamer is used to handle this aspect.

The streams are managed by the Daemon so that multiple applications can access them simultaneously. Technically, the video stream is shared between a Unix socket and a WebRTC server. The audio card is configured with .asoundrc to be accessible by multiple applications, under the names reachymini_audio_src and reachymini_audio_sink.

Reachy Mini Media Daemon

Reachy Mini Media Client

Thanks to webrtc, the audio and video streams can also be accessed directly from a web browser. For instance the desktop application uses this feature.

Reachy Mini Media Client

Reachy Mini Lite

In the case of Reachy Mini Lite, the Daemon doesn’t manage the camera, microphone, and speaker. It only plays a sound during startup and exit or if moves are triggered from the dashboard.

Note: Sounddevice locks the audio card when playing a sound. Keep this in mind when you use the sound from the SDK and trigger a move from the dashboard.

Reachy Mini Media Daemon

Two backends are available. The default one relies on the combination of OpenCV for the camera and sounddevice for the audio card.

An experimental GStreamer backend is also available. While it is mostly tuned for Linux systems, it should work on other platforms. It requires more manual installation at the moment (see gstreamer-installation)

Reachy Mini Media Client

Advanced Controls

Please refer to the dedicated pages to fine-tune camera and microphone parameters for Reachy Mini and Reachy Mini Lite.

Update on GitHub