# Streamsphere

Streamsphere is a lightweight self-hosted media library. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/256/streamsphere

## Description

StreamSphere is a lightweight self-hosted media library. It organizes channels, playlists, and videos, giving homelab users complete media-library functionality with minimal overhead.

## Platform availability

Available on 1 of 9 platforms: Unraid.

## Health score

49/100 (Fair), based on 3 of 4 factors.
- Maintained: 69 (last commit 62 days ago)
- Popular: 40 (100 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)

## Links

- Docker Hub: https://hub.docker.com/r/streamsphere/streamsphere
- Unraid: https://ca.unraid.net/apps/streamsphere-1ulw1mv0tfjnq3?q=Streamsphere

## Common questions

### How are ports and environment variables set up in the Docker Compose example?

Map the main service with 1282:3000 and the content service with 1288:3500. Set HOST_IP, APPLICATION_PORT, and CONTENT_PORT to match your host network and exposed ports.

### Where are the database and downloaded media stored?

Use Docker volumes: db-data is mounted at /app/database/db for the database, and content-data is mounted at /app/content for downloaded content. The content volume is also mounted into the content service at /content.

### Which source domains are supported for adding channels, playlists, and videos?

The README currently lists only youtube.com as a supported domain.

### Why might the UI feel slow when adding a channel or playlist?

It first uses yt-dlp to fetch video metadata and thumbnails before starting the download. This can take noticeable time, especially for channels or playlists.

---
Source: Our Local Host (https://ourlocalhost.com/app/256/streamsphere), the self-hosted and open-source app directory.