Streamsphere---Content
Docker app from grtgbln's Repository
It is a media library. It supports channels, playlists and videos. The primary goal of this application is to provide complete functionality of a media library, while being asโฆ
Overview
Readme
View on GitHub:film_strip: Streamsphere
It is a media library. It supports channels, playlists and videos.
The primary goal of this application is to provide complete functionality of a media library, while being as light weight as possible.
Note: The tool is under active development.
:computer: Interface
:rocket: Getting Started
Features
- ๐บ Download Channels from supported domains
- ๐ผ Downlad & update playlists from supported domains
- ๐ฝ๏ธ Download Videos from supported domains
- ๐ Search and play videos by title
- ๐พ UI to navigate your media library
- ๐ฅ Download media content that has been added to streamsphere through browser
- โจ View tags, categories, size of media files and other details for the downloaded content
- ๐ด Light & Dark theme support
:whale: Deploy using docker compose
You will need Docker installed on your system for this.
services:
streamsphere:
image: streamsphere/streamsphere:latest
# image: streamsphere/streamsphere:latest-arm
container_name: streamsphere
restart: unless-stopped
ports:
- 1282:3000
environment:
APPLICATION_PORT: "1282"
CONTENT_PORT: "1288"
volumes:
- db-data:/app/database/db
- content-data:/app/content
content:
image: streamsphere/streamsphere-content:latest
# image: streamsphere/streamsphere-content:latest-arm
container_name: streamsphere-content
restart: unless-stopped
ports:
- 1288:3500
volumes:
- content-data:/content
volumes:
db-data:
content-data:
Note: If you are using an ARM64 machine (like a raspberry-pi), use the commented image name with latest-arm tag (the default uncommented image with latest tag is for AMD64 machines only).
Environment Variables
- APPLICATION_PORT (required) is the port you open Streamsphere on, the left side of its "ports" mapping.
- CONTENT_PORT (required) is the port of the content server, the left side of the content service's "ports" mapping.
- PROTOCOL, APPLICATION_IP and CONTENT_IP are optional. Left out, they are taken from the address you opened Streamsphere at. The docker-compose.yaml explains when to set them.
- HOST_IP from older compose files still works and is read as APPLICATION_IP.
Supported Domains
- youtube.com
ใฐ๏ธ Performance & Limitations
The application uses yt-dlp to fetch video metadata and thumbnail, if this is successful, it attempts to download the video and shows download metrics on the UI. Since the application first fetches the video metadata, the Get UI operation may feel slow as it takes a while to fetch the metadata and download the video thumbnail, even more so when its a playlist or a channel. The application does have the same limitations basically as yt-dlp as of the latest version. e.g. downloading a mix will end up in a never ending loop which keeps fetching data from yt-dlp.
:hammer_and_wrench: Support & Compatibility
CPU Architecture
| AMD64 | ARM64 |
|---|---|
| โ๏ธ Supported | โ๏ธ Supported |
Screen Size
| 10" & below | 10" - 14" | 14" - 27" | 27" & above |
|---|---|---|---|
| โ๏ธ Unsupported | โ๏ธ Supported (untested) | โ๏ธ Supported | โ๏ธ Supported (untested) |
Browsers
| Chrome | Edge | Safari | Firefox |
|---|---|---|---|
| โ๏ธ Supported | โ๏ธ Supported | โ๏ธ Supported | โ๏ธ Supported |
๐ Upcoming Features
Please refer this list of upcoming work items and please report any bugs if you find one!
๐ผ Updating yt-dlp
The latest version of streamsphere (v0.1.16) includes an update to upgrade yt-dlp each time the container is stopped and started. It can also be manually updated by following the below steps:
# login into the container
sudo docker exec -it streamsphere bash
Once inside the docker container:
# change directory to reach the yt-dlp binary
cd /app/utils/
# run the yt-dlp update
./yt-dlp_linux -U
Upcoming versions of streamsphere are planned to have a ui to update yt-dlp.
๐ฏ Design Update (Proposed)
This update will support:
- scheduling playlist/channel updates
- enable extraction of extremely huge channels/playlists
- enable modular implementation of download filters
- improved failure management
- does not require additional docker builds
โ Help & Support
Please feel free to report any bugs that you may have observed!
๐ License
GNU Affero General Public License v3.0
Media gallery
Categories
Download Statistics
Related apps
Explore more like this
Explore allLinks
Details
streamsphere/streamsphere-content:latestRuntime arguments
- Network
bridge- Privileged
- false
Template configuration
Container Port: 3500
- Target
- 3500
- Default
- 3500
- Value
- 3500
Path to content files. Must match Streamsphere Content content path.
- Target
- /app/content