# GhostHub

> A Raspberry Pi 4 media hub that serves photos and videos locally with streaming layouts, user profiles, real-time chat, and TV casting — no cloud required.

- **Category:** Media Server
- **Licence:** Other
- **Latest version:** v5.3.0
- **Open source:** oss
- **Languages:** JavaScript, Python
- **Platforms:** Linux, Raspberry Pi, Build from Source
- **Tags:** Streaming, Videos, Chat, Offline, Raspberry Pi, WebSocket, Photos, No Database, Media Server, Pwa, Privacy First, Cloudflare Tunnel, Open Source, Python, Flask, Profiles, Themes, Self Hosted, Tailscale, Headscale, Selfhosted, Local Server, Realtime Chat, Tiktok Style, Ghosthub, TV Casting

## Description

GhostHub is a self-hosted media server built for the Raspberry Pi 4. It converts a Pi and attached USB storage into a personal media center reachable from phones, tablets, computers, or an HDMI display. The service listens on port 5000 and operates in two network modes: a standard home network over Ethernet, or an access-point mode where the Pi hosts its own Wi-Fi. Main capabilities include two browsing views (a couch-style streaming layout and a date-organized gallery), user profiles with avatars and playback history, a built-in theme editor plus a community theme gallery, full file management (upload, download, rename, delete), tools to organize media with folders, playlists, sorting and search, subtitle support for common formats, casting to an HDMI display, synchronized playback and chat across viewers, an admin dashboard for updates, storage, Wi-Fi, cache, restarts, logs and system status, and optional remote access using a Cloudflare Tunnel or a Tailscale/Headscale mesh. Standard web formats (MP4 H.264/AAC, WebM) play natively; other codecs such as MKV, HEVC, AV1, DTS need the separate experimental GhostStream transcoder on another machine. You can install by flashing a ready-made SD card image, doing a DIY install on the specific 2022-01-28 Raspberry Pi OS Lite Bullseye release, or deploying your own source tree via a CLI. The stack runs on Python 3.9 with Flask, the SPECTER backend framework, the RAGOT frontend framework, and SQLite for persistence. Licensed under AGPL-3.0.

## Links

- [Homepage](https://github.com/BleedingXiko/GhostHub)
- [Quick Start](https://github.com/BleedingXiko/GhostHub/blob/main/docs/QUICK_START.md)
- [Flash Image Guide](https://github.com/BleedingXiko/GhostHub/blob/main/docs/FLASH_GHOSTHUB_IMAGE.md)
- [DIY Install Guide](https://github.com/BleedingXiko/GhostHub/blob/main/docs/DIY_INSTALL.md)
- [User Guide](https://github.com/BleedingXiko/GhostHub/blob/main/docs/HOW_TO_USE_GHOSTHUB.md)
- [Architecture](https://github.com/BleedingXiko/GhostHub/blob/main/docs/ARCHITECTURE.md)
- [Release Process](https://github.com/BleedingXiko/GhostHub/blob/main/docs/RELEASES.md)
- [Secure Mesh Quick Start](https://github.com/BleedingXiko/GhostHub/blob/main/docs/MESH_QUICK_START.md)
- [Secure Mesh Troubleshooting](https://github.com/BleedingXiko/GhostHub/blob/main/docs/SECURE_MESH_TROUBLESHOOTING.md)
- [Contributing](https://github.com/BleedingXiko/GhostHub/blob/main/CONTRIBUTING.md)
- [Security Policy](https://github.com/BleedingXiko/GhostHub/blob/main/SECURITY.md)

---
Source: https://selfhost.directory/project/ghosthub