Requirements

To successfully install and run TelemetryOS, your system must meet the following prerequisites:

Raspberry Pi 4 or compute module 4
Minimum of 2GB RAM
Minimum of 32GB storage

❗️
TelemetryOS Hardware Requirements
TelemetryOS is incompatible with earlier Raspberry Pi versions or systems with less than 2GB RAM or less than 32GB storage.

If you prefer a ready-made solution, consider purchasing a Raspberry Pi kit with TelemetryOS preinstalled from our partner ThePiHut.

Though not covered in this guide, you may install TelemetryOS on a compute module 4, although we haven't performed specific testing in this context.

SD Card

Your Raspberry Pi 4 requires an SD card of at least 32GB. Ensure it's compatible with Raspberry Pi 4 and fulfills the recommended performance criteria.

Limitations

The Raspberry Pi 4, has limitations in video resolution. Specifically, TelemetryTV doesn't support 4K video playback on these devices. 4K video playback will not work on the Raspberry Pi 4, regardless of operating system used. This is due to chipset performance limitations.

👍
Encode videos at 1080p
For the best experience with TelemetryTV, use videos encoded at 1080p. This ensures high-quality viewing without overloading the Raspberry Pi's hardware, resulting in smooth video playback.

Installation of TelemetryOS on Raspberry Pi 4

Follow the instructions below to install TelemetryOS on your Raspberry Pi 4.

👍
TelemetryTV's Raspberry Pi 4
If you have TelemetryTV's pre-configured Raspberry Pi 4 device, please skip to step 5.

1. Download Image

Download the TelemetryOS image for Raspberry Pi onto your Mac, Windows, or Linux desktop using the link below:

Download TelemetryOS for Raspberry Pi

2. Download Raspberry Pi Imager

Next, download the Raspberry Pi Imager to write the TelemetryOS image to your SD card.

Raspberry Pi Imager

3. Burn Image to the SD Card

Insert the SD card into your desktop system, install and launch the Raspberry Pi Imager. Follow the instructions under 'Use Custom' to write the TelemetryOS image onto the SD card.

4. Install SD Card on your Raspberry Pi

Once the image is successfully written, insert the SD card into your Raspberry Pi.

5. Boot your Raspberry Pi

Power up your Raspberry Pi and wait for the boot and startup process to complete.

🚧
Use the HDMI0 Port
Use the video output next to the power supply (HDMI0) on the Raspberry Pi. The second video output (HDMI1) is only for use when a second screen is connected. This is due to a limitation of the Raspberry Pi.

6. Setup Networking

Upon booting, the configuration screen will be displayed. Here, you can configure the WiFi or Ethernet settings—we recommend using an Ethernet connection for greater reliability. Ensure the network status is active before proceeding.

📘
Using an Ethernet Connection
If you opt to bypass WiFi and plug in an Ethernet connection instead, the setup screen will auto-advance to the pairing screen after a 30-second timeout.

7. You're Done!

Your device is now ready to be used with TelemetryOS.

👍
Accessing the TelemetryOS Setup Screen
If you need to return to the setup screen at any point, you can right-click to access the application menu or press Ctrl + S on an attached keyboard.

Pair or Provision your Device with Your TelemetryTV Account

After configuring your WiFi settings, a 6-digit pairing code will be displayed on your device. Either use this code to Pair your device with your TelemetryTV account or Provision your device using a USB

Pairing with a Pairing Code

Follow the steps below or check out our guide on how to pair your device with your TelemetryTV account

Open your TelemetryTV account on your computer.
Navigate to the devices page.
Enter the 6-digit pairing code displayed on your device.

Provisioning with USB

Follow the steps below or check out our comprehensive ~~guide~~ on how to Provision with USB.