Homecast

A homebrew Chromecast

---

Documentation • Release Notes • Report a Bug • Request a Feature

---

Table of Contents

• Homecast
  • About
    • Built With
  • Setup
    • Production
    • Development
  • License

About

Homecast is a homebrew, Chromecast-style streaming appliance built around a Raspberry Pi connected to a television.

The goal is to provide a simple, self-hosted casting and media experience while retaining complete control over the underlying hardware and software.

Features include:

• Installs on-top of any Raspberry Pi OS + Wayland
  • Allows you to fully customize and use as your own media center
• Remote desktop into the pi via the browser on any device
  • Mirrors to the TV
• Install the PWA via the browser to get the remote control app
  • Use the share button built into any site / app to cast media to Homecast
• Custom screen savers, automatic background music, and AI harness integration

Built With

Setup

Production

Prerequisites

• Raspberry Pi 4/5 (2GB min/4GB ideal)
• Updated version of Raspberry Pi OS

Instructions

1. Install homecast: curl -sL https://git.zakscode.com/ztimson/homecast/raw/branch/master/install.sh | sudo bash

Development

Prerequisites

• Node.js

Instructions

1. Clone the repository.
2. Install the dependencies: npm install
3. Start the development server: npm run start

License

Copyright © 2026 Zakary Timson | Available under MIT Licensing