Streamsphere---Content

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
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 lightweight as possible.

: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

downloading

: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

Application Design

โ“ 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

740
Total Downloads

Links

Details

Repository
streamsphere/streamsphere-content:latest
Last Updated2024-11-17
First Seen2025-01-22

Runtime arguments

Network
bridge
Privileged
false

Template configuration

API PortPorttcp

Container Port: 3500

Target
3500
Default
3500
Value
3500
Content PathPath

Path to content files. Must match Streamsphere Content content path.

Target
/app/content