PUTTV ← Back to home
Download

Flash a screen in minutes

Pick your hardware, download the bundle, and write it to an SD card or USB stick. The screen boots into pairing mode and shows a QR code — claim it from your dashboard.

Beta

This flasher writes a raw disk image — the drive you pick will be erased. It refuses system and non-removable disks, but always double-check the device name. We recommend trying it against a virtual machine before real hardware. Currently supported on macOS & Linux.

Raspberry Pi Zero W

Built and tested for the Pi Zero W. Write to a microSD card. Support for other boards is coming.

Format: .zipSize: ≈ 121 MBmicroSD ≥ 4 GB
Download Pi bundle
sha256 verify ↓
38c2cb28…72829a4b

x86 mini-PC On request

Intel/AMD mini-PCs and thin clients will be supported on specific, tested hardware rather than as a general download.

Status: Certified modelsTiming: TBA
Not a public download
PC hardware varies enormously — graphics, wireless and firmware differ from machine to machine — so rather than ship an image that may or may not boot on a given box, we'll publish a short list of models we've tested and support. Running x86 screens? Tell us what hardware you have at info@puttv.io.
How to flash

Four steps from download to live screen

Unzip it

In Terminal run unzip puttv-flasher-*.zip (more reliable than double-clicking for a large file). If the image ever goes missing, the flasher re-downloads it automatically.

Run the flasher

Insert your SD card, then cd puttv-flasher and run ./puttv-flash.sh.

Pick & confirm

It lists removable drives — choose yours and type the device name to confirm. Add --dry-run first to rehearse.

Boot & pair

Put it in your device, power on, and scan the QR — or claim it in the dashboard.

Safety

  • Only removable drives are allowed; the system disk is always refused.
  • You must type the device name to confirm before anything is written.
  • The bundle includes a --dry-run mode and a test suite (tests/).

Requirements

  • macOS or Linux with curl and admin (sudo) rights for the write.
  • A microSD card, 4 GB or larger.
  • Windows: run under WSL for now — a native tool is coming.