HomeServer-Py is a lightweight Python-based media server designed for local network use. It provides a simple and intuitive web interface for organizing, uploading, and streaming personal media files such as movies, music, pictures, and videos. The server uses FastAPI (served via Uvicorn) to handle requests, and stores media in a structured folder system under a public directory. Users can add content through the web UI or by placing files directly into the designated storage folders. The project focuses on simplicity, ease of use, and quick setup for personal home media sharing.
- Centralized media storage
- Easy upload and drag-and-drop support
- Fast, lightweight server using FastAPI + Uvicorn
- Accessible from any device on your local network
- Python 3.6 or higher
uvicorn
- Clone the repository
git clone https://github.com/0x2x/HomeServer-Py.git
cd HomeServer-Py
---
## What is Public Folder? & How to add content
The public folder is a designated area where users can upload and share media files with others. It provides a convenient way to access and share content with friends and family. - How to add movies either use the Upload button or drag and drop files into the designated area. or go to the public folder pick the specific folder and upload the files there.
Example:
public -> storage -> movies -> movie1.mp4