StreamHome v0.1.0-alpha.1 — Early Alpha Preview

[WaqSea]

StreamHome Early Alpha Preview

StreamHome is a self-hosted media server and streaming interface built with FastAPI, React, SQLite, FFmpeg, and optional Google Drive storage through Rclone.

This is an early public alpha intended for testing and feedback. It is not production-ready and should not be exposed directly to the public internet.

Highlights

• Four distinct frontend themes: Ember, Aurora, Cinema, and Gemini
• Movie and series catalog management
• Personalized, profile-based recommendations
• Continue Watching and Watch Again collections
• Like, Love, and Dislike preference signals
• Search with TMDB metadata and artwork caching
• Responsive desktop and mobile video players
• Playback progress, resume support, quality selection, subtitles, and playback speed
• Profiles with editable themes and avatar styles
• TOTP authentication and recovery codes
• Session and account-security management
• Admin Center for storage, downloads, accounts, and server configuration
• Guided first-run setup wizard
• Google Drive integration through Rclone
• MediaSender ingestion API and processing queue
• Windows and Unix setup, start, and stop scripts

Quick installation

The following commands install the latest development version from the main branch.

Linux and macOS

curl -fsSL https://raw.githubusercontent.com/StreamHome/StreamHome/main/install.sh | bash

Windows PowerShell

irm https://raw.githubusercontent.com/StreamHome/StreamHome/main/install.ps1 | iex

After installation, open:

http://localhost:3000/setup

Review downloaded scripts before running them, especially on machines containing important data.

Version-pinned installation

For a reproducible installation, replace v0.1.0-alpha.1 below if this release uses a different tag.

Linux and macOS

curl -fsSL https://raw.githubusercontent.com/StreamHome/StreamHome/v0.1.0-alpha.1/install.sh | STREAMHOME_REF=v0.1.0-alpha.1 bash

Windows PowerShell

$env:STREAMHOME_REF="v0.1.0-alpha.1"; irm https://raw.githubusercontent.com/StreamHome/StreamHome/v0.1.0-alpha.1/install.ps1 | iex

Requirements

• Python 3.11 or newer
• Node.js 18 or newer
• Git
• FFmpeg and FFprobe
• Rclone when using Google Drive storage
• A TMDB API key for metadata and discovery features

The setup scripts attempt to install or validate the required dependencies.

Important alpha notes

• This release is publicly available but intended for early testing.
• Install it only on systems and networks where experimental software is acceptable.
• Existing installations and databases should be backed up before upgrading.
• Windows installation has received the most complete end-to-end testing.
• Linux and macOS support is included but still requires wider real-device validation.
• Google Drive currently requires a broad Drive permission scope.
• Remote ingestion sources and complex HLS redirects should only come from trusted MediaSender instances.
• Installation from main may change over time; use the release tag for reproducible installations.
• Breaking database, authentication, configuration, and API changes may occur during the alpha period.
• Alpha updates may require users to sign in again or repeat parts of the setup process.

Recommended testing areas

Please pay particular attention to:

• Fresh installation and setup-wizard behavior
• Login, TOTP, recovery codes, and session management
• Movie and series ingestion
• Local and Google Drive playback
• Seeking, resume, subtitles, audio tracks, and fullscreen
• Mobile landscape playback and touch gestures
• Recommendation quality across different profiles
• Search-result metadata and artwork caching
• Backup, restore, restart, and upgrade behavior

When reporting a problem, include:

• Operating system and browser
• StreamHome release or commit
• Installation method
• Relevant server or browser-console output
• Steps required to reproduce the issue
• Whether storage is local or Google Drive
• Screenshots or a short screen recording when applicable

Privacy and security

Never include passwords, tokens, recovery codes, TOTP secrets, session cookies, Google OAuth credentials, signed media URLs, database files, personal media, or complete .env files in bug reports.

Publishing the source code does not mean a running StreamHome installation is safe to expose publicly. Keep alpha installations on a trusted private network unless you have configured HTTPS, a secure reverse proxy, access controls, firewall restrictions, and reliable backups.

Only ingest media from sources you trust and have permission to access.

Release status

Early public alpha: available for testing and feedback.

Production deployment: not recommended.

Direct public-internet exposure: not recommended.

---

This discussion was created from the release StreamHome v0.1.0-alpha.1 — Early Alpha Preview.